@agent-native/core 0.101.14 → 0.102.1

package/corpus/templates/tasks/README.md

@@ -0,0 +1,16 @@
+# agent-native-tasks
+
+Task-list-first agent-native app. Default home is `/tasks`; chat handles capture and agent operations.
+
+## TODO
+
+- [ ] **i18n** — Add `app/i18n/` catalogs (`en-US` + locale mirrors) and migrate UI copy from raw literals to `useT()`. Remove tasks strings from `scripts/i18n-raw-literal-baseline.txt` once migrated.
+- [ ] **Delete dialog wiring** — `TaskList` and `InboxList` duplicate single/bulk delete dialog state (`pendingDeleteId`, `bulkDeleteOpen`, confirm handlers, toast on bulk success). Extract a shared hook or composer helper (e.g. `useDeleteDialogs`) that owns pending id, open state, and confirm wiring while composers pass entity labels and delete mutations.
+- [ ] Extract shared action schema helpers (e.g. `taskId` field, title patch) once the action surface grows beyond MVP.
+- [ ] Add route-level `ErrorBoundary` and `Suspense` around task list loading (align with other agent-native templates).
+- [ ] **`view-screen` agent snapshot** — Revisit `AGENT_TASKS_LIST_CAP` in `actions/view-screen.ts`: it caps the agent tool payload (token budget), not the UI list. Confirm whether `list` / `selectedItem` / `inListSnapshot` correctly represent what the user sees, tune or document the cap, and align with UI limits if needed. Also review Zod parsing of `navigation` / app-state selection keys for strictness vs backward compatibility.
+- [ ] **Selection context** — Revisit prop drilling through `TaskList` → header/bar/rows once the composer stabilizes; a narrow context for `{ state, actions }` would trim wiring but must not blur the `dnd/` ↔ `selection/` boundary.
+- [ ] **`TaskList` optimistic state** — Refactor manual `allTasks` buffer in `app/components/tasks/TaskList.tsx` to TanStack Query `onMutate` once exit animations and reorder rollback can share one cache strategy.
+- [ ] **Exit-animation list reconcile** — Move exit-animation reconcile / `exitingIdsRef` out of `app/components/tasks/TaskList.tsx` into a neutral list helper (e.g. `use-ordered-tasks-with-exit-animation.ts`). That logic keeps completed rows visible during CSS exit when Show all is off; it is not DnD. `TaskList` should pass an ordered list into generic `SortableList`.
+- Shared `ListRowPreview` (`app/components/shared/dnd/ListRowPreview.tsx`) still duplicates row chrome; render the live row in the overlay when `SortableList` can mount previews safely (see TODO in that file).
+- [ ] **`move-tasks` / relative reorder (try on a separate branch)** — Today DnD persistence is FE-heavy: `SortableList` runs `reorderMovingItems` (`app/components/dnd/reorder-moving-items.ts`) to compute the **full visible id list**, then `TaskList` calls `reorder-tasks` with every id top-to-bottom. The BE already persists order via `server/tasks/store.ts` `reorderTasks` — no separate `bulkReorder` needed, but the **drop → order** translation is brittle (multi-select before/after/top/bottom edge cases). **Proposal:** add a relative move action, e.g. `move-tasks` with `{ taskIds, beforeId? | afterId?, includeDone? }` (or extend `reorder-tasks` with a relative mode). BE applies the block move, validates visible list / ownership, rewrites `sortOrder`, returns updated tasks. Keep **absolute** full-list `taskIds[]` as an escape hatch for agent/import flows. **FE after refactor:** dnd-kit still handles overlay/collision/optimistic UI, but on drop only derives `{ selected ids, anchor id, before | after }` from `over` + drag direction — delete most of `computeBlockInsertIndex`. **Prefer `beforeId`/`afterId` over `toIndex`** — matches user/agent language (“put these after task Z”) and avoids index ambiguity with `includeDone` / hidden rows. **Touch:** new `actions/move-tasks.ts`, `server/tasks/store.ts`, `use-tasks.ts`, `TaskList.tsx` / `InboxList.tsx`, agent prompt in `server/plugins/agent-chat.ts`, unit tests on store + thin FE mapping tests; keep `reorder-tasks` until callers migrate.

