Changelog

// Before
import type { RegisteredTool } from "@waniwani/sdk/legacy";

// After
import type { RegisteredTool } from "@waniwani/sdk/mcp";

// Before
import { createTool, registerTools } from "@waniwani/sdk/mcp";

export const searchTool = createTool(
  {
    id: "search",
    title: "Search",
    description: "Search the knowledge base",
    inputSchema: { query: z.string() },
    annotations: { readOnlyHint: true },
  },
  async ({ query }, { waniwani }) => {
    await waniwani?.track.priceShown({ amount: 49, currency: "EUR" });
    return { text: `Results for "${query}"`, data: { query } };
  },
);

await registerTools(server, [searchTool]);

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

server.registerTool(
  "search",
  {
    title: "Search",
    description: "Search the knowledge base",
    inputSchema: { query: z.string() },
    annotations: { title: "Search", readOnlyHint: true },
  },
  async ({ query }, extra) => {
    const waniwani = extractScopedClient(extra);
    await waniwani?.track.priceShown({ amount: 49, currency: "EUR" });
    return {
      content: [{ type: "text" as const, text: `Results for "${query}"` }],
      structuredContent: { query },
    };
  },
);

// After — the _meta createTool used to build for a resource-backed tool
_meta: {
  "openai/outputTemplate": openaiUri,
  "openai/toolInvocation/invoking": "Loading...",
  "openai/toolInvocation/invoked": "Loaded",
  "openai/widgetAccessible": true,
  "openai/resultCanProduceWidget": true,
  ui: { resourceUri: mcpUri },
  "ui/resourceUri": mcpUri,
}

// Before — app/api/waniwani/[[...path]]/route.ts
import { toNextJsHandler } from "@waniwani/sdk/next-js";
export const { GET, POST } = toNextJsHandler(client);

// and, on the page
<ChatCard api="/api/waniwani" />

// After — delete the route file
import { WaniwaniChat } from "@waniwani/sdk/chat";

<WaniwaniChat token="wwp_..." channelId="51c3658a-..." />

await client.track({ event: "quote.requested" });
await client.track({ event: "quote.succeeded", properties: { amount: 120, currency: "EUR" } });
await client.track({ event: "purchase.completed", properties: { amount: 490, currency: "EUR" } });

await client.track.priceShown({ amount: 120, currency: "EUR" });
await client.track.converted({ amount: 490, currency: "EUR" });

import { useWaniwani } from "@waniwani/sdk/mcp/react";

// relied on auto-discovery via WidgetProvider / a self-opened host connection
const wani = useWaniwani();

import { useWaniwani } from "@waniwani/sdk/mcp/react/skybridge";

const wani = useWaniwani(); // reads skybridge's useToolInfo().responseMetadata

import { useWaniwani } from "@waniwani/sdk/mcp/react";

const wani = useWaniwani({ toolResponseMetadata }); // the host's tool-response _meta
// bring-your-own backend, unchanged:
const wani2 = useWaniwani({ endpoint: "https://…/v2/track", source: "chatgpt" });

const wani = useWaniwani({ capture: { click: true, scroll: true } });
wani.track("plan_viewed", { plan: "pro" });
wani.step("selected_plan");
wani.conversion("purchase", { amount: 49 });

const wani = useWaniwani();
wani.track.priceShown({ amount: 49, currency: "EUR" });
wani.track.optionSelected({ id: "pro", amount: 49, currency: "EUR" });
wani.track.converted({ amount: 49, currency: "EUR" });

// Before
const config = toolResponseMetadata?.waniwani;
// After
const config = toolResponseMetadata?.["waniwani/widget"];

await client.track.lead({ source: "newsletter", externalUserId: "user_123" });

await client.track({ event: "lead", properties: { source: "newsletter" }, sessionId });

await client.track.leadQualified({
  externalId: "lead_abc123", // your CRM/lead record id, the strongest dedup key
  email: "jane@example.com",
  name: "Jane Doe",
  source: "newsletter",
  externalUserId: "user_123",
});

await client.track({ event: "lead_qualified", properties: { source: "newsletter" }, sessionId });

grep -rn "track\.lead(\|\"lead\"\|'lead'" src/ app/ lib/  # should return no tracking call sites
bun run typecheck
bun test

.addConditionalEdge("analyze_email", (state) =>
  state.isCompanyEmail ? "done" : "ask_company",
)

.addConditionalEdge("analyze_email", ["done", "ask_company"], (state) =>
  state.isCompanyEmail ? "done" : "ask_company",
)

// Before
.addConditionalEdge("route_country", (state) => {
  if (state.country === "FR") return "fr_path";
  if (state.country === "DE") return "de_path";
  return "default_path";
})

// After
.addConditionalEdge(
  "route_country",
  ["fr_path", "de_path", "default_path"],
  (state) => {
    if (state.country === "FR") return "fr_path";
    if (state.country === "DE") return "de_path";
    return "default_path";
  },
)

bun run typecheck   # condition return type is now checked against `to`
bun test

