Runtime entrypoint

defineTool

Defines one executable tool with metadata, JSON schema parameters, and a single handler shared across harness adapters.

export function defineTool<Args>(tool: Tool<Args>): Tool<Args>;

listTools

Loads a tools module and returns the declared tool metadata for local inspection or generated adapters.

export async function listTools(modulePath: string): Promise<Tool[]>;

callTool

Invokes a named tool locally with JSON arguments, matching the CLI's ap-sdk tools --call loop.

export async function callTool(modulePath: string, name: string, args: unknown): Promise<ToolResult>;

contentToText

Converts structured tool content blocks into plain text for terminal output.

export function contentToText(content: ToolContent[]): string;