@agent-native/core 0.131.4 → 0.131.6

package/corpus/templates/design/app/hooks/useDesignHotkeys.ts

@@ -1,5 +1,7 @@
 import { useEffect, useLayoutEffect, useRef } from "react";
 
+import { createDesignCanvasInteractionAdapter } from "@/components/design/canvas-interactions/design-canvas-interactions";
+
 const useIsomorphicLayoutEffect =
   typeof window === "undefined" ? useEffect : useLayoutEffect;
 
@@ -240,13 +242,6 @@ const SHIFT_TOOL_SHORTCUTS: Record<
   l: { tool: "arrow", handler: "onArrowTool" },
 };
 
-const ARROW_DIRECTIONS: Record<string, DesignHotkeyDirection> = {
-  ArrowUp: "up",
-  ArrowRight: "right",
-  ArrowDown: "down",
-  ArrowLeft: "left",
-};
-
 export function isDesignHotkeyEditableTarget(target: EventTarget | null) {
   if (!target || typeof Element === "undefined") return false;
   if (!(target instanceof Element)) return false;
@@ -396,17 +391,6 @@ export function handleDesignHotkey(
     return true;
   };
 
-  const runNudge = (direction: DesignHotkeyDirection) => {
-    if (!props.onNudge) return false;
-    prevent();
-    props.onNudge({
-      ...details,
-      direction,
-      largeStep: event.shiftKey,
-    });
-    return true;
-  };
-
   const runAlign = (edge: DesignHotkeyAlignEdge) => {
     if (!props.onAlignSelection) return false;
     prevent();
@@ -421,6 +405,17 @@ export function handleDesignHotkey(
     return true;
   };
 
+  const designCanvasInteractions = createDesignCanvasInteractionAdapter({
+    shortcuts: props,
+  });
+
+  const runSharedCanvasCommand = () => {
+    const result = designCanvasInteractions.dispatchKeyboardEvent(event);
+    if (!result.handled) return false;
+    prevent();
+    return true;
+  };
+
   // Keep shortcut help global, including while an inspector field or code
   // editor owns focus. No other editing shortcut bypasses the editable guard.
   if (isShowKeyboardShortcutsHotkey(event)) {
@@ -449,8 +444,8 @@ export function handleDesignHotkey(
     }
   }
 
-  if (event.key in ARROW_DIRECTIONS && !primary && !event.altKey) {
-    return runNudge(ARROW_DIRECTIONS[event.key]);
+  if (event.key.startsWith("Arrow") && !primary && !event.altKey) {
+    return runSharedCanvasCommand();
   }
 
   if (event.key === "Escape") return run(props.onEscape);
@@ -487,7 +482,7 @@ export function handleDesignHotkey(
     return true;
   }
   if ((event.key === "Delete" || event.key === "Backspace") && !primary) {
-    return run(props.onDelete);
+    return runSharedCanvasCommand() || run(props.onDelete);
   }
 
   // Current Figma: Cmd+Backspace ungroups. Checked after plain Backspace
@@ -498,7 +493,10 @@ export function handleDesignHotkey(
   }
 
   if (primary && key === "z") {
-    return event.shiftKey ? run(props.onRedo) : run(props.onUndo);
+    return (
+      runSharedCanvasCommand() ||
+      (event.shiftKey ? run(props.onRedo) : run(props.onUndo))
+    );
   }
   if (primary && key === "y") return run(props.onRedo);
   // Figma Find uses the operating system's primary modifier, rather than
@@ -514,14 +512,16 @@ export function handleDesignHotkey(
     return run(props.onFind);
   }
   if (primary && !event.altKey && !event.shiftKey && key === "a") {
-    return run(props.onSelectAll);
+    return runSharedCanvasCommand() || run(props.onSelectAll);
   }
   // Figma's Cmd+Shift+X — toggle strikethrough. Must be checked before plain
   // Cmd+X (cut) below, since that check doesn't itself gate on shiftKey.
   if (primary && event.shiftKey && key === "x") {
     return run(props.onToggleStrikethrough);
   }
-  if (primary && key === "x") return run(props.onCut);
+  if (primary && key === "x") {
+    return runSharedCanvasCommand() || run(props.onCut);
+  }
   // Figma's Cmd+U — toggle underline. No existing binding claims plain "u".
   if (primary && !event.altKey && !event.shiftKey && key === "u") {
     return run(props.onToggleUnderline);
@@ -552,14 +552,16 @@ export function handleDesignHotkey(
   if (primary && key === "c") {
     if (event.altKey) return run(props.onCopyProps);
     if (event.shiftKey) return run(props.onCopyAsPng);
-    return run(props.onCopy);
+    return runSharedCanvasCommand() || run(props.onCopy);
   }
   if (primary && key === "v") {
     if (event.altKey) return run(props.onPasteProps);
     if (event.shiftKey) return run(props.onPasteOver);
-    return run(props.onPaste);
+    return runSharedCanvasCommand() || run(props.onPaste);
+  }
+  if (primary && key === "d") {
+    return runSharedCanvasCommand() || run(props.onDuplicate);
   }
-  if (primary && key === "d") return run(props.onDuplicate);
   // Figma's Shift+Cmd+R — "Paste to replace" — must be checked BEFORE plain
   // Cmd+R (rename) so shift wins; onPasteToReplace absent falls through to
   // rename so existing behavior is unaffected until the handler is wired.
@@ -658,17 +660,8 @@ export function handleDesignHotkey(
   // backward (single-step reorder). Alt+Cmd+]/Alt+Cmd+[ are silent aliases
   // of the plain front/back commands (kept for muscle memory / older
   // bindings), NOT of forward/backward.
-  if (primary && key === "]") {
-    return event.altKey ? run(props.onBringToFront) : run(props.onBringForward);
-  }
-  if (primary && key === "[") {
-    return event.altKey ? run(props.onSendToBack) : run(props.onSendBackward);
-  }
-  if (!primary && !event.altKey && !event.shiftKey && key === "]") {
-    return run(props.onBringToFront);
-  }
-  if (!primary && !event.altKey && !event.shiftKey && key === "[") {
-    return run(props.onSendToBack);
+  if (key === "]" || key === "[" || key === "}" || key === "{") {
+    return runSharedCanvasCommand();
   }
 
   // Current Figma reserves N / Shift+N for moving to the next / previous

package/corpus/templates/design/package.json

@@ -20,7 +20,6 @@
   "dependencies": {
     "@agent-native/core": "workspace:*",
     "@agent-native/creative-context": "workspace:*",
-    "@agent-native/pinpoint": "workspace:*",
     "@agent-native/toolkit": "workspace:*",
     "@fontsource-variable/inter": "^5.2.8",
     "@libsql/client": "^0.15.8",

package/corpus/templates/dispatch/AGENTS.md

@@ -54,11 +54,19 @@ ladder.
   Hosted production sources appear only when Dispatch has their
   <APP>_DATABASE_URL connection variables (or an equivalent
   AGENT_NATIVE_THREAD_DEBUG_DATABASES configuration).
+- For reliability triage, call `list-agent-run-failures` first, then inspect a
+  returned run with `get-agent-thread-debug` using the same source id. Do not
+  infer run failure from thread text search. Cross-app results may be partial;
+  preserve the returned per-source health instead of treating an unavailable
+  source as zero failures.
 
 ## Application State
 
 - `navigation` exposes current Dispatch view, selected integration/resource,
   approval, route, or settings panel.
+- On Thread Debug, `navigation.threadDebugMode`, `sourceId`,
+  `inspectSourceId`, `ownerEmail`, `failureStatus`, `range`, `query`, `runId`,
+  and `threadId` expose the visible failure or thread filters and selection.
 - `navigate` moves the UI to setup, vault, integrations, resources, routing,
   approval, and operator surfaces.
 

package/corpus/templates/dispatch/DEVELOPING.md

@@ -183,6 +183,35 @@ Real credential values belong only in local `.env` files, deployment configurati
 | `DATABASE_URL`        | Production yes, local dev no    | Persistent SQL connection string (local dev default: `file:./data/app.db`) |
 | `DATABASE_AUTH_TOKEN` | Only when the provider needs it | Auth token for providers such as Turso/libSQL                              |
 
+### Cross-app Thread Debug sources
+
+Dispatch can inspect agent runs from other apps without moving their trace data
+out of the app-owned database. Configure these connections only on the
+production Dispatch runtime, and use database credentials that are restricted
+to read-only access.
+
+For one source, set an app-prefixed URL such as
+`CLIPS_DATABASE_URL` and, when required, `CLIPS_DATABASE_AUTH_TOKEN`. For
+multiple or explicitly named sources, set `AGENT_NATIVE_THREAD_DEBUG_DATABASES`
+to JSON that refers to separate environment variable names:
+
+```json
+[
+  {
+    "id": "clips",
+    "label": "Clips",
+    "databaseUrlEnv": "DISPATCH_THREAD_DEBUG_CLIPS_DATABASE_URL",
+    "databaseAuthTokenEnv": "DISPATCH_THREAD_DEBUG_CLIPS_DATABASE_AUTH_TOKEN"
+  }
+]
+```
+
+Set the referenced values in the deployment's secret configuration. Never put
+database URLs or tokens in this file, `netlify.toml`, source code, fixtures, or
+logs. Do not grant deploy previews access to production app databases by
+default. Thread Debug reports configured-but-missing or unreadable sources
+separately from sources that returned zero failures.
+
 ## Extensions (Framework Feature)
 
 The framework provides **Extensions** — mini sandboxed Alpine.js apps that run inside iframes. Extensions let users (or the agent) create interactive widgets, dashboards, and utilities without modifying the app's source code. They appear in the sidebar under an "Extensions" section. (Distinct from LLM tools — the function-calling primitives the agent invokes.)

package/corpus/templates/dispatch/actions/view-screen.ts

@@ -18,6 +18,20 @@ function stripUndefined(args: Record<string, unknown>) {
   );
 }
 
+function threadDebugLookbackHours(value: unknown): number {
+  if (value === "7d") return 168;
+  if (value === "30d") return 720;
+  return 24;
+}
+
+function threadDebugFailureStatus(
+  value: unknown,
+): "all" | "errored" | "aborted" | "truncated" {
+  return value === "errored" || value === "aborted" || value === "truncated"
+    ? value
+    : "all";
+}
+
 function optionalTimestamp(source: object, key: string) {
   if (!Object.prototype.hasOwnProperty.call(source, key)) return undefined;
   const value = (source as Record<string, unknown>)[key];
@@ -186,7 +200,18 @@ export default defineAction({
           "list-agent-thread-sources",
           {},
         );
-        if (nav.query) {
+        if (nav.threadDebugMode !== "threads") {
+          screen.agentRunFailures = await runDispatchAction(
+            "list-agent-run-failures",
+            {
+              sourceId: nav.sourceId ?? "all",
+              ownerEmail: nav.ownerEmail,
+              status: threadDebugFailureStatus(nav.failureStatus),
+              lookbackHours: threadDebugLookbackHours(nav.range),
+              limit: 10,
+            },
+          );
+        } else if (nav.query) {
           screen.threadDebugResults = await runDispatchAction(
             "search-agent-threads",
             {
@@ -199,7 +224,10 @@ export default defineAction({
         }
         if (nav.threadId || nav.runId) {
           const detail = (await runDispatchAction("get-agent-thread-debug", {
-            sourceId: nav.sourceId,
+            sourceId:
+              nav.runId && nav.inspectSourceId
+                ? nav.inspectSourceId
+                : nav.sourceId,
             threadId: nav.runId ? undefined : nav.threadId,
             runId: nav.runId,
             ownerEmail: nav.ownerEmail,
@@ -215,6 +243,10 @@ export default defineAction({
             debug: detail.debug,
             debugRuns: detail.debugRuns?.slice(-5) ?? [],
             messages: detail.messages?.slice(-6) ?? [],
+            runs:
+              detail.runs
+                ?.slice(0, 5)
+                .map(({ events: _events, ...run }: any) => run) ?? [],
           };
         }
       } catch (error) {