docs(showcase/langroid): tool-rendering regions + open-gen-ui canonical names

- tool-rendering: @region[render-weather-tool] on page.tsx;
  @region[weather-tool-backend] on src/agents/agent.py (the
  GetWeatherTool ToolMessage class). New render-flight-tool.snippet.tsx
  sibling for @region[render-flight-tool] + @region[catchall-renderer].
- open-gen-ui: renamed legacy @region[ogui-runtime-flag] to canonical
  @region[minimal-runtime-flag] + @region[advanced-runtime-config] in
  copilotkit-ogui/route.ts (no behavior change; aligns with other
  frameworks).

Manifest highlight updated to point at the real backend
src/agents/agent.py (replacing the stub demo agent.py reference).

Author: samjulien

showcase/integrations/langroid/manifest.yaml

@@ -130,7 +130,7 @@ demos:
     route: /demos/tool-rendering
     animated_preview_url:
     highlight:
-      - src/app/demos/tool-rendering/agent.py
+      - src/agents/agent.py
       - src/app/demos/tool-rendering/page.tsx
       - src/app/api/copilotkit/route.ts
   - id: gen-ui-tool-based

showcase/integrations/langroid/src/agents/agent.py

@@ -607,6 +607,7 @@ def _tool_error(*, error: _ToolErrorKind, message: str) -> str:
     return _json_dumps({"error": error.value, "message": message})
 
 
+# @region[weather-tool-backend]
 class GetWeatherTool(ToolMessage):
     request: str = "get_weather"
     purpose: str = "Get current weather for a location."
@@ -622,6 +623,7 @@ def handle(self) -> str:
                 error=_ToolErrorKind.GET_WEATHER_FAILED,
                 message=f"{exc.__class__.__name__}: {str(exc)[:200]}",
             )
+# @endregion[weather-tool-backend]
 
 
 class QueryDataTool(ToolMessage):

showcase/integrations/langroid/src/app/api/copilotkit-ogui/route.ts

@@ -24,7 +24,8 @@ export const POST = async (req: NextRequest) => {
     const { handleRequest } = copilotRuntimeNextJSAppRouterEndpoint({
       endpoint: "/api/copilotkit-ogui",
       serviceAdapter: new ExperimentalEmptyAdapter(),
-      // @region[ogui-runtime-flag]
+      // @region[minimal-runtime-flag]
+      // @region[advanced-runtime-config]
       // Server-side config is identical for the minimal and advanced cells —
       // the advanced behaviour (sandbox -> host function calls) is wired
       // entirely on the frontend via `openGenerativeUI.sandboxFunctions` on
@@ -39,7 +40,8 @@ export const POST = async (req: NextRequest) => {
           agents: ["open-gen-ui", "open-gen-ui-advanced"],
         },
       }),
-      // @endregion[ogui-runtime-flag]
+      // @endregion[advanced-runtime-config]
+      // @endregion[minimal-runtime-flag]
     });
     return await handleRequest(req);
   } catch (error: unknown) {

showcase/integrations/langroid/src/app/demos/tool-rendering/page.tsx

@@ -27,6 +27,7 @@ export default function ToolRenderingDemo() {
 }
 
 function Chat() {
+  // @region[render-weather-tool]
   useRenderTool({
     name: "get_weather",
     parameters: z.object({
@@ -61,6 +62,7 @@ function Chat() {
       );
     },
   });
+  // @endregion[render-weather-tool]
 
   useConfigureSuggestions({
     suggestions: [

showcase/integrations/langroid/src/app/demos/tool-rendering/render-flight-tool.snippet.tsx

@@ -0,0 +1,87 @@
+// Docs-only snippet — not imported or rendered. Langroid's tool-rendering
+// demo at page.tsx exercises the get_weather renderer only; the docs
+// page at /generative-ui/tool-rendering also teaches the search_flights
+// per-tool pattern and the wildcard catch-all. These two regions show
+// what those would look like in the same Langroid demo shape, so the
+// docs can render real teaching code rather than a missing-snippet box.
+//
+// See chat-component.snippet.tsx in agentic-chat for the same pattern.
+
+import { useRenderTool, useDefaultRenderTool } from "@copilotkit/react-core/v2";
+import { z } from "zod";
+
+type CatchallToolStatus = "in_progress" | "complete" | "error";
+
+interface FlightSearchResult {
+  origin?: string;
+  destination?: string;
+  flights?: unknown[];
+}
+
+function FlightListCard(_props: {
+  loading: boolean;
+  origin: string;
+  destination: string;
+  flights: unknown[];
+}) {
+  return null;
+}
+
+function CustomCatchallRenderer(_props: {
+  name: string;
+  parameters: unknown;
+  status: CatchallToolStatus;
+  result: unknown;
+}) {
+  return null;
+}
+
+function parseJsonResult<T>(_result: unknown): T {
+  return {} as T;
+}
+
+export function FlightToolRenderers() {
+  // @region[render-flight-tool]
+  // Per-tool renderer: search_flights → branded FlightListCard.
+  useRenderTool(
+    {
+      name: "search_flights",
+      parameters: z.object({
+        origin: z.string(),
+        destination: z.string(),
+      }),
+      render: ({ parameters, result, status }) => {
+        const loading = status !== "complete";
+        const parsed = parseJsonResult<FlightSearchResult>(result);
+        return (
+          <FlightListCard
+            loading={loading}
+            origin={parameters?.origin ?? parsed.origin ?? ""}
+            destination={parameters?.destination ?? parsed.destination ?? ""}
+            flights={parsed.flights ?? []}
+          />
+        );
+      },
+    },
+    [],
+  );
+  // @endregion[render-flight-tool]
+
+  // @region[catchall-renderer]
+  // Wildcard catch-all for every remaining tool — anything the agent might
+  // call that doesn't have a dedicated useRenderTool registration.
+  useDefaultRenderTool(
+    {
+      render: ({ name, parameters, status, result }) => (
+        <CustomCatchallRenderer
+          name={name}
+          parameters={parameters}
+          status={status as CatchallToolStatus}
+          result={result}
+        />
+      ),
+    },
+    [],
+  );
+  // @endregion[catchall-renderer]
+}