AgentOffice é uma extensão Pi.

import type { ExtensionAPI, ToolResult } from "@mariozechner/pi-coding-agent";
import { z } from "zod";

/**
 * MyExtension — extensão de exemplo para AgentOffice
 * Registra ferramentas, comandos CLI e event handlers.
 */
export default function myExtension(api: ExtensionAPI) {

  // ── Ferramenta disponível para os agentes ─────────────────
  api.registerTool("fetch_data", {
    description: "Busca dados externos e retorna JSON estruturado",
    parameters: z.object({
      url:     z.string().url().describe("URL do endpoint"),
      timeout: z.number().optional().default(5000)
    }),
    execute: async ({ url, timeout }): Promise<ToolResult> => {
      const controller = new AbortController();
      const id = setTimeout(() => controller.abort(), timeout);
      try {
        const res = await fetch(url, { signal: controller.signal });
        const data = await res.json();
        return { content: JSON.stringify(data, null, 2) };
      } catch (err) {
        return { isError: true, content: String(err) };
      } finally {
        clearTimeout(id);
      }
    }
  });

  // ── Comando CLI: agentoffice my-extension sync ─────────────
  api.registerCommand("sync", async (args) => {
    const dry = args.includes("--dry-run");
    console.log(`[my-extension] sync ${dry ? "(dry-run)" : ""}`);
    if (!dry) await performSync();
  });

  // ── Hook de ciclo de vida ──────────────────────────────────
  api.on("agent:start", ({ agentId }) => {
    console.log(`[my-extension] agente ${agentId} iniciado`);
  });
}

async function performSync() {
  // sua lógica de sincronização aqui
}