akanjs 3.1.0-rc.2 → 3.1.0-rc.21

package/webkit/McpAppAgent.ts

@@ -4,6 +4,7 @@ import { Logger } from "akanjs/common";
 import { AgentContext, AgentVisual, ensureStoreSurface, ScreenSettle, StoreRegistry } from "akanjs/store";
 import {
   type AgenticSurface,
+  type MessageAttachment,
   type ToolApprovalRequest,
   type ToolCallResult,
   ToolOutput,
@@ -146,7 +147,7 @@ export class McpAppAgent {
     return JSON.stringify(tools);
   }
 
-  static #resultOf({ result, changes, error }: ToolCallResult): McpToolResult {
+  static #resultOf({ result, changes, error, attachments = [] }: ToolCallResult): McpToolResult {
     if (error !== undefined) return { content: [{ type: "text", text: error }], isError: true };
     const text = changes?.length
       ? JSON.stringify({ ...(result !== undefined ? { result } : {}), changes })
@@ -155,6 +156,15 @@ export class McpAppAgent {
         : typeof result === "string"
           ? result
           : JSON.stringify(result);
-    return { content: [{ type: "text", text }] };
+    return { content: [{ type: "text", text }, ...attachments.map(McpAppAgent.#contentOf)] };
+  }
+
+  static #contentOf({ name, mimeType, data, url, text }: MessageAttachment): McpToolResult["content"][number] {
+    if (data !== undefined && mimeType.startsWith("image/")) return { type: "image", data, mimeType };
+    if (text !== undefined) return { type: "text", text: `--- attachment: ${name} (${mimeType}) ---\n${text}` };
+    return {
+      type: "text",
+      text: `[${name} (${mimeType}) was not attached${url ? `; it is at ${url}` : ""}: an MCP tool result carries only pictures, as bytes.]`,
+    };
   }
 }

package/webkit/RenderLayer.tsx

@@ -1,5 +1,13 @@
 "use client";
-import { debugFrame, RouteDefinition, type RouteRender, router, usePathCtx } from "akanjs/client";
+import {
+  csrLocation,
+  debugFrame,
+  RouteDefinition,
+  type RouteRender,
+  router,
+  Translator,
+  usePathCtx,
+} from "akanjs/client";
 import { isThenable, Logger } from "akanjs/common";
 import { createContext, createElement, memo, type ReactNode, useContext, useEffect, useRef, useState } from "react";
 import { CsrFrameDump } from "./csrFrameDump";
@@ -64,7 +72,10 @@ export const RenderLayer = memo((props: RenderLayerProps) => {
     };
   }, [activity]);
   
-  const path = (usePathCtx() as Partial<ReturnType<typeof usePathCtx>>).location?.pathRoute.path ?? "the root";
+  const location = (usePathCtx() as Partial<ReturnType<typeof usePathCtx>>).location;
+  const path = location?.pathRoute.path ?? "the root";
+  
+  const renderPath = entryPathOf(location?.pathname);
   if (isAsyncRender && routeRender) {
     const argsKey = RouteDefinition.renderArgsKey(
       routeRender.render,
@@ -84,7 +95,10 @@ export const RenderLayer = memo((props: RenderLayerProps) => {
       const redirectsBefore = router.redirectCount();
       const layer = `${routeRender.kind ?? "layout"} ${index} of ${path}`;
       const result = reportFailure(
-        routeRender.render({ children: layerOutlet, params, searchParams } as never) ?? null,
+        Translator.renderAt(
+          renderPath,
+          () => routeRender.render({ children: layerOutlet, params, searchParams } as never) ?? null,
+        ),
         layer,
       );
       const next: RenderedRoute = {
@@ -133,7 +147,7 @@ export const RenderLayer = memo((props: RenderLayerProps) => {
         }}
       />
     );
-  if (!value) return <>{composeLoadingFallback(renders.slice(index), params)}</>;
+  if (!value) return <>{Translator.renderAt(renderPath, () => composeLoadingFallback(renders.slice(index), params))}</>;
   return frame(<layerChildContext.Provider value={children}>{value}</layerChildContext.Provider>);
 });
 
@@ -152,6 +166,11 @@ function reportFailure(result: ReactNode | Promise<ReactNode>, layer: string): R
   return result;
 }
 
+function entryPathOf(pathname: string | undefined): string | undefined {
+  if (!pathname || csrLocation.isMemory) return pathname;
+  return new URL(`http://localhost${pathname}`).pathname;
+}
+
 function isAsyncRouteRender(routeRender?: RouteRender): boolean {
   return Boolean(routeRender?.isAsync || routeRender?.render.constructor.name === "AsyncFunction");
 }

package/webkit/useDebounce.ts

@@ -1,21 +1,30 @@
 "use client";
-import { useCallback } from "react";
-
-const debounce = <Args extends unknown[], Return>(callback: (...args: Args) => Return, wait = 500) => {
-  let timer: NodeJS.Timeout;
-  return (...args: Args) => {
-    clearTimeout(timer);
-    timer = setTimeout(() => {
-      callback(...args);
-    }, wait);
-  };
-};
+import { useCallback, useEffect, useRef } from "react";
 
 export const useDebounce = <Args extends unknown[], Return>(
   callback: (...args: Args) => Return,
-  states: unknown[] = [],
+  _states: unknown[] = [],
   wait = 100,
 ) => {
-  const fn = useCallback(debounce(callback, wait), states);
-  return fn;
+  const savedCallback = useRef(callback);
+  const pending = useRef<{ timer: ReturnType<typeof setTimeout>; args: Args } | null>(null);
+  useEffect(() => {
+    savedCallback.current = callback;
+  }, [callback]);
+  const flush = useCallback(() => {
+    const call = pending.current;
+    if (!call) return;
+    clearTimeout(call.timer);
+    pending.current = null;
+    savedCallback.current(...call.args);
+  }, []);
+  
+  useEffect(() => flush, []);
+  return useCallback(
+    (...args: Args) => {
+      if (pending.current) clearTimeout(pending.current.timer);
+      pending.current = { timer: setTimeout(flush, wait), args };
+    },
+    [wait],
+  );
 };

package/client/viewTransition.ts

@@ -1,10 +0,0 @@
-import type { ComponentType, ViewTransitionProps } from "react";
-import * as React from "react";
-
-const react = React as {
-  ViewTransition?: ComponentType<ViewTransitionProps>;
-  addTransitionType?: (type: string) => void;
-};
-
-export const ViewTransition = react.ViewTransition;
-export const addTransitionType = react.addTransitionType;

package/types/client/viewTransition.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentType, ViewTransitionProps } from "react";
-export declare const ViewTransition: ComponentType<ViewTransitionProps> | undefined;
-export declare const addTransitionType: ((type: string) => void) | undefined;