package/corpus/templates/tasks/actions/bulk-delete-inbox-items.ts

@@ -0,0 +1,24 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { deleteInboxItems, requireUserEmail } from "../server/inbox/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Delete multiple inbox items permanently. Ask the user to confirm before calling.",
+  schema: z.object({
+    inboxItemIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Inbox item ids to delete"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return deleteInboxItems({
+      ownerEmail,
+      ids: args.inboxItemIds,
+    });
+  },
+});

package/corpus/templates/tasks/actions/bulk-delete-tasks.ts

@@ -0,0 +1,21 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { deleteTasks, requireUserEmail } from "../server/tasks/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Delete multiple tasks permanently. Ask the user to confirm before calling.",
+  schema: z.object({
+    taskIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Task ids to delete"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return deleteTasks({ ownerEmail, ids: args.taskIds });
+  },
+});

package/corpus/templates/tasks/actions/bulk-mark-inbox-items-ready.ts

@@ -0,0 +1,27 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  markInboxItemsReady,
+  requireUserEmail,
+} from "../server/inbox/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Promote multiple inbox items to incomplete tasks in one atomic batch.",
+  schema: z.object({
+    inboxItemIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Inbox item ids to mark ready"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return markInboxItemsReady({
+      ownerEmail,
+      ids: args.inboxItemIds,
+    });
+  },
+});

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

@@ -0,0 +1,35 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { UserInputError } from "../server/errors.js";
+import { requireUserEmail, updateTasks } from "../server/tasks/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Update multiple tasks with the same title and/or completion patch.",
+  schema: z.object({
+    taskIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Task ids to update"),
+    title: z.string().min(1).optional().describe("New title for every task"),
+    done: z.boolean().optional().describe("Completion state for every task"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    if (args.title === undefined && args.done === undefined) {
+      throw new UserInputError("Provide at least one of title or done.");
+    }
+
+    const tasks = await updateTasks({
+      ownerEmail,
+      ids: args.taskIds,
+      title: args.title,
+      done: args.done,
+    });
+
+    return { tasks };
+  },
+});

package/corpus/templates/tasks/actions/create-custom-field.ts

@@ -0,0 +1,22 @@
+import { defineAction } from "@agent-native/core/action";
+
+import { createCustomFieldActionSchema } from "../server/custom-fields/schema.js";
+import {
+  createCustomField,
+  requireUserEmail,
+} from "../server/custom-fields/store.js";
+
+export default defineAction({
+  description:
+    "Create a custom field definition. Field type is immutable after creation.",
+  schema: createCustomFieldActionSchema,
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return createCustomField({
+      ownerEmail,
+      title: args.title,
+      type: args.type,
+      config: args.config,
+    });
+  },
+});

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

