@agent-native/core 0.119.3 → 0.119.5

package/corpus/templates/tasks/actions/update-inbox-item.ts

@@ -4,12 +4,14 @@ import { z } from "zod";
 import { UserInputError } from "../server/errors.js";
 import { requireUserEmail, updateInboxItem } from "../server/inbox/store.js";
 
+export const updateInboxItemSchema = z.object({
+  inboxItemId: z.string().describe("Inbox item id"),
+  title: z.string().min(1).optional().describe("New inbox item title"),
+});
+
 export default defineAction({
   description: "Update an inbox item title.",
-  schema: z.object({
-    inboxItemId: z.string().describe("Inbox item id"),
-    title: z.string().min(1).optional().describe("New inbox item title"),
-  }),
+  schema: updateInboxItemSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     if (args.title === undefined) {

package/corpus/templates/tasks/actions/update-task.ts

@@ -25,16 +25,19 @@ const fieldValuesSchema: z.ZodType<FieldValuePatch[]> = z.preprocess(
   z.array(fieldValuePatchSchema),
 );
 
+export const updateTaskSchema = z.object({
+  taskId: z.string().describe("Task id"),
+  title: z.string().min(1).optional().describe("New task title"),
+  done: z.boolean().optional().describe("Completion state"),
+  fieldValues: fieldValuesSchema
+    .optional()
+    .describe("Custom field values to set or clear for this task"),
+});
+
 export default defineAction({
-  description: "Update a task title, completion state, and/or custom fields.",
-  schema: z.object({
-    taskId: z.string().describe("Task id"),
-    title: z.string().min(1).optional().describe("New task title"),
-    done: z.boolean().optional().describe("Completion state"),
-    fieldValues: fieldValuesSchema
-      .optional()
-      .describe("Custom field values to set or clear for this task"),
-  }),
+  description:
+    "Update one task's title, completion state, and/or custom fields. Use bulk-update-tasks to apply the same title or completion state to multiple tasks.",
+  schema: updateTaskSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     if (

package/corpus/templates/tasks/actions/update-visible-task-fields.ts

@@ -5,17 +5,19 @@ import { requireUserEmail } from "../server/custom-fields/store.js";
 import { setTaskCardFieldIds } from "../server/user-config/store.js";
 import { TASK_CARD_FIELD_LIMIT } from "../shared/visible-task-fields.js";
 
+export const updateVisibleTaskFieldsSchema = z.object({
+  fieldIds: z
+    .array(z.string())
+    .max(TASK_CARD_FIELD_LIMIT)
+    .describe(
+      `Field ids to show on task cards, top-to-bottom. Max ${TASK_CARD_FIELD_LIMIT}.`,
+    ),
+});
+
 export default defineAction({
   description:
     "Replace the custom fields shown on task cards for the current user.",
-  schema: z.object({
-    fieldIds: z
-      .array(z.string())
-      .max(TASK_CARD_FIELD_LIMIT)
-      .describe(
-        `Field ids to show on task cards, top-to-bottom. Max ${TASK_CARD_FIELD_LIMIT}.`,
-      ),
-  }),
+  schema: updateVisibleTaskFieldsSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     const fieldIds = await setTaskCardFieldIds({

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

@@ -89,7 +89,7 @@ async function readParsedAppState<T>(
 
 export default defineAction({
   description:
-    "See what the user is currently looking at on screen. Returns navigation state, UI bulk selection on /tasks or /inbox when active, visible list snapshot, and selected item. Always call this first before ambiguous task or inbox edits.",
+    "Inspect the current Tasks screen. Returns navigation, visible items, the selected item, and active bulk selection.",
   schema: z.object({}),
   http: false,
   readOnly: true,

package/corpus/templates/tasks/app/components/tasks/fields/TaskFieldsSidebar.tsx

@@ -1,3 +1,4 @@
+import { ExtensionSlot } from "@agent-native/core/client/extensions";
 import { useT } from "@agent-native/core/client/i18n";
 import { useCallback } from "react";
 import { toast } from "sonner";
@@ -76,6 +77,20 @@ function TaskFieldsSidebarPanel({ task }: { task: TaskWithFields }) {
           />
         ))
       )}
+
+      {/* Stable extension contract: changing this slot id or context requires a migration. */}
+      <ExtensionSlot
+        id="tasks.task-detail.bottom"
+        context={{
+          taskId: task.id,
+          title: task.title,
+          done: task.done,
+          fieldValues: fields.map((field) => ({
+            fieldId: field.id,
+            value: field.value ?? null,
+          })),
+        }}
+      />
     </div>
   );
 }

package/corpus/templates/tasks/changelog/2026-07-23-task-detail-extensions.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-23
+---
+
+Task detail panels can now host installed extension widgets.

package/corpus/templates/tasks/drizzle.config.ts

@@ -0,0 +1,3 @@
+import { createDrizzleConfig } from "@agent-native/core/db/drizzle-config";
+
+export default createDrizzleConfig();

package/corpus/templates/tasks/package.json

@@ -12,6 +12,8 @@
     "typecheck": "agent-native typecheck",
     "action": "agent-native action",
     "script": "agent-native script",
+    "db:push": "drizzle-kit push",
+    "db:generate": "drizzle-kit generate",
     "test": "vitest --run --config vitest.config.ts",
     "test:e2e": "playwright test",
     "test:e2e:install": "playwright install chromium",
@@ -26,6 +28,7 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@libsql/client": "^0.15.8",
     "@tabler/icons-react": "catalog:",
+    "drizzle-orm": "^0.45.2",
     "h3": "^2.0.1-rc.20",
     "isbot": "^5",
     "node-pty": "^1.1.0",
@@ -78,7 +81,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "drizzle-orm": "^0.45.2",
+    "drizzle-kit": "^0.31.10",
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
     "next-themes": "^0.4.6",

package/corpus/templates/tasks/server/db/schema.ts

@@ -51,17 +51,7 @@ export const customFieldValues = table(
   }),
 );
 
-export const userConfig = table("user_config", {
-  ownerEmail: text("owner_email").primaryKey(),
-  taskCardFieldIdsJson: text("task_card_field_ids_json")
-    .notNull()
-    .default("[]"),
-  updatedAt: text("updated_at").notNull().default(now()),
-});
-
 export type StoredCustomField = typeof customFields.$inferSelect;
 export type NewCustomField = typeof customFields.$inferInsert;
 export type StoredCustomFieldValue = typeof customFieldValues.$inferSelect;
 export type NewCustomFieldValue = typeof customFieldValues.$inferInsert;
-export type StoredUserConfig = typeof userConfig.$inferSelect;
-export type NewUserConfig = typeof userConfig.$inferInsert;

package/corpus/templates/tasks/server/db/test-tasks-table.ts

@@ -51,11 +51,6 @@ CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_task
   ON custom_field_values (owner_email, task_id);
 CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_field
   ON custom_field_values (owner_email, field_id);
-CREATE TABLE IF NOT EXISTS user_config (
-  owner_email TEXT PRIMARY KEY,
-  task_card_field_ids_json TEXT NOT NULL DEFAULT '[]',
-  updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
 `;
 
 // libsql, not better-sqlite3: its sync driver lets `.run()`/`.all()`/`.get()` pass here and fail in production.

package/corpus/templates/tasks/server/plugins/agent-chat.ts

@@ -43,6 +43,6 @@ When the user asks to see, review, or manage the task list, check the current-sc
 When view-screen returns selection, treat selectedItems as the user's current UI multi-select on /tasks or /inbox.
 Prefer bulk-update-tasks and bulk-delete-tasks when the user clearly means multiple tasks (e.g. "mark these done", "delete the selected ones", or several titles at once). Use single-task actions for one task or when bulk selection is not in play.
 Prefer bulk-delete-inbox-items when the user clearly means multiple inbox items.
-Ask for confirmation before delete-task, bulk-delete-tasks, delete-inbox-item, and bulk-delete-inbox-items.
+Ask for confirmation before deleting tasks, inbox items, or custom fields.
 Do not use db-query for normal task or inbox operations.`,
 });

package/corpus/templates/tasks/server/plugins/db.ts

@@ -1,6 +1,14 @@
-import { runMigrations } from "@agent-native/core/db";
+import {
+  ensureAdditiveColumns,
+  getDbExec,
+  runMigrations,
+} from "@agent-native/core/db";
 
-export default runMigrations(
+import * as schema from "../db/schema.js";
+
+// Keep historical entries unnamed for legacy-ledger compatibility; every new
+// migration must add a stable, unique `name` slug.
+const runTasksMigrations = runMigrations(
   [
     {
       version: 1,
@@ -77,14 +85,39 @@ export default runMigrations(
       CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_field
         ON custom_field_values (owner_email, field_id)`,
     },
-    {
-      version: 8,
-      sql: `CREATE TABLE IF NOT EXISTS user_config (
-        owner_email TEXT PRIMARY KEY,
-        task_card_field_ids_json TEXT NOT NULL DEFAULT '[]',
-        updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
-      )`,
-    },
   ],
   { table: "tasks_migrations" },
 );
+
+function isDrizzleTable(value: unknown): value is object {
+  return (
+    !!value &&
+    typeof value === "object" &&
+    Object.getOwnPropertySymbols(value).some((s) =>
+      s.toString().includes("drizzle"),
+    )
+  );
+}
+
+const schemaTables = Object.values(schema).filter(isDrizzleTable);
+
+export default async (nitroApp: any): Promise<void> => {
+  await runTasksMigrations(nitroApp);
+  try {
+    const summary = await ensureAdditiveColumns({
+      db: getDbExec(),
+      tables: schemaTables,
+    });
+    if (summary.errors.length > 0) {
+      console.warn(
+        "[db] ensureAdditiveColumns completed with errors:",
+        summary.errors,
+      );
+    }
+  } catch (err) {
+    console.warn(
+      "[db] ensureAdditiveColumns failed (non-fatal):",
+      err instanceof Error ? err.message : err,
+    );
+  }
+};

package/corpus/templates/tasks/server/user-config/store.ts

@@ -1,18 +1,16 @@
-import { eq } from "drizzle-orm";
+import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
 
 import {
   DEFAULT_TASK_CARD_FIELD_NAMES,
   TASK_CARD_FIELD_LIMIT,
 } from "../../shared/visible-task-fields.js";
 import { listCustomFields } from "../custom-fields/store.js";
-import { getDb } from "../db/index.js";
-import { timestamp } from "../db/record-utils.js";
-import { userConfig } from "../db/schema.js";
-import type { DbHandle } from "../db/transaction.js";
 import { UserInputError } from "../errors.js";
 
 export { DEFAULT_TASK_CARD_FIELD_NAMES, TASK_CARD_FIELD_LIMIT };
 
+const VISIBLE_TASK_FIELDS_SETTING_KEY = "visible-task-fields";
+
 function fieldIdsForNames(
   fieldNames: readonly string[],
   fields: readonly { id: string; title: string }[],
@@ -26,16 +24,11 @@ function fieldIdsForNames(
     .slice(0, TASK_CARD_FIELD_LIMIT);
 }
 
-function parseStoredFieldIds(raw: string): string[] {
-  try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) return [];
-    return parsed
-      .filter((value): value is string => typeof value === "string")
-      .slice(0, TASK_CARD_FIELD_LIMIT);
-  } catch {
-    return [];
-  }
+function parseFieldIdsValue(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  return value
+    .filter((entry): entry is string => typeof entry === "string")
+    .slice(0, TASK_CARD_FIELD_LIMIT);
 }
 
 function dedupeFieldIds(fieldIds: readonly string[]) {
@@ -49,39 +42,34 @@ function filterKnownFieldIds(
   return fieldIds.filter((fieldId) => knownIds.has(fieldId));
 }
 
-export async function getTaskCardFieldIds(
-  input: {
-    ownerEmail: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<string[]> {
+async function readStoredFieldIds(
+  ownerEmail: string,
+): Promise<string[] | null> {
+  const setting = await getUserSetting(
+    ownerEmail,
+    VISIBLE_TASK_FIELDS_SETTING_KEY,
+  );
+  return setting ? parseFieldIdsValue(setting.fieldIds) : null;
+}
+
+export async function getTaskCardFieldIds(input: {
+  ownerEmail: string;
+}): Promise<string[]> {
   const { fields } = await listCustomFields({ ownerEmail: input.ownerEmail });
   const knownIds = new Set(fields.map((field) => field.id));
 
-  const [row] = await db
-    .select()
-    .from(userConfig)
-    .where(eq(userConfig.ownerEmail, input.ownerEmail))
-    .limit(1);
-
-  if (!row) {
+  const stored = await readStoredFieldIds(input.ownerEmail);
+  if (stored === null) {
     return fieldIdsForNames(DEFAULT_TASK_CARD_FIELD_NAMES, fields);
   }
 
-  return filterKnownFieldIds(
-    parseStoredFieldIds(row.taskCardFieldIdsJson),
-    knownIds,
-  );
+  return filterKnownFieldIds(stored, knownIds);
 }
 
-export async function setTaskCardFieldIds(
-  input: {
-    ownerEmail: string;
-    fieldIds: readonly string[];
-    now?: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<string[]> {
+export async function setTaskCardFieldIds(input: {
+  ownerEmail: string;
+  fieldIds: readonly string[];
+}): Promise<string[]> {
   const { fields } = await listCustomFields({ ownerEmail: input.ownerEmail });
   const knownIds = new Set(fields.map((field) => field.id));
   const next = dedupeFieldIds(input.fieldIds);
@@ -90,49 +78,22 @@ export async function setTaskCardFieldIds(
     throw new UserInputError("fieldIds must reference existing custom fields.");
   }
 
-  const updatedAt = timestamp(input.now);
-  const taskCardFieldIdsJson = JSON.stringify(next);
-
-  await db
-    .insert(userConfig)
-    .values({
-      ownerEmail: input.ownerEmail,
-      taskCardFieldIdsJson,
-      updatedAt,
-    })
-    .onConflictDoUpdate({
-      target: userConfig.ownerEmail,
-      set: { taskCardFieldIdsJson, updatedAt },
-    });
+  await putUserSetting(input.ownerEmail, VISIBLE_TASK_FIELDS_SETTING_KEY, {
+    fieldIds: next,
+  });
 
   return next;
 }
 
-export async function removeTaskCardFieldId(
-  input: {
-    ownerEmail: string;
-    fieldId: string;
-    now?: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<void> {
-  const [row] = await db
-    .select()
-    .from(userConfig)
-    .where(eq(userConfig.ownerEmail, input.ownerEmail))
-    .limit(1);
-
-  if (!row) return;
-
-  const next = parseStoredFieldIds(row.taskCardFieldIdsJson).filter(
-    (fieldId) => fieldId !== input.fieldId,
-  );
-
-  await db
-    .update(userConfig)
-    .set({
-      taskCardFieldIdsJson: JSON.stringify(next),
-      updatedAt: timestamp(input.now),
-    })
-    .where(eq(userConfig.ownerEmail, input.ownerEmail));
+export async function removeTaskCardFieldId(input: {
+  ownerEmail: string;
+  fieldId: string;
+}): Promise<void> {
+  const stored = await readStoredFieldIds(input.ownerEmail);
+  if (stored === null) return;
+
+  const next = stored.filter((fieldId) => fieldId !== input.fieldId);
+  await putUserSetting(input.ownerEmail, VISIBLE_TASK_FIELDS_SETTING_KEY, {
+    fieldIds: next,
+  });
 }

package/corpus/templates/tasks/tsconfig.json

@@ -19,6 +19,5 @@
     "react-router.config.ts",
     ".react-router/types/**/*",
     ".generated/**/*"
-  ],
-  "exclude": ["**/*.test.ts", "**/*.spec.ts"]
+  ]
 }

package/corpus/templates/tasks/vitest.config.ts

@@ -1,8 +1,17 @@
+import path from "node:path";
+
 import { defineConfig } from "vitest/config";
 
 export default defineConfig({
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./app"),
+      "@shared": path.resolve(__dirname, "./shared"),
+    },
+  },
   test: {
-    include: ["**/*.test.ts"],
+    include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
+    exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/e2e/**"],
     environment: "node",
   },
 });

package/corpus/toolkit/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @agent-native/toolkit
 
+## 0.10.4
+
+### Patch Changes
+
+- 4b734be: Give `SharedRichEditor` Notion-style block grips by default and keep the caret
+  inside blocks created through the shared slash-command menu.
+
+## 0.10.3
+
+### Patch Changes
+
+- 180b41d: Preserve native pointer, keyboard, accessibility, and ref props when legacy Toolkit buttons are composed as menu triggers.
+
 ## 0.10.2
 
 ### Patch Changes

package/corpus/toolkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/toolkit",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "description": "Reusable app-building UI and helpers for Agent-Native apps.",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/corpus/toolkit/src/editor/SharedRichEditor.tsx

@@ -6,6 +6,7 @@ import type { Doc as YDoc } from "yjs";
 
 import { cn } from "../utils.js";
 import { BubbleToolbar, type BubbleToolbarItem } from "./BubbleToolbar.js";
+import { DragHandle } from "./DragHandle.js";
 import {
   createSharedEditorExtensions,
   type RichMarkdownDialect,
@@ -37,6 +38,8 @@ export interface SharedRichEditorProps {
   preset?: RichMarkdownEditorPreset;
   /** Toggle individual base extensions (tables/tasks/link/codeBlock/image). */
   features?: SharedEditorFeatures;
+  /** Show the Notion-style block grip and action menu. Defaults to `true`. */
+  dragHandle?: boolean;
   /**
    * Injectable image uploader for the shared image block. Used only when
    * `features.image` is on. Pass `uploadEditorImage` (the framework
@@ -141,6 +144,7 @@ export function SharedRichEditor({
   dialect = "gfm",
   preset = "plan",
   features,
+  dragHandle = true,
   onImageUpload = null,
   extraExtensions,
   placeholder = "Type '/' for commands...",
@@ -170,6 +174,23 @@ export function SharedRichEditor({
   onChangeRef.current = onChange;
   onBlurRef.current = onBlur;
 
+  const effectiveExtraExtensions = useMemo(() => {
+    const extras = extraExtensions ?? [];
+    if (
+      !dragHandle ||
+      extras.some((extension) => extension.name === "dragHandle")
+    ) {
+      return extras;
+    }
+
+    return [
+      DragHandle.configure({
+        wrapperSelector: ".an-rich-md-wrapper",
+      }),
+      ...extras,
+    ];
+  }, [dragHandle, extraExtensions]);
+
   const extensions = useMemo(
     () =>
       createSharedEditorExtensions({
@@ -177,7 +198,7 @@ export function SharedRichEditor({
         preset,
         placeholder,
         features,
-        extraExtensions,
+        extraExtensions: effectiveExtraExtensions,
         onImageUpload,
         collab: ydoc ? { ydoc, awareness, user } : null,
         disableHistory,
@@ -192,7 +213,7 @@ export function SharedRichEditor({
       placeholder,
       preset,
       features,
-      extraExtensions,
+      effectiveExtraExtensions,
       onImageUpload,
       ydoc,
       awareness,

package/corpus/toolkit/src/editor/SlashCommandMenu.tsx

@@ -1,3 +1,4 @@
+import { TextSelection } from "@tiptap/pm/state";
 import type { Editor } from "@tiptap/react";
 import {
   useCallback,
@@ -27,6 +28,66 @@ export interface SlashCommandItem {
   action: (editor: Editor) => void;
 }
 
+/**
+ * Put the caret inside the block a slash command just created or transformed.
+ *
+ * Tiptap commands usually preserve a text selection, but commands that replace
+ * the current paragraph (notably code blocks and horizontal rules) can leave a
+ * node selection or a caret at the following block. Resolving from the slash
+ * range keeps the behavior consistent for built-in and app-provided block
+ * commands: after selecting a block, typing starts in that block immediately.
+ */
+export function focusEditorInInsertedBlock(
+  editor: Editor,
+  anchorPosition?: number,
+): void {
+  if (editor.isDestroyed) return;
+
+  const { state } = editor;
+  const anchor = Math.max(
+    1,
+    Math.min(anchorPosition ?? state.selection.from, state.doc.content.size),
+  );
+  let containingTextblock: number | null = null;
+  let nextTextblock: number | null = null;
+  let previousTextblock: number | null = null;
+
+  state.doc.nodesBetween(0, state.doc.content.size, (node, pos) => {
+    if (!node.isTextblock) return;
+
+    const start = pos + 1;
+    const end = pos + node.nodeSize - 1;
+    if (anchor >= start && anchor <= end) {
+      containingTextblock ??= anchor;
+      return;
+    }
+    if (start > anchor) {
+      if (nextTextblock === null || start < nextTextblock) {
+        nextTextblock = start;
+      }
+      return;
+    }
+    if (previousTextblock === null || start > previousTextblock) {
+      previousTextblock = Math.min(anchor, end);
+    }
+  });
+
+  const target = containingTextblock ?? nextTextblock ?? previousTextblock;
+  if (target === null) {
+    editor.commands.focus();
+    return;
+  }
+
+  const transaction = state.tr.setSelection(
+    TextSelection.create(
+      state.doc,
+      Math.max(1, Math.min(target, state.doc.content.size)),
+    ),
+  );
+  editor.view.dispatch(transaction.scrollIntoView());
+  editor.view.focus();
+}
+
 export interface SlashCommandFeatureFlags {
   tables?: boolean;
   tasks?: boolean;
@@ -192,13 +253,18 @@ export function SlashCommandMenu({
     (command: SlashCommandItem) => {
       if (slashPosRef.current !== null) {
         const { from } = editor.state.selection;
+        const anchorPosition = slashPosRef.current;
         editor
           .chain()
           .focus()
-          .deleteRange({ from: slashPosRef.current, to: from })
+          .deleteRange({ from: anchorPosition, to: from })
           .run();
+        command.action(editor);
+        focusEditorInInsertedBlock(editor, anchorPosition);
+      } else {
+        command.action(editor);
+        focusEditorInInsertedBlock(editor);
       }
-      command.action(editor);
       close();
     },
     [close, editor],

package/corpus/toolkit/src/editor/index.ts

@@ -26,6 +26,7 @@ export {
   DEFAULT_SLASH_COMMANDS,
   createImageSlashCommand,
   filterSlashCommandItems,
+  focusEditorInInsertedBlock,
   type SlashCommandItem,
   type SlashCommandMenuProps,
   type SlashCommandFeatureFlags,