@andreprado/agentkit 0.1.0-alpha.2 → 0.1.0-alpha.21

package/src/templates/dentista.ts

@@ -0,0 +1,1011 @@
+import type { AgentTemplate } from ".";
+
+export const dentistaTemplate: AgentTemplate = {
+  name: "dentista",
+  files(projectName: string, context = {}) {
+    return [
+      {
+        path: "package.json",
+        contents: `${JSON.stringify(
+          {
+            name: projectName,
+            private: true,
+            type: "module",
+            scripts: {
+              agentkit: "agentkit",
+              dev: "agentkit dev",
+              chat: "agentkit chat",
+              eval: "agentkit eval run",
+              typecheck: "tsc --noEmit",
+            },
+            dependencies: {
+              "@andreprado/agentkit": context.agentkitDependency ?? "workspace:*",
+            },
+            devDependencies: {
+              "@types/node": "^24.12.4",
+              typescript: "^5.9.3",
+            },
+          },
+          null,
+          2,
+        )}
+`,
+      },
+      {
+        path: "tsconfig.json",
+        contents: `${JSON.stringify(
+          {
+            compilerOptions: {
+              target: "ES2022",
+              module: "ESNext",
+              moduleResolution: "Bundler",
+              strict: true,
+              skipLibCheck: true,
+              noEmit: true,
+              types: ["node"],
+            },
+            include: ["**/*.ts"],
+          },
+          null,
+          2,
+        )}
+`,
+      },
+      {
+        path: ".gitignore",
+        contents: `.env
+.agentkit/
+node_modules/
+`,
+      },
+      {
+        path: ".env.schema",
+        contents: `# Opcional: adicione chaves reais depois de trocar o provider test/fake.
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+OPENROUTER_API_KEY=
+`,
+      },
+      {
+        path: "agentkit.config.ts",
+        contents: `import { defineAgent } from "@andreprado/agentkit";
+import {
+  agendarConsulta,
+  alterarConsulta,
+  consultarConsulta,
+  listarHorariosDisponiveis,
+} from "./tools/agenda";
+
+export default defineAgent({
+  name: "Clara",
+  runtime: "edge",
+  provider: {
+    name: "test",
+    model: "fake",
+  },
+  timeZone: "America/Sao_Paulo",
+  instructions: "./prompts/instructions.md",
+  secrets: [],
+  tools: [listarHorariosDisponiveis, consultarConsulta, agendarConsulta, alterarConsulta],
+  access: {
+    mode: "private",
+  },
+  storage: {
+    driver: "agentkit",
+    path: ".agentkit/agentkit.db",
+    database: {
+      driver: "turso",
+      schema: "./schema.sql",
+    },
+  },
+});
+`,
+      },
+      {
+        path: "schema.sql",
+        contents: `CREATE TABLE IF NOT EXISTS consultas_dentista (
+  id TEXT PRIMARY KEY,
+  nome TEXT NOT NULL,
+  email TEXT NOT NULL,
+  telefone TEXT NOT NULL,
+  data TEXT NOT NULL,
+  horario TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'agendada',
+  created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE (email, telefone),
+  UNIQUE (data, horario)
+);
+
+CREATE INDEX IF NOT EXISTS consultas_dentista_cliente_idx
+ON consultas_dentista (email, telefone);
+
+CREATE INDEX IF NOT EXISTS consultas_dentista_data_idx
+ON consultas_dentista (data, horario);
+`,
+      },
+      {
+        path: "src/agent.ts",
+        contents: `export { default } from "../agentkit.config";
+`,
+      },
+      {
+        path: "tools/agenda.ts",
+        contents: `import { defineTool, type DatabaseRunner } from "@andreprado/agentkit";
+
+const CLINIC_TIME_ZONE = "America/Sao_Paulo";
+const ALL_SLOTS = [
+  "08:00",
+  "08:30",
+  "09:00",
+  "09:30",
+  "10:00",
+  "10:30",
+  "11:00",
+  "11:30",
+  "13:30",
+  "14:00",
+  "14:30",
+  "15:00",
+  "15:30",
+  "16:00",
+  "16:30",
+  "17:00",
+  "17:30",
+];
+const SLOT_SET = new Set(ALL_SLOTS);
+
+type ConsultaRow = {
+  id: string;
+  nome: string;
+  email: string;
+  telefone: string;
+  data: string;
+  horario: string;
+};
+
+type ListarHorariosInput = {
+  data: string;
+};
+
+type ConsultarConsultaInput = {
+  email: string;
+  telefone: string;
+};
+
+type AgendarConsultaInput = {
+  nome: string;
+  email: string;
+  telefone: string;
+  data: string;
+  horario: string;
+  confirmadoPeloCliente: boolean;
+};
+
+type AlterarConsultaInput = {
+  email: string;
+  telefone: string;
+  novaData: string;
+  novoHorario: string;
+  confirmadoPeloCliente: boolean;
+};
+
+type ConsultaOutput = {
+  encontrada: boolean;
+  id: string;
+  nome: string;
+  email: string;
+  telefone: string;
+  data: string;
+  horario: string;
+  mensagem: string;
+};
+
+type AgendaOutput = {
+  ok: boolean;
+  id: string;
+  nome: string;
+  email: string;
+  telefone: string;
+  data: string;
+  horario: string;
+  disponiveis: string[];
+  mensagem: string;
+};
+
+const consultaOutputSchema = {
+  type: "object",
+  properties: {
+    encontrada: { type: "boolean" },
+    id: { type: "string" },
+    nome: { type: "string" },
+    email: { type: "string" },
+    telefone: { type: "string" },
+    data: { type: "string" },
+    horario: { type: "string" },
+    mensagem: { type: "string" },
+  },
+  required: ["encontrada", "id", "nome", "email", "telefone", "data", "horario", "mensagem"],
+  additionalProperties: false,
+};
+
+const agendaOutputSchema = {
+  type: "object",
+  properties: {
+    ok: { type: "boolean" },
+    id: { type: "string" },
+    nome: { type: "string" },
+    email: { type: "string" },
+    telefone: { type: "string" },
+    data: { type: "string" },
+    horario: { type: "string" },
+    disponiveis: {
+      type: "array",
+      items: { type: "string" },
+    },
+    mensagem: { type: "string" },
+  },
+  required: ["ok", "id", "nome", "email", "telefone", "data", "horario", "disponiveis", "mensagem"],
+  additionalProperties: false,
+};
+
+export const listarHorariosDisponiveis = defineTool<ListarHorariosInput, { data: string; disponiveis: string[]; ocupados: string[]; mensagem: string }>({
+  name: "listar_horarios_disponiveis",
+  description: "Lista os slots de 30 minutos disponiveis para uma data no consultorio odontologico.",
+  visibility: "user",
+  inputSchema: {
+    type: "object",
+    properties: {
+      data: {
+        type: "string",
+        description: "Data desejada no formato YYYY-MM-DD.",
+      },
+    },
+    required: ["data"],
+    additionalProperties: false,
+  },
+  outputSchema: {
+    type: "object",
+    properties: {
+      data: { type: "string" },
+      disponiveis: {
+        type: "array",
+        items: { type: "string" },
+      },
+      ocupados: {
+        type: "array",
+        items: { type: "string" },
+      },
+      mensagem: { type: "string" },
+    },
+    required: ["data", "disponiveis", "ocupados", "mensagem"],
+    additionalProperties: false,
+  },
+  async execute(input, ctx) {
+    const date = normalizeDate(input.data);
+    const dateError = validateAppointmentDate(date, ctx.clock.now);
+
+    if (dateError) {
+      return {
+        data: date,
+        disponiveis: [],
+        ocupados: [],
+        mensagem: dateError,
+      };
+    }
+
+    const occupied = await occupiedSlots(ctx.db, date);
+    const disponiveis = ALL_SLOTS.filter((slot) => !occupied.has(slot));
+
+    return {
+      data: date,
+      disponiveis,
+      ocupados: Array.from(occupied).sort(),
+      mensagem:
+        disponiveis.length > 0
+          ? "Estes horarios estao disponiveis para consulta."
+          : "Nao ha horarios disponiveis nesta data.",
+    };
+  },
+});
+
+export const consultarConsulta = defineTool<ConsultarConsultaInput, ConsultaOutput>({
+  name: "consultar_consulta",
+  description: "Consulta o horario agendado de um cliente usando email e telefone.",
+  visibility: "user",
+  inputSchema: {
+    type: "object",
+    properties: {
+      email: { type: "string" },
+      telefone: { type: "string" },
+    },
+    required: ["email", "telefone"],
+    additionalProperties: false,
+  },
+  outputSchema: consultaOutputSchema,
+  async execute(input, ctx) {
+    const contact = normalizeContact(input.email, input.telefone);
+
+    if (!contact.ok) {
+      return emptyConsulta(contact.mensagem);
+    }
+
+    const appointment = await findAppointmentByContact(ctx.db, contact.email, contact.telefone);
+
+    if (!appointment) {
+      return emptyConsulta("Nao encontrei consulta agendada para este email e telefone.");
+    }
+
+    return {
+      encontrada: true,
+      id: appointment.id,
+      nome: appointment.nome,
+      email: appointment.email,
+      telefone: appointment.telefone,
+      data: appointment.data,
+      horario: appointment.horario,
+      mensagem: \`Consulta encontrada para \${appointment.data} as \${appointment.horario}.\`,
+    };
+  },
+});
+
+export const agendarConsulta = defineTool<AgendarConsultaInput, AgendaOutput>({
+  name: "agendar_consulta",
+  description: "Agenda uma consulta odontologica depois que o cliente confirma explicitamente data e horario.",
+  visibility: "user",
+  inputSchema: {
+    type: "object",
+    properties: {
+      nome: { type: "string" },
+      email: { type: "string" },
+      telefone: { type: "string" },
+      data: {
+        type: "string",
+        description: "Data confirmada no formato YYYY-MM-DD.",
+      },
+      horario: {
+        type: "string",
+        description: "Horario confirmado, em slot de 30 minutos, no formato HH:MM.",
+      },
+      confirmadoPeloCliente: {
+        type: "boolean",
+        description: "Use true somente depois que o cliente confirmar explicitamente a data e o horario.",
+      },
+    },
+    required: ["nome", "email", "telefone", "data", "horario", "confirmadoPeloCliente"],
+    additionalProperties: false,
+  },
+  outputSchema: agendaOutputSchema,
+  async execute(input, ctx) {
+    const nome = input.nome.trim();
+    const contact = normalizeContact(input.email, input.telefone);
+    const data = normalizeDate(input.data);
+    const horario = normalizeTime(input.horario);
+
+    if (!nome) {
+      return agendaFailure("Preciso do nome do cliente para agendar.", { data, horario });
+    }
+
+    if (!contact.ok) {
+      return agendaFailure(contact.mensagem, { nome, data, horario });
+    }
+
+    const existingClient = await findAppointmentByContact(ctx.db, contact.email, contact.telefone);
+
+    if (existingClient) {
+      return {
+        ok: false,
+        id: existingClient.id,
+        nome: existingClient.nome,
+        email: existingClient.email,
+        telefone: existingClient.telefone,
+        data: existingClient.data,
+        horario: existingClient.horario,
+        disponiveis: await availableSlots(ctx.db, existingClient.data),
+        mensagem: "Este cliente ja tem uma consulta agendada. Use alterar_consulta se ele quiser remarcar.",
+      };
+    }
+
+    const validation = await validateScheduleRequest(ctx.db, {
+      data,
+      horario,
+      confirmadoPeloCliente: input.confirmadoPeloCliente,
+      now: ctx.clock.now,
+    });
+
+    if (!validation.ok) {
+      return agendaFailure(validation.mensagem, { nome, email: contact.email, telefone: contact.telefone, data, horario, disponiveis: validation.disponiveis });
+    }
+
+    const id = crypto.randomUUID();
+
+    try {
+      await ctx.db.execute(
+        "INSERT INTO consultas_dentista (id, nome, email, telefone, data, horario) VALUES (?, ?, ?, ?, ?, ?)",
+        [id, nome, contact.email, contact.telefone, data, horario],
+      );
+    } catch {
+      const disponiveis = await availableSlots(ctx.db, data);
+      return agendaFailure("Esse horario acabou de ficar indisponivel. Ofereca outro horario ao cliente.", {
+        nome,
+        email: contact.email,
+        telefone: contact.telefone,
+        data,
+        horario,
+        disponiveis,
+      });
+    }
+
+    return {
+      ok: true,
+      id,
+      nome,
+      email: contact.email,
+      telefone: contact.telefone,
+      data,
+      horario,
+      disponiveis: validation.disponiveis,
+      mensagem: \`Consulta agendada para \${data} as \${horario}.\`,
+    };
+  },
+});
+
+export const alterarConsulta = defineTool<AlterarConsultaInput, AgendaOutput>({
+  name: "alterar_consulta",
+  description: "Altera a propria consulta do cliente usando email e telefone, depois de confirmar o novo horario.",
+  visibility: "user",
+  inputSchema: {
+    type: "object",
+    properties: {
+      email: { type: "string" },
+      telefone: { type: "string" },
+      novaData: {
+        type: "string",
+        description: "Nova data confirmada no formato YYYY-MM-DD.",
+      },
+      novoHorario: {
+        type: "string",
+        description: "Novo horario confirmado, em slot de 30 minutos, no formato HH:MM.",
+      },
+      confirmadoPeloCliente: {
+        type: "boolean",
+        description: "Use true somente depois que o cliente confirmar explicitamente a nova data e o novo horario.",
+      },
+    },
+    required: ["email", "telefone", "novaData", "novoHorario", "confirmadoPeloCliente"],
+    additionalProperties: false,
+  },
+  outputSchema: agendaOutputSchema,
+  async execute(input, ctx) {
+    const contact = normalizeContact(input.email, input.telefone);
+    const data = normalizeDate(input.novaData);
+    const horario = normalizeTime(input.novoHorario);
+    const validation = await validateScheduleRequest(ctx.db, {
+      data,
+      horario,
+      confirmadoPeloCliente: input.confirmadoPeloCliente,
+      now: ctx.clock.now,
+    });
+
+    if (!contact.ok) {
+      return agendaFailure(contact.mensagem, { data, horario });
+    }
+
+    const appointment = await findAppointmentByContact(ctx.db, contact.email, contact.telefone);
+
+    if (!appointment) {
+      return agendaFailure("Nao encontrei consulta agendada para este email e telefone.", {
+        email: contact.email,
+        telefone: contact.telefone,
+        data,
+        horario,
+      });
+    }
+
+    if (!validation.ok) {
+      return agendaFailure(validation.mensagem, {
+        id: appointment.id,
+        nome: appointment.nome,
+        email: appointment.email,
+        telefone: appointment.telefone,
+        data: appointment.data,
+        horario: appointment.horario,
+        disponiveis: validation.disponiveis,
+      });
+    }
+
+    if (appointment.data === data && appointment.horario === horario) {
+      return {
+        ok: true,
+        id: appointment.id,
+        nome: appointment.nome,
+        email: appointment.email,
+        telefone: appointment.telefone,
+        data,
+        horario,
+        disponiveis: validation.disponiveis,
+        mensagem: "A consulta ja estava marcada nesse horario.",
+      };
+    }
+
+    const conflicting = await findAppointmentBySlot(ctx.db, data, horario);
+
+    if (conflicting && conflicting.id !== appointment.id) {
+      const disponiveis = await availableSlots(ctx.db, data);
+      return agendaFailure("Esse horario nao esta mais disponivel. Ofereca outro horario ao cliente.", {
+        id: appointment.id,
+        nome: appointment.nome,
+        email: appointment.email,
+        telefone: appointment.telefone,
+        data: appointment.data,
+        horario: appointment.horario,
+        disponiveis,
+      });
+    }
+
+    try {
+      await ctx.db.execute("UPDATE consultas_dentista SET data = ?, horario = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?", [
+        data,
+        horario,
+        appointment.id,
+      ]);
+    } catch {
+      const disponiveis = await availableSlots(ctx.db, data);
+      return agendaFailure("Esse horario acabou de ficar indisponivel. Ofereca outro horario ao cliente.", {
+        id: appointment.id,
+        nome: appointment.nome,
+        email: appointment.email,
+        telefone: appointment.telefone,
+        data: appointment.data,
+        horario: appointment.horario,
+        disponiveis,
+      });
+    }
+
+    return {
+      ok: true,
+      id: appointment.id,
+      nome: appointment.nome,
+      email: appointment.email,
+      telefone: appointment.telefone,
+      data,
+      horario,
+      disponiveis: validation.disponiveis,
+      mensagem: \`Consulta alterada para \${data} as \${horario}.\`,
+    };
+  },
+});
+
+async function validateScheduleRequest(
+  db: DatabaseRunner,
+  input: { data: string; horario: string; confirmadoPeloCliente: boolean; now: Date },
+): Promise<{ ok: boolean; mensagem: string; disponiveis: string[] }> {
+  const dateError = validateAppointmentDate(input.data, input.now);
+
+  if (dateError) {
+    return {
+      ok: false,
+      mensagem: dateError,
+      disponiveis: [],
+    };
+  }
+
+  const disponiveis = await availableSlots(db, input.data);
+
+  if (!input.confirmadoPeloCliente) {
+    return {
+      ok: false,
+      mensagem: "Antes de salvar, confirme explicitamente a data e o horario com o cliente.",
+      disponiveis,
+    };
+  }
+
+  if (!SLOT_SET.has(input.horario)) {
+    return {
+      ok: false,
+      mensagem: "Horario invalido. Use apenas slots de 30 minutos entre 08:00 e 11:30 ou entre 13:30 e 17:30.",
+      disponiveis,
+    };
+  }
+
+  if (!disponiveis.includes(input.horario)) {
+    return {
+      ok: false,
+      mensagem: "Esse horario nao esta disponivel. Ofereca um dos horarios disponiveis.",
+      disponiveis,
+    };
+  }
+
+  return {
+    ok: true,
+    mensagem: "Horario valido.",
+    disponiveis,
+  };
+}
+
+async function availableSlots(db: DatabaseRunner, data: string): Promise<string[]> {
+  const occupied = await occupiedSlots(db, data);
+  return ALL_SLOTS.filter((slot) => !occupied.has(slot));
+}
+
+async function occupiedSlots(db: DatabaseRunner, data: string): Promise<Set<string>> {
+  const result = await db.query("SELECT horario FROM consultas_dentista WHERE data = ? AND status = 'agendada'", [data]);
+  return new Set(result.rows.map((row) => String(row.horario)));
+}
+
+async function findAppointmentByContact(db: DatabaseRunner, email: string, telefone: string): Promise<ConsultaRow | null> {
+  const result = await db.query(
+    "SELECT id, nome, email, telefone, data, horario FROM consultas_dentista WHERE email = ? AND telefone = ? AND status = 'agendada' LIMIT 1",
+    [email, telefone],
+  );
+  return rowToAppointment(result.rows[0]);
+}
+
+async function findAppointmentBySlot(db: DatabaseRunner, data: string, horario: string): Promise<ConsultaRow | null> {
+  const result = await db.query(
+    "SELECT id, nome, email, telefone, data, horario FROM consultas_dentista WHERE data = ? AND horario = ? AND status = 'agendada' LIMIT 1",
+    [data, horario],
+  );
+  return rowToAppointment(result.rows[0]);
+}
+
+function rowToAppointment(row: Record<string, unknown> | undefined): ConsultaRow | null {
+  if (!row) {
+    return null;
+  }
+
+  return {
+    id: String(row.id),
+    nome: String(row.nome),
+    email: String(row.email),
+    telefone: String(row.telefone),
+    data: String(row.data),
+    horario: String(row.horario),
+  };
+}
+
+function normalizeContact(emailInput: string, telefoneInput: string): { ok: true; email: string; telefone: string } | { ok: false; mensagem: string } {
+  const email = emailInput.trim().toLowerCase();
+  const telefone = telefoneInput.replace(/\\D/g, "");
+
+  if (!/^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$/.test(email)) {
+    return { ok: false, mensagem: "Preciso de um email valido para localizar ou salvar a consulta." };
+  }
+
+  if (telefone.length < 8) {
+    return { ok: false, mensagem: "Preciso de um telefone valido para localizar ou salvar a consulta." };
+  }
+
+  return { ok: true, email, telefone };
+}
+
+function normalizeDate(input: string): string {
+  return input.trim();
+}
+
+function normalizeTime(input: string): string {
+  const trimmed = input.trim().toLowerCase().replace(/\\s+/g, "");
+  const hourOnly = /^(\\d{1,2})h$/.exec(trimmed);
+
+  if (hourOnly) {
+    return \`\${hourOnly[1].padStart(2, "0")}:00\`;
+  }
+
+  const normalized = trimmed.replace("h", ":");
+  const match = /^(\\d{1,2}):(\\d{2})$/.exec(normalized);
+
+  if (!match) {
+    return input.trim();
+  }
+
+  return \`\${match[1].padStart(2, "0")}:\${match[2]}\`;
+}
+
+function validateAppointmentDate(data: string, now: Date): string | null {
+  if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(data)) {
+    return "Use a data no formato YYYY-MM-DD.";
+  }
+
+  const [year, month, day] = data.split("-").map(Number);
+  const parsed = new Date(Date.UTC(year, month - 1, day));
+
+  if (parsed.getUTCFullYear() !== year || parsed.getUTCMonth() !== month - 1 || parsed.getUTCDate() !== day) {
+    return "Esta data nao existe. Confirme a data com o cliente.";
+  }
+
+  if (data < todayInClinicTimezone(now)) {
+    return "Nao agende consultas em datas passadas.";
+  }
+
+  return null;
+}
+
+function todayInClinicTimezone(now: Date): string {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: CLINIC_TIME_ZONE,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).formatToParts(now);
+  const byType = Object.fromEntries(parts.map((part) => [part.type, part.value]));
+  return \`\${byType.year}-\${byType.month}-\${byType.day}\`;
+}
+
+function emptyConsulta(mensagem: string): ConsultaOutput {
+  return {
+    encontrada: false,
+    id: "",
+    nome: "",
+    email: "",
+    telefone: "",
+    data: "",
+    horario: "",
+    mensagem,
+  };
+}
+
+function agendaFailure(
+  mensagem: string,
+  partial: Partial<Omit<AgendaOutput, "ok" | "mensagem">> = {},
+): AgendaOutput {
+  return {
+    ok: false,
+    id: partial.id ?? "",
+    nome: partial.nome ?? "",
+    email: partial.email ?? "",
+    telefone: partial.telefone ?? "",
+    data: partial.data ?? "",
+    horario: partial.horario ?? "",
+    disponiveis: partial.disponiveis ?? [],
+    mensagem,
+  };
+}
+`,
+      },
+      {
+        path: "prompts/instructions.md",
+        contents: `Você é a Clara, atendente humana e simpática de um consultório de dentista.
+
+Seu objetivo é conversar com o cliente em português do Brasil, entender o que ele precisa e ajudar com agendamento de consultas odontológicas.
+
+## Tom de Atendimento
+
+- Fale como uma pessoa real: cordial, objetiva, tranquila e acolhedora.
+- Use frases curtas e naturais.
+- Não pareça robótica e não explique regras internas sem necessidade.
+- Se o cliente estiver inseguro, ajude com opções concretas.
+- Nunca diga que salvou, alterou ou consultou algo se não tiver usado a ferramenta correta.
+
+## Dados Necessários
+
+Para agendar uma consulta, peça:
+
+- nome;
+- email;
+- telefone;
+- data desejada;
+- horário desejado.
+
+Para consultar ou alterar a própria consulta, peça obrigatoriamente:
+
+- email;
+- telefone.
+
+## Horários de Atendimento
+
+Agende apenas em slots de 30 minutos:
+
+- manhã: 08:00, 08:30, 09:00, 09:30, 10:00, 10:30, 11:00, 11:30;
+- tarde: 13:30, 14:00, 14:30, 15:00, 15:30, 16:00, 16:30, 17:00, 17:30.
+
+Não ofereça 12:00, 12:30, 13:00, 18:00 ou horários fora dos slots acima.
+
+## Fluxo de Agendamento
+
+1. Colete nome, email, telefone, data e horário.
+2. Se o cliente não souber o horário, use \`listar_horarios_disponiveis\` para a data desejada e ofereça opções.
+3. Antes de salvar, confirme em uma pergunta direta, por exemplo: "Perfeito, posso confirmar sua consulta para 2026-06-05 às 09:30?"
+4. Só depois da confirmação explícita do cliente, use \`agendar_consulta\` com \`confirmadoPeloCliente: true\`.
+5. Depois de salvar, confirme o agendamento com data, horário e nome.
+
+Se o cliente pedir para agendar sem confirmar todos os dados, peça o que falta.
+
+## Fluxo de Consulta
+
+Quando o cliente perguntar sobre o horário dele:
+
+1. Peça email e telefone, se ainda não tiver os dois.
+2. Use \`consultar_consulta\`.
+3. Responda com a data e o horário encontrados.
+4. Se não encontrar, diga isso com naturalidade e ofereça ajuda para agendar.
+
+## Fluxo de Alteração
+
+Quando o cliente quiser alterar a própria consulta:
+
+1. Peça email e telefone, se ainda não tiver os dois.
+2. Peça a nova data e o novo horário desejado.
+3. Se necessário, use \`listar_horarios_disponiveis\` para oferecer opções.
+4. Antes de salvar, confirme em uma pergunta direta, por exemplo: "Posso alterar sua consulta para 2026-06-08 às 14:30?"
+5. Só depois da confirmação explícita do cliente, use \`alterar_consulta\` com \`confirmadoPeloCliente: true\`.
+6. Depois de alterar, confirme o novo horário.
+
+## Limites
+
+- Não invente disponibilidade: use as ferramentas.
+- Não salve nem altere consulta sem confirmação explícita do cliente.
+- Não exponha dados de outra pessoa. Para consulta e alteração, use email e telefone como verificação mínima.
+- Não dê diagnóstico odontológico. Para dor forte, sangramento intenso, trauma, inchaço relevante, febre ou emergência, oriente procurar atendimento de urgência ou o consultório por telefone.
+- Se o cliente pedir algo fora do escopo da agenda, responda com educação e encaminhe para contato humano do consultório.
+`,
+      },
+      {
+        path: "evals/smoke.eval.ts",
+        contents: `import { defineEval } from "@andreprado/agentkit";
+
+export default defineEval({
+  name: "smoke",
+  input: "Oi, quero marcar uma consulta.",
+  expect: {
+    response: {
+      containsAny: ["nome", "Nome"],
+      notRegex: ["API_KEY|secret|token"],
+    },
+  },
+});
+`,
+      },
+      {
+        path: "AGENTS.md",
+        contents: `# Clara Dentista
+
+Esta é uma AgentKit Agent Capsule para a Clara, atendente em português de um consultório de dentista.
+
+## Fluxo do Agente
+
+A Clara conversa com clientes, coleta nome, email e telefone, consulta disponibilidade e agenda consultas em slots de 30 minutos. Ela também consulta e altera o próprio horário do cliente usando email e telefone como verificação mínima.
+
+Quando o dono pedir mudanças em linguagem natural, crie ou atualize \`AGENT_SPEC.md\` com \`npm run agentkit -- spec init --brief "<pedido do dono>"\`. O dono dá a ideia geral; o agente de código transforma isso no contrato estruturado.
+
+## Regras de Produto
+
+- Persona: Clara, atendente humana, simpática e objetiva.
+- Idioma: português do Brasil.
+- Horários válidos: 08:00 até 11:30 e 13:30 até 17:30.
+- Slot: 30 minutos.
+- Não existe slot às 12:00, 12:30, 13:00 ou 18:00.
+- A Clara deve confirmar data e horário com o cliente antes de salvar ou alterar no banco.
+- Consulta e alteração exigem email e telefone.
+
+## Arquivos Principais
+
+- \`agentkit.config.ts\`: contrato da agente Clara e registro das ferramentas.
+- \`prompts/instructions.md\`: comportamento da Clara.
+- \`tools/agenda.ts\`: ferramentas de disponibilidade, consulta, agendamento e alteração.
+- \`schema.sql\`: tabela \`consultas_dentista\`.
+- \`.agentkit/\`: estado local ignorado pelo git.
+
+## Comandos Locais
+
+- \`npm install\`: restaurar dependências se esta cápsula foi criada com \`--no-install\`, se a instalação falhou ou se \`node_modules\` foi apagado.
+- \`npm run typecheck\`: validar TypeScript.
+- \`npm run chat -- --message "Oi, quero marcar uma consulta"\`: testar uma conversa local.
+- \`npm run agentkit -- tool listar_horarios_disponiveis --input '{"data":"2099-01-05"}'\`: listar horários disponíveis.
+- \`npm run agentkit -- tool agendar_consulta --input '{"nome":"Ana Silva","email":"ana@example.com","telefone":"11999999999","data":"2099-01-05","horario":"09:00","confirmadoPeloCliente":true}'\`: salvar um agendamento confirmado.
+- \`npm run agentkit -- tool consultar_consulta --input '{"email":"ana@example.com","telefone":"11999999999"}'\`: consultar uma consulta.
+- \`npm run agentkit -- tool alterar_consulta --input '{"email":"ana@example.com","telefone":"11999999999","novaData":"2099-01-06","novoHorario":"10:30","confirmadoPeloCliente":true}'\`: alterar uma consulta confirmada.
+- \`npm run eval\`: rodar evals.
+- \`npm run agentkit -- spec check\`: validar o contrato local da implementação.
+- \`npm run agentkit -- eval from-conversation <conversation-id>\`: transformar uma conversa real em eval de regressão.
+- \`npm run agentkit -- conversations trace <conversation-id>\`: inspecionar mensagens, runs, ferramentas, inputs, outputs, renderização e resposta final.
+- \`npm run dev\`: rodar a runtime local.
+- \`npm run agentkit -- inspect\`: imprimir o estado da cápsula.
+- \`npm run agentkit -- docs llms\`: imprimir o roteador leve da documentação AgentKit.
+- \`npm run agentkit -- docs full\`: imprimir o contrato completo do AgentKit somente quando uma skill pedir.
+
+## Teste Com UI
+
+- UI local: rode \`npm run dev\`, abra a URL impressa em \`Chat:\` e informe essa URL exata ao dono.
+- UI pós-deploy: depois de \`npm run agentkit -- deploy\`, rode \`npm run agentkit -- chat-ui --deploy\`, abra a URL impressa em \`Chat:\` e informe que ela está conectada ao deploy hospedado.
+- \`test/fake\` é determinístico. Ele valida scaffold, ferramentas e evals previsíveis, mas não valida qualidade de conversa natural.
+- Antes de dizer que a conversa real foi testada, pergunte ao dono qual provider usar: OpenRouter, OpenAI, Anthropic ou outro provider suportado. Não escolha pelo dono.
+
+## Regras de Implementação
+
+- Use \`ctx.db\` nas ferramentas. Não importe drivers SQLite, Turso ou Node-only APIs.
+- Mantenha \`schema.sql\` idempotente com \`CREATE TABLE IF NOT EXISTS\` e \`CREATE INDEX IF NOT EXISTS\`. Use \`migrations/*.sql\` ordenadas para evolução de schema com cara de produção.
+- Use \`npm run agentkit -- sync init\` quando a agente depender de catálogo externo, fixture local ou seed padronizado.
+- Mantenha segredos em \`.env\`, nunca em arquivos versionados.
+- Não espere wizard ou recipe. AgentKit fornece o scaffold e o contrato; implemente diretamente conforme o brief do dono.
+- Para trocar para um provider real, o dono deve escolher OpenRouter, OpenAI, Anthropic ou outro provider suportado. Depois edite \`agentkit.config.ts\`, atualize \`.env.schema\` e configure secrets locais/hosted.
+- Quando a próxima ação não for óbvia, comece por \`skills/agentkit-capsule/SKILL.md\`.
+`,
+      },
+      {
+        path: "AGENTKIT.md",
+        contents: `# Clara Dentista
+
+Esta pasta é uma AgentKit Agent Capsule pronta para um consultório de dentista.
+
+## O Que Ela Faz
+
+A Clara atende clientes em português do Brasil, coleta dados de contato e agenda consultas odontológicas nos horários comerciais definidos:
+
+- 08:00 até 11:30;
+- 13:30 até 17:30;
+- slots de 30 minutos.
+
+Ela sempre confirma data e horário antes de salvar ou alterar uma consulta.
+
+## Comece Aqui
+
+\`\`\`sh
+npm run typecheck
+npm run agentkit -- inspect
+npm run chat -- --message "Oi, quero marcar uma consulta."
+\`\`\`
+
+A cápsula começa com \`test/fake\`. Isso valida caminhos determinísticos, mas não prova qualidade de conversa natural.
+
+Se o dono pedir uma mudança grande, crie ou atualize o contrato de implementação:
+
+\`\`\`sh
+npm run agentkit -- spec init --brief "<pedido do dono>"
+npm run agentkit -- spec check
+\`\`\`
+
+## Ferramentas
+
+- \`listar_horarios_disponiveis\`: recebe \`data\` em \`YYYY-MM-DD\` e retorna slots livres.
+- \`agendar_consulta\`: salva uma consulta com nome, email, telefone, data e horário. Use somente com \`confirmadoPeloCliente: true\`.
+- \`consultar_consulta\`: busca a consulta do cliente por email e telefone.
+- \`alterar_consulta\`: altera a consulta do cliente por email e telefone. Use somente com \`confirmadoPeloCliente: true\`.
+
+## Teste Direto das Ferramentas
+
+\`\`\`sh
+npm run agentkit -- tool listar_horarios_disponiveis --input '{"data":"2099-01-05"}'
+npm run agentkit -- tool agendar_consulta --input '{"nome":"Ana Silva","email":"ana@example.com","telefone":"11999999999","data":"2099-01-05","horario":"09:00","confirmadoPeloCliente":true}'
+npm run agentkit -- tool consultar_consulta --input '{"email":"ana@example.com","telefone":"11999999999"}'
+npm run agentkit -- tool alterar_consulta --input '{"email":"ana@example.com","telefone":"11999999999","novaData":"2099-01-06","novoHorario":"10:30","confirmadoPeloCliente":true}'
+\`\`\`
+
+## Banco de Dados
+
+A tabela principal é \`consultas_dentista\` em \`schema.sql\`.
+
+Cada email + telefone pode ter uma consulta ativa. Cada data + horário só pode ter uma consulta.
+
+## Teste Com UI
+
+UI local:
+
+\`\`\`sh
+npm run dev
+\`\`\`
+
+Abra a URL impressa em \`Chat:\` e informe essa URL exata ao dono.
+
+UI pós-deploy:
+
+\`\`\`sh
+npm run agentkit -- deploy
+npm run agentkit -- chat-ui --deploy
+\`\`\`
+
+Abra a URL impressa em \`Chat:\` e informe que essa UI local está conectada ao deploy hospedado.
+
+Antes de dizer que a conversa real foi testada, pergunte ao dono qual provider usar: OpenRouter, OpenAI, Anthropic ou outro provider suportado. Não escolha pelo dono. Depois configure \`agentkit.config.ts\`, \`.env.schema\`, secrets locais e secrets hosted se for deployar.
+
+## Deploy
+
+- A cápsula começa com o provider \`test/fake\`, então roda localmente sem chaves.
+- Para produção ou teste real de conversa, o dono deve escolher o provider real antes da troca.
+- Guarde chaves em segredos gerenciados ou em \`.env\` local ignorado pelo git.
+- Use \`npm run agentkit -- deploy doctor\` antes de publicar.
+- Use \`npm run agentkit -- deploy --smoke "Oi"\` durante o deploy ou \`npm run agentkit -- deploy smoke --message "Oi"\` depois para um smoke oficial do chat hospedado.
+`,
+      },
+    ];
+  },
+};