# 1. Server-side MCP primitives → @waniwani/sdk/legacy
#    (createTool, createResource, registerTools, and their associated types)
#    Rewrite any import of { createTool | createResource | registerTools |
#    ToolConfig | ToolHandler | ToolHandlerContext | RegisteredTool |
#    ToolToolCallback | ResourceConfig | RegisteredResource | WidgetCSP }
#    from "@waniwani/sdk/mcp" → "@waniwani/sdk/legacy"

# 2. Widget host hooks/components/types → @waniwani/sdk/legacy/react
#    Rewrite any import of { WidgetProvider | useWidgetClient | useToolOutput |
#    useToolResponseMetadata | useCallTool | useSendFollowUp | useFlowAction |
#    useUpdateModelContext | useDisplayMode | useRequestDisplayMode | useTheme |
#    useLocale | useSafeArea | useMaxHeight | useWidgetState | useOpenExternal |
#    useIsChatGptApp | InitializeNextJsInIframe | LoadingWidget |
#    DevModeProvider | getMockState | initializeMockOpenAI |
#    updateMockDisplayMode | updateMockGlobal | updateMockTheme |
#    updateMockToolOutput | DeviceType | DisplayMode | SafeArea |
#    SafeAreaInsets | Theme | UnknownObject | UserAgent | FlowActionResult |
#    ModelContextContentBlock | ModelContextUpdate | SendFollowUpOptions |
#    HostContext | ToolCallResult | ToolResult | UnifiedWidgetClient |
#    detectPlatform | isMCPApps | isOpenAI | WidgetPlatform }
#    from "@waniwani/sdk/mcp/react" → "@waniwani/sdk/legacy/react"
#
#    Leave imports of { useWaniwani | UseWaniwaniOptions | WaniwaniWidget }
#    on "@waniwani/sdk/mcp/react" — those are non-legacy.

# 3. Next.js adapter → @waniwani/sdk/legacy/next-js
#    Rewrite "@waniwani/sdk/next-js" → "@waniwani/sdk/legacy/next-js"
#    (every export of the old path was moved; no symbol-level filtering needed)

# 4. Express adapter → @waniwani/sdk/legacy/express-js
#    Rewrite "@waniwani/sdk/express-js" → "@waniwani/sdk/legacy/express-js"

# 5. Chat-server types
#    "@waniwani/sdk/chat/server" still works as a re-export shim.
#    No required rewrite. If you want to drop the shim early, point the imports
#    at the legacy server-types module that backs your adapter.

bun run typecheck
bun run lint
bun test

# Any import from a legacy path
grep -rn "@waniwani/sdk/legacy" src/ app/ pages/

# Legacy symbols still pulled through non-legacy paths.
# These greps only flag the moved symbols; OSS symbols (createFlow, KvStore,
# withWaniwani, useWaniwani, …) stay on the original paths and are not matched.

grep -rEn 'createTool|createResource|registerTools|ToolConfig|ToolHandler|ToolHandlerContext|RegisteredTool|ToolToolCallback|ResourceConfig|RegisteredResource|WidgetCSP|detectPlatform|isMCPApps|isOpenAI|WidgetPlatform|HostContext|ToolCallResult|ToolResult|UnifiedWidgetClient' src/ app/ pages/ \
  | grep "@waniwani/sdk/mcp"

grep -rEn 'WidgetProvider|useWidgetClient|useToolOutput|useToolResponseMetadata|useCallTool|useSendFollowUp|useFlowAction|useUpdateModelContext|useDisplayMode|useRequestDisplayMode|useTheme|useLocale|useSafeArea|useMaxHeight|useWidgetState|useOpenExternal|useIsChatGptApp|InitializeNextJsInIframe|LoadingWidget|DevModeProvider' src/ app/ pages/ \
  | grep "@waniwani/sdk/mcp/react"

grep -rEn 'from ["'\'']@waniwani/sdk/next-js["'\'']' src/ app/ pages/
grep -rEn 'from ["'\'']@waniwani/sdk/express-js["'\'']' src/ app/ pages/

// Before
import { ChatCard } from "@waniwani/sdk/chat";

<ChatCard
  apiKey={process.env.NEXT_PUBLIC_WANIWANI_API_KEY}
  title="Assistant"
  width={500}
  height={600}
  welcomeMessage="Hi! How can I help?"
/>

// After — bring-your-own-backend, no card chrome
import { ChatEmbed } from "@waniwani/sdk/chat";

<ChatEmbed
  api="/api/my-chat-endpoint"
  welcome={{ title: "Assistant", description: "Hi! How can I help?" }}
/>

flow
  .addNode("ask_family_details", ({ interrupt }) => {
    return interrupt({
      partnerName: { question: "What is your partner's name?" },
      numKids: { question: "How many children do you have?" },
    });
  }, { label: "Ask family details" });

flow.addNode({
  id: "ask_family_details",
  label: "Ask family details",
  run: ({ interrupt }) =>
    interrupt({
      partnerName: { question: "What is your partner's name?" },
      numKids: { question: "How many children do you have?" },
    }),
});

import type { AddNodeConfig } from "@waniwani/sdk/mcp";

const askEmail: AddNodeConfig<MyState, "ask_email"> = {
  id: "ask_email",
  run: ({ interrupt }) =>
    interrupt({ email: { question: "What's your email?" } }),
};

flow.addNode(askEmail);