@@ -0,0 +1,30 @@
+import { defineAction } from "@agent-native/core/action";
+import { buildDeepLink } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { createInboxItem, requireUserEmail } from "../server/inbox/store.js";
+import type { InboxItem } from "../server/inbox/store.js";
+
+export default defineAction({
+  description: "Create a not-ready inbox item with a title.",
+  schema: z.object({
+    title: z.string().min(1).describe("Inbox item title"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const item = await createInboxItem({ ownerEmail, title: args.title });
+    return item;
+  },
+  link: ({ result }) => {
+    if (!result || typeof result !== "object") return null;
+    const item = result as InboxItem;
+    if (!item.id || !item.title) return null;
+    return {
+      url: buildDeepLink({
+        view: "inbox",
+        params: { inboxItemId: item.id },
+      }),
+      label: item.title,
+    };
+  },
+});

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

@@ -0,0 +1,33 @@
+import { defineAction } from "@agent-native/core/action";
+import { buildDeepLink } from "@agent-native/core/server";
+import { z } from "zod";
+
+import {
+  createTask,
+  requireUserEmail,
+  type Task,
+} from "../server/tasks/store.js";
+
+export default defineAction({
+  description: "Create a new task with a title.",
+  schema: z.object({
+    title: z.string().min(1).describe("Task title"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const task = await createTask({ ownerEmail, title: args.title });
+    return task;
+  },
+  link: ({ result }) => {
+    if (!result || typeof result !== "object") return null;
+    const task = result as Task;
+    if (!task.id || !task.title) return null;
+    return {
+      url: buildDeepLink({
+        view: "tasks",
+        params: { taskId: task.id },
+      }),
+      label: task.title,
+    };
+  },
+});

package/corpus/templates/tasks/actions/delete-custom-field.ts

@@ -0,0 +1,19 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  deleteCustomField,
+  requireUserEmail,
+} from "../server/custom-fields/store.js";
+
+export default defineAction({
+  description:
+    "Delete a custom field definition and all of its values on every task. Ask the user to confirm before calling.",
+  schema: z.object({
+    fieldId: z.string().describe("Custom field id"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return deleteCustomField({ ownerEmail, fieldId: args.fieldId });
+  },
+});

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

@@ -0,0 +1,17 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { deleteInboxItem, requireUserEmail } from "../server/inbox/store.js";
+
+export default defineAction({
+  description:
+    "Delete an inbox item permanently. Ask the user to confirm before calling.",
+  schema: z.object({
+    inboxItemId: z.string().describe("Inbox item id"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    await deleteInboxItem({ ownerEmail, id: args.inboxItemId });
+    return { ok: true as const };
+  },
+});

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

@@ -0,0 +1,17 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { deleteTask, requireUserEmail } from "../server/tasks/store.js";
+
+export default defineAction({
+  description:
+    "Delete a task permanently. Ask the user to confirm before calling.",
+  schema: z.object({
+    taskId: z.string().describe("Task id"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    await deleteTask({ ownerEmail, id: args.taskId });
+    return { ok: true as const };
+  },
+});

package/corpus/templates/tasks/actions/lib/boolean-query-param.ts

@@ -0,0 +1,30 @@
+/**
+ * HTTP GET actions and CLI flags pass booleans as strings ("true"/"false"),
+ * not JSON booleans. Plain z.boolean() rejects those values before run().
+ */
+import { z } from "zod";
+
+import { coerceBooleanParam } from "../../shared/boolean-param.js";
+
+const booleanQueryValue = z.union([
+  z.boolean(),
+  z.enum(["true", "false", "1", "0"]),
+]);
+
+/** Required boolean query param with a default when omitted. */
+export function booleanQueryParam(defaultValue = false) {
+  return booleanQueryValue
+    .optional()
+    .transform((value) => coerceBooleanParam(value) ?? defaultValue)
+    .default(defaultValue);
+}
+
+/**
+ * Optional boolean query param that stays undefined when omitted.
+ * Used by navigate when includeDone should not be patched unless provided.
+ */
+export function optionalBooleanQueryParam() {
+  return booleanQueryValue
+    .optional()
+    .transform((value) => coerceBooleanParam(value));
+}

package/corpus/templates/tasks/actions/list-custom-fields.ts

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  listCustomFields,
+  requireUserEmail,
+} from "../server/custom-fields/store.js";
+
+export default defineAction({
+  description: "List custom field definitions for the current user.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (_args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return listCustomFields({ ownerEmail });
+  },
+});

package/corpus/templates/tasks/actions/list-inbox-items.ts

@@ -0,0 +1,16 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { listInboxItems, requireUserEmail } from "../server/inbox/store.js";
+
+export default defineAction({
+  description: "List inbox items for the current user (not-ready capture).",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (_args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const items = await listInboxItems({ ownerEmail });
+    return { items };
+  },
+});

package/corpus/templates/tasks/actions/list-tasks.ts

@@ -0,0 +1,52 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { attachFieldsToTasks } from "../server/custom-fields/task-fields.js";
+import {
+  hasCompletedTasks,
+  listTasks,
+  requireUserEmail,
+} from "../server/tasks/store.js";
+import { booleanQueryParam } from "./lib/boolean-query-param.js";
+
+export default defineAction({
+  description:
+    "List tasks for the current user. By default returns incomplete tasks only.",
+  schema: z.object({
+    includeDone: booleanQueryParam(false).describe(
+      "When true, include completed tasks in the result.",
+    ),
+    includeFields: booleanQueryParam(false).describe(
+      "When true, include each task's custom field values.",
+    ),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const tasks = await listTasks({
+      ownerEmail,
+      includeDone: args.includeDone,
+    });
+    const hasCompleted =
+      args.includeDone === true
+        ? undefined
+        : tasks.length === 0
+          ? await hasCompletedTasks({ ownerEmail })
+          : false;
+    if (args.includeFields) {
+      return {
+        tasks: await attachFieldsToTasks(ownerEmail, tasks),
+        ...(hasCompleted !== undefined
+          ? { hasCompletedTasks: hasCompleted }
+          : {}),
+      };
+    }
+    return {
+      tasks,
+      ...(hasCompleted !== undefined
+        ? { hasCompletedTasks: hasCompleted }
+        : {}),
+    };
+  },
+});

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

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { requireUserEmail } from "../server/custom-fields/store.js";
+import { getTaskCardFieldIds } from "../server/user-config/store.js";
+
+export default defineAction({
+  description:
+    "List custom field ids currently shown on task cards for the current user.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async (_args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const fieldIds = await getTaskCardFieldIds({ ownerEmail });
+    return { fieldIds };
+  },
+});

package/corpus/templates/tasks/actions/mark-inbox-item-ready.ts

@@ -0,0 +1,31 @@
+import { defineAction } from "@agent-native/core/action";
+import { buildDeepLink } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { markInboxItemReady, requireUserEmail } from "../server/inbox/store.js";
+import type { Task } from "../server/tasks/store.js";
+
+export default defineAction({
+  description:
+    "Mark an inbox item ready: promotes the inbox item to an incomplete task (same id).",
+  schema: z.object({
+    inboxItemId: z.string().describe("Inbox item id"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return markInboxItemReady({ ownerEmail, id: args.inboxItemId });
+  },
+  link: ({ result }) => {
+    if (!result || typeof result !== "object") return null;
+    const payload = result as { task?: Task };
+    const task = payload.task;
+    if (!task?.id || !task.title) return null;
+    return {
+      url: buildDeepLink({
+        view: "tasks",
+        params: { taskId: task.id },
+      }),
+      label: task.title,
+    };
+  },
+});

package/corpus/templates/tasks/actions/navigate.ts

@@ -0,0 +1,51 @@
+/**
+ * Navigate the UI to a view.
+ *
+ * Usage:
+ *   pnpm action navigate --view=tasks
+ *   pnpm action navigate --view=tasks --includeDone=true
+ *   pnpm action navigate --view=tasks --taskId=<id>
+ *   pnpm action navigate --view=fields
+ */
+
+import { defineAction } from "@agent-native/core/action";
+import { writeAppStateForCurrentTab } from "@agent-native/core/application-state";
+import { z } from "zod";
+
+import {
+  NAV_VIEW_INPUTS,
+  pathForView,
+  resolveNavView,
+} from "../shared/navigation.js";
+import { optionalBooleanQueryParam } from "./lib/boolean-query-param.js";
+
+const viewSchema = z.enum(NAV_VIEW_INPUTS);
+
+export default defineAction({
+  description:
+    "Navigate the UI to a specific view. Writes a navigate command to application state which the UI reads and auto-deletes.",
+  schema: z.object({
+    view: viewSchema.describe(
+      "View name to navigate to; home and ask are aliases for tasks",
+    ),
+    taskId: z.string().optional().describe("Selected task id on /tasks"),
+    fieldId: z
+      .string()
+      .optional()
+      .describe("Selected custom field id on /fields"),
+    includeDone: optionalBooleanQueryParam().describe(
+      "When true, show completed tasks on /tasks",
+    ),
+  }),
+  http: false,
+  run: async (args) => {
+    const view = resolveNavView(args.view);
+    const nav: Record<string, string | boolean> = { view };
+    if (args.taskId) nav.taskId = args.taskId;
+    if (args.fieldId) nav.fieldId = args.fieldId;
+    if (args.includeDone !== undefined) nav.includeDone = args.includeDone;
+    nav._writeId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    await writeAppStateForCurrentTab("navigate", nav);
+    return `Navigating to ${pathForView(view)}`;
+  },
+});

package/corpus/templates/tasks/actions/reorder-custom-fields.ts

@@ -0,0 +1,27 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  reorderCustomFields,
+  requireUserEmail,
+} from "../server/custom-fields/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Reorder custom field definitions by passing field ids top-to-bottom.",
+  schema: z.object({
+    fieldIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Field ids in the desired order from top to bottom."),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return reorderCustomFields({
+      ownerEmail,
+      fieldIds: args.fieldIds,
+    });
+  },
+});

package/corpus/templates/tasks/actions/reorder-inbox-items.ts

@@ -0,0 +1,24 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { reorderInboxItems, requireUserEmail } from "../server/inbox/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+
+export default defineAction({
+  description:
+    "Reorder the inbox list by passing inbox item ids top-to-bottom.",
+  schema: z.object({
+    inboxItemIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Inbox item ids in the desired order from top to bottom."),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return reorderInboxItems({
+      ownerEmail,
+      inboxItemIds: args.inboxItemIds,
+    });
+  },
+});

package/corpus/templates/tasks/actions/reorder-tasks.ts

@@ -0,0 +1,29 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { reorderTasks, requireUserEmail } from "../server/tasks/store.js";
+import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
+import { booleanQueryParam } from "./lib/boolean-query-param.js";
+
+export default defineAction({
+  description:
+    "Reorder the visible task list by passing task ids top-to-bottom. Use the same includeDone flag as the current list filter.",
+  schema: z.object({
+    taskIds: z
+      .array(z.string())
+      .min(1)
+      .max(BULK_ID_LIMIT)
+      .describe("Task ids in the desired order from top to bottom."),
+    includeDone: booleanQueryParam(false).describe(
+      "When true, reorder the show-all list including completed tasks.",
+    ),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    return reorderTasks({
+      ownerEmail,
+      taskIds: args.taskIds,
+      includeDone: args.includeDone,
+    });
+  },
+});

package/corpus/templates/tasks/actions/run.ts

@@ -0,0 +1,2 @@
+import { runScript } from "@agent-native/core/scripts";
+runScript();

package/corpus/templates/tasks/actions/update-custom-field.ts

@@ -0,0 +1,33 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { updateCustomFieldConfigActionSchema } from "../server/custom-fields/schema.js";
+import {
+  requireUserEmail,
+  updateCustomField,
+} from "../server/custom-fields/store.js";
+import { UserInputError } from "../server/errors.js";
+
+export default defineAction({
+  description:
+    "Rename or reconfigure a custom field definition. The field type cannot change.",
+  schema: z.object({
+    fieldId: z.string().describe("Custom field id"),
+    title: z.string().min(1).optional().describe("New field title"),
+    config: updateCustomFieldConfigActionSchema
+      .optional()
+      .describe("Type-compatible field configuration"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    if (args.title === undefined && args.config === undefined) {
+      throw new UserInputError("Provide title or config.");
+    }
+    return updateCustomField({
+      ownerEmail,
+      fieldId: args.fieldId,
+      title: args.title,
+      config: args.config,
+    });
+  },
+});

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

@@ -0,0 +1,24 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { UserInputError } from "../server/errors.js";
+import { requireUserEmail, updateInboxItem } from "../server/inbox/store.js";
+
+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"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    if (args.title === undefined) {
+      throw new UserInputError("Provide title to update.");
+    }
+    return updateInboxItem({
+      ownerEmail,
+      id: args.inboxItemId,
+      title: args.title,
+    });
+  },
+});