Tools for your agent

const definitions = editor.tools.getDefinitions();

const response = await yourModel.createMessage({
  messages,
  tools: definitions.map((tool) => ({
    name: tool.name,
    description: tool.description,
    input_schema: tool.inputSchema,
  })),
});

for (const call of response.toolCalls) {
  const result = await editor.tools.execute(call.name, call.input);
  messages.push({
    role: "tool",
    tool_call_id: call.id,
    content: result.agentFeedback ?? JSON.stringify(result.output),
  });
}

interface ReviseEditorToolExecutionResult {
  toolCallId: string;
  name: string;
  success: boolean;
  error?: string;
  errorCode?: string;
  agentFeedback?: string;   // model-oriented explanation, success or failure
  output?: unknown;         // structured metadata
  context?: string;         // block-ID-preserving HTML from read/search tools
}

const read = await editor.tools.execute("read_blocks_from_index", {
  index: 0,
  context_notes: "Looking for the liability clause",
});

await editor.tools.execute("replace", {
  id: "b12",
  replacements: [
    {
      find: "capped at the fees paid",
      replace: "capped at two years of fees paid",
      occurrence: "unique",
    },
  ],
});

await editor.tools.execute("set_title", { title: "Exhibit A" }, {
  documentId: "exhibit-a",
});

// or bind a controller once
const exhibit = editor.tools.forDocument("exhibit-a");
await exhibit.execute("measure_document", {});

await editor.tools.execute("style_blocks", input, { directMode: true });