Documents

import { waniwani } from "@waniwani/sdk";

const wani = waniwani(); // reads WANIWANI_API_KEY from env

import { z } from "zod";

const invoice = z.object({
  invoiceNumber: z.string().nullable(),
  total: z.number().nullable(),
  dueDate: z.string().nullable(),
});

const { fields, pageCount } = await wani.documents.extract({
  url: "https://example.com/invoice.pdf",
  filename: "invoice.pdf",
  schema: invoice,
});

console.log(fields.invoiceNumber, pageCount);

{
  fields,          // your schema's shape, parsed. A null field is one the document did not legibly answer.
  pageCount,       // pages processed and billed
  pageConfidence,  // mean per-page OCR confidence, or null when none was reported
  documentId,      // handle for this extraction, valid for the 7-day retention window
}

import { extractScopedClient } from "@waniwani/sdk/mcp";
import { z } from "zod";

const summary = z.object({
  title: z.string().nullable(),
  summary: z.string().nullable(),
});

server.registerTool(
  "read_attachment",
  {
    title: "Read an attached file",
    description:
      "Read a document or image the visitor attached to this conversation. Takes no arguments: the attachment is already on the request.",
    inputSchema: {},
  },
  async (_args, extra) => {
    const wani = extractScopedClient(extra);
    const document = wani?.attachedDocuments[0];

    if (!wani || !document) {
      return { content: [{ type: "text", text: "Nothing is attached to this message." }] };
    }

    const { fields } = await wani.documents.extract({
      documentId: document.documentId,
      schema: summary,
    });

    return { content: [{ type: "text", text: `${document.filename}: ${fields.summary}` }] };
  },
);

import { readAttachedDocuments } from "@waniwani/sdk";

const documents = readAttachedDocuments(body);

await wani.documents.extract({
  documentId,
  schema: invoice,
  pages: [0, 1], // the first two pages
});