Suggestions

await client.patchMCPTools({
  mcp,
  sessionId,
  suggest: true,
});

await client.patch_mcp_tools(
    mcp=mcp,
    session_id=session_id,
    suggest=True,
)

import "dotenv/config";
import { writeFileSync } from "node:fs";
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import Vespper, { type SuggestEditResult } from "vespper";

const OLD =
  '<p class="...">This report summarizes our Q4 performance. Revenue grew steadily across all regions, and operating margins improved compared to the prior quarter.</p>';

const client = new Vespper();
const sessionId = await client.openSession("./sample.docx");
const mcp = new Client({ name: "suggestions-example", version: "0.1.0" });
await mcp.connect(
  new StreamableHTTPClientTransport(new URL("https://mcp.vespper.com/mcp"), {
    requestInit: {
      headers: { Authorization: client.authorizationHeader },
    },
  }),
);
await client.patchMCPTools({ mcp, sessionId, suggest: true });

// Your agent makes this call. With suggest: true, it only locates the edit
// in the document and returns it as a suggestion. Nothing is applied.
const result = await mcp.callTool({
  name: "edit_document",
  arguments: {
    edits: [{ old: OLD, new: OLD.replace("grew steadily", "grew 12%") }],
  },
});
const { suggestions } = result.structuredContent as SuggestEditResult;

// After the user accepts the suggestions, apply them.
const accepted = suggestions.map((suggestion) => ({
  old: suggestion.old,
  new: suggestion.new,
}));
for await (const outcome of client.applyEdits(sessionId, accepted, {
  author: "Vespper Agent",
})) {
  if (!outcome.ok) console.error(outcome.position, outcome.reason);
}

writeFileSync("sample-redlined.docx", client.getSessionDocument(sessionId));
await mcp.close();
await client.closeSession(sessionId);

import asyncio
from pathlib import Path

from dotenv import load_dotenv
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
from vespper import EditPair, SuggestEditResult, Vespper


load_dotenv()

OLD = (
    '<p class="...">This report summarizes our Q4 performance. Revenue grew '
    "steadily across all regions, and operating margins improved compared to "
    "the prior quarter.</p>"
)


async def main():
    client = Vespper()
    session_id = await client.open_session("./sample.docx")

    async with streamablehttp_client(
        "https://mcp.vespper.com/mcp",
        headers={"Authorization": client.authorization_header},
    ) as (read, write, _):
        async with ClientSession(read, write) as mcp:
            await mcp.initialize()
            await client.patch_mcp_tools(
                mcp=mcp,
                session_id=session_id,
                suggest=True,
            )

            # Your agent makes this call. With suggest=True, it only locates the
            # edit in the document and returns it as a suggestion. Nothing is applied.
            result = await mcp.call_tool(
                "edit_document",
                {
                    "edits": [
                        {
                            "old": OLD,
                            "new": OLD.replace("grew steadily", "grew 12%"),
                        }
                    ]
                },
            )
            proposal = SuggestEditResult.model_validate(result.structuredContent)

    # After the user accepts the suggestions, apply them.
    accepted = [
        EditPair(old=suggestion.old, new=suggestion.new)
        for suggestion in proposal.suggestions
    ]
    async for outcome in client.apply_edits(
        session_id, accepted, author="Vespper Agent"
    ):
        if not outcome.ok:
            print(outcome.position, outcome.reason)

    Path("sample-redlined.docx").write_bytes(
        client.get_session_document(session_id)
    )
    await client.close_session(session_id)
    await client.close()


asyncio.run(main())