@agent-native/core 0.101.14 → 0.102.1

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

@@ -0,0 +1,68 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  fieldValueInputSchema,
+  parseJsonArg,
+} from "../server/custom-fields/schema.js";
+import { listTaskFieldValues } from "../server/custom-fields/task-fields.js";
+import type { FieldValueInput } from "../server/custom-fields/values/store.js";
+import { UserInputError } from "../server/errors.js";
+import { updateTask, requireUserEmail } from "../server/tasks/store.js";
+
+type FieldValuePatch = {
+  fieldId: string;
+  value: FieldValueInput;
+};
+
+const fieldValuePatchSchema: z.ZodType<FieldValuePatch> = z.object({
+  fieldId: z.string().describe("Custom field id"),
+  value: fieldValueInputSchema.describe("Custom field value; null clears it"),
+});
+
+const fieldValuesSchema: z.ZodType<FieldValuePatch[]> = z.preprocess(
+  parseJsonArg,
+  z.array(fieldValuePatchSchema),
+);
+
+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"),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    if (
+      args.title === undefined &&
+      args.done === undefined &&
+      args.fieldValues === undefined
+    ) {
+      throw new UserInputError(
+        "Provide at least one of title, done, or fieldValues.",
+      );
+    }
+
+    const task = await updateTask({
+      ownerEmail,
+      id: args.taskId,
+      title: args.title,
+      done: args.done,
+      fieldValues: args.fieldValues,
+    });
+
+    if (args.fieldValues !== undefined) {
+      const fields = await listTaskFieldValues({
+        ownerEmail,
+        taskId: args.taskId,
+      });
+      return { ...task, fields };
+    }
+
+    return task;
+  },
+});

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

@@ -0,0 +1,27 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+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 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}.`,
+      ),
+  }),
+  run: async (args, ctx) => {
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+    const fieldIds = await setTaskCardFieldIds({
+      ownerEmail,
+      fieldIds: args.fieldIds,
+    });
+    return { fieldIds };
+  },
+});

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

@@ -0,0 +1,68 @@
+import {
+  buildAgentListSnapshot,
+  buildSelectionSnapshot,
+  resolveSelectedFromList,
+} from "../shared/list-screen-snapshot.js";
+
+export async function buildListViewScreen<
+  TItem extends { id: string },
+  TSummary,
+>(input: {
+  ownerEmail: string;
+  cap: number;
+  fetchItems: (ownerEmail: string) => Promise<TItem[]>;
+  toSummary: (item: TItem) => TSummary;
+  getById: (id: string) => Promise<TItem | null>;
+  selection?: {
+    /** Deep-link highlight from navigation (single row). */
+    highlightId?: string;
+    /** Bulk-select mode ids from app state. */
+    bulkIds?: string[];
+  };
+  resolveSelectedMiss?: (id: string) => Promise<Record<string, unknown> | null>;
+}): Promise<Record<string, unknown>> {
+  const screen: Record<string, unknown> = {};
+  const items = await input.fetchItems(input.ownerEmail);
+  const { snapshot, list } = buildAgentListSnapshot(
+    items,
+    input.cap,
+    input.toSummary,
+  );
+
+  screen.list = {
+    totalCount: list.totalCount,
+    truncated: list.truncated,
+    items: list.items,
+  };
+
+  const highlightId = input.selection?.highlightId;
+  if (highlightId) {
+    const selectedItem = await resolveSelectedFromList({
+      selectedId: highlightId,
+      items,
+      snapshot,
+      toSummary: input.toSummary,
+      getById: (id) => input.getById(id),
+      inSnapshotKey: "inListSnapshot",
+    });
+    if (selectedItem) {
+      screen.selectedItem = selectedItem;
+    } else if (input.resolveSelectedMiss) {
+      const fallback = await input.resolveSelectedMiss(highlightId);
+      if (fallback) {
+        screen.selectedItem = fallback;
+      }
+    }
+  }
+
+  const bulkIds = input.selection?.bulkIds;
+  if (bulkIds && bulkIds.length > 0) {
+    screen.selection = buildSelectionSnapshot({
+      selectedIds: bulkIds,
+      items,
+      toSummary: input.toSummary,
+    });
+  }
+
+  return screen;
+}

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

@@ -0,0 +1,207 @@
+/**
+ * See what the user is currently looking at on screen.
+ *
+ * Usage:
+ *   pnpm action view-screen
+ */
+
+import { defineAction } from "@agent-native/core/action";
+import { readAppStateForCurrentTab } from "@agent-native/core/application-state";
+import { z } from "zod";
+
+import {
+  getCustomField,
+  listCustomFields,
+  type FieldConfig,
+  type FieldDefinition,
+} from "../server/custom-fields/store.js";
+import {
+  listTaskFieldValues,
+  type TaskFieldValue,
+} from "../server/custom-fields/task-fields.js";
+import { getInboxItem, listInboxItems } from "../server/inbox/store.js";
+import { getTask, listTasks, requireUserEmail } from "../server/tasks/store.js";
+import { getTaskCardFieldIds } from "../server/user-config/store.js";
+import { buildListViewScreen } from "./view-screen-helpers.js";
+
+/** Max tasks in the agent tool payload (token budget). The UI may show more rows; */
+const AGENT_TASKS_LIST_CAP = 25;
+const AGENT_INBOX_ITEMS_LIST_CAP = 25;
+const AGENT_FIELDS_LIST_CAP = 25;
+
+type TaskSummary = { id: string; title: string; done: boolean };
+type InboxItemSummary = { id: string; title: string };
+type FieldSummary = {
+  id: string;
+  title: string;
+  type: string;
+  config: FieldConfig;
+};
+
+const navigationStateSchema = z.object({
+  view: z.string(),
+  path: z.string().optional(),
+  includeDone: z.boolean().optional(),
+  taskId: z.string().optional(),
+  inboxItemId: z.string().optional(),
+  fieldId: z.string().optional(),
+});
+
+const listSelectionStateSchema = z.object({
+  selectionMode: z.boolean(),
+  selectedIds: z.array(z.string()),
+});
+
+function toTaskSummary(task: TaskSummary): TaskSummary {
+  return { id: task.id, title: task.title, done: task.done };
+}
+
+function toInboxItemSummary(item: InboxItemSummary): InboxItemSummary {
+  return { id: item.id, title: item.title };
+}
+
+function toFieldSummary(field: FieldDefinition): FieldSummary {
+  return {
+    id: field.id,
+    title: field.title,
+    type: field.type,
+    config: field.config,
+  };
+}
+
+function toTaskFieldValueSummary(field: TaskFieldValue) {
+  return {
+    id: field.id,
+    title: field.title,
+    type: field.type,
+    value: field.value,
+  };
+}
+
+async function readParsedAppState<T>(
+  key: string,
+  schema: z.ZodType<T>,
+): Promise<T | undefined> {
+  const raw = await readAppStateForCurrentTab(key);
+  const parsed = schema.safeParse(raw);
+  return parsed.success ? parsed.data : undefined;
+}
+
+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.",
+  schema: z.object({}),
+  http: false,
+  readOnly: true,
+  run: async (_args, ctx) => {
+    const navigation = await readParsedAppState(
+      "navigation",
+      navigationStateSchema,
+    );
+
+    const screen: Record<string, unknown> = {};
+    if (navigation) screen.navigation = navigation;
+
+    const ownerEmail = requireUserEmail(ctx?.userEmail);
+
+    if (navigation?.view === "tasks") {
+      const tasksSelection = await readParsedAppState(
+        "tasksSelection",
+        listSelectionStateSchema,
+      );
+      const visibleFieldIds = await getTaskCardFieldIds({ ownerEmail });
+      Object.assign(
+        screen,
+        await buildListViewScreen({
+          ownerEmail,
+          cap: AGENT_TASKS_LIST_CAP,
+          fetchItems: (email) =>
+            listTasks({
+              ownerEmail: email,
+              includeDone: navigation.includeDone === true,
+            }),
+          toSummary: toTaskSummary,
+          getById: (id) => getTask({ ownerEmail, id }),
+          selection: {
+            highlightId: navigation.taskId,
+            bulkIds:
+              tasksSelection?.selectionMode &&
+              tasksSelection.selectedIds.length > 0
+                ? tasksSelection.selectedIds
+                : undefined,
+          },
+        }),
+      );
+      if (visibleFieldIds.length > 0) {
+        const { fields } = await listCustomFields({
+          ownerEmail,
+          fieldIds: visibleFieldIds,
+        });
+        screen.visibleTaskFields = fields.map(toFieldSummary);
+      }
+
+      if (navigation.taskId && "selectedItem" in screen) {
+        screen.selectedTaskFields = (
+          await listTaskFieldValues({
+            ownerEmail,
+            taskId: navigation.taskId,
+          })
+        ).map(toTaskFieldValueSummary);
+      }
+    }
+
+    if (navigation?.view === "inbox") {
+      const inboxSelection = await readParsedAppState(
+        "inboxSelection",
+        listSelectionStateSchema,
+      );
+      Object.assign(
+        screen,
+        await buildListViewScreen({
+          ownerEmail,
+          cap: AGENT_INBOX_ITEMS_LIST_CAP,
+          fetchItems: (email) => listInboxItems({ ownerEmail: email }),
+          toSummary: toInboxItemSummary,
+          getById: (id) => getInboxItem({ ownerEmail, id }),
+          selection: {
+            highlightId: navigation.inboxItemId,
+            bulkIds:
+              inboxSelection?.selectionMode &&
+              inboxSelection.selectedIds.length > 0
+                ? inboxSelection.selectedIds
+                : undefined,
+          },
+          resolveSelectedMiss: async (id) => {
+            const promotedTask = await getTask({ ownerEmail, id });
+            if (!promotedTask) return null;
+            return {
+              ...toTaskSummary(promotedTask),
+              inListSnapshot: false,
+              promotedFromInbox: true,
+            };
+          },
+        }),
+      );
+    }
+
+    if (navigation?.view === "fields") {
+      Object.assign(
+        screen,
+        await buildListViewScreen({
+          ownerEmail,
+          cap: AGENT_FIELDS_LIST_CAP,
+          fetchItems: async (email) =>
+            (await listCustomFields({ ownerEmail: email })).fields,
+          toSummary: toFieldSummary,
+          getById: (id) => getCustomField({ ownerEmail, fieldId: id }),
+          selection: { highlightId: navigation.fieldId },
+        }),
+      );
+    }
+
+    if (Object.keys(screen).length === 0) {
+      return "No application state found. Is the app running?";
+    }
+    return screen;
+  },
+});

package/corpus/templates/tasks/app/components/custom-fields/FieldCreateBar.tsx

@@ -0,0 +1,121 @@
+import { IconPlus } from "@tabler/icons-react";
+import { useState, type FormEvent } from "react";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import type { FieldConfig, FieldType } from "@/hooks/use-custom-fields";
+
+import { FieldConfigControl } from "./editor/config/FieldConfigControl";
+import { normalizedInitialConfig } from "./editor/config/utils";
+import type { FieldDraft } from "./editor/types";
+
+const FIELD_TYPE_OPTIONS: Array<{ value: FieldType; label: string }> = [
+  { value: "text", label: "Text" },
+  { value: "rich_text", label: "Rich text" },
+  { value: "number", label: "Number" },
+  { value: "percent", label: "Percent" },
+  { value: "currency", label: "Currency" },
+  { value: "single_select", label: "Single-select" },
+  { value: "multi_select", label: "Multi-select" },
+  { value: "date", label: "Date" },
+];
+
+const FIELD_TYPES_WITH_CONFIG = new Set<FieldType>([
+  "currency",
+  "number",
+  "percent",
+  "single_select",
+  "multi_select",
+]);
+
+export function FieldCreateBar({
+  busy,
+  onCreate,
+}: {
+  busy: boolean;
+  onCreate: (draft: FieldDraft) => Promise<void>;
+}) {
+  const [title, setTitle] = useState("");
+  const [type, setType] = useState<FieldType>("text");
+  const [config, setConfig] = useState<FieldConfig>(
+    normalizedInitialConfig("text"),
+  );
+
+  function handleTypeChange(nextType: FieldType) {
+    setType(nextType);
+    setConfig(normalizedInitialConfig(nextType));
+  }
+
+  async function handleSubmit(event: FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    const trimmedTitle = title.trim();
+    if (!trimmedTitle) return;
+
+    await onCreate({ title: trimmedTitle, type, config });
+    setTitle("");
+    setType("text");
+    setConfig(normalizedInitialConfig("text"));
+  }
+
+  return (
+    <form
+      onSubmit={(event) => void handleSubmit(event)}
+      className="grid shrink-0 gap-3 rounded-lg border border-border bg-card p-3 md:grid-cols-[minmax(180px,1fr)_180px_auto] md:items-start"
+    >
+      <h2 className="text-sm font-medium md:col-span-3">Create new field</h2>
+      <div className="grid gap-2">
+        <Label htmlFor="new-field-title" className="sr-only">
+          Field title
+        </Label>
+        <Input
+          id="new-field-title"
+          value={title}
+          disabled={busy}
+          placeholder="New field title"
+          onChange={(event) => setTitle(event.currentTarget.value)}
+        />
+      </div>
+      <Select
+        value={type}
+        disabled={busy}
+        onValueChange={(value) => handleTypeChange(value as FieldType)}
+      >
+        <SelectTrigger aria-label="Field type">
+          <SelectValue />
+        </SelectTrigger>
+        <SelectContent>
+          <SelectGroup>
+            {FIELD_TYPE_OPTIONS.map((option) => (
+              <SelectItem key={option.value} value={option.value}>
+                {option.label}
+              </SelectItem>
+            ))}
+          </SelectGroup>
+        </SelectContent>
+      </Select>
+      <Button type="submit" disabled={busy || title.trim().length === 0}>
+        <IconPlus className="size-4" />
+        Create
+      </Button>
+      {FIELD_TYPES_WITH_CONFIG.has(type) ? (
+        <div className="md:col-span-3">
+          <FieldConfigControl
+            type={type}
+            config={config}
+            disabled={busy}
+            onChange={setConfig}
+          />
+        </div>
+      ) : null}
+    </form>
+  );
+}

package/corpus/templates/tasks/app/components/custom-fields/FieldListRow.tsx

@@ -0,0 +1,116 @@
+import { IconTrash } from "@tabler/icons-react";
+
+import type { SortableItemRenderProps } from "@/components/dnd/SortableItem";
+import { ListRow } from "@/components/shared/list/ListRow";
+import { ListRowDragHandle } from "@/components/shared/list/ListRowDragHandle";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import type { FieldDefinition, FieldType } from "@/hooks/use-custom-fields";
+
+const FIELD_TYPE_LABELS: Record<FieldType, string> = {
+  text: "Text",
+  rich_text: "Rich text",
+  number: "Number",
+  percent: "Percent",
+  currency: "Currency",
+  single_select: "Single-select",
+  multi_select: "Multi-select",
+  date: "Date",
+};
+
+function fieldTypeLabel(type: FieldType) {
+  return FIELD_TYPE_LABELS[type] ?? type;
+}
+
+function fieldDescription(field: FieldDefinition) {
+  if (field.type === "currency") return `Currency ${field.config.symbol}`;
+  if (field.type === "number") {
+    const parts: string[] = [];
+    parts.push(`${field.config.precision ?? 0} decimals`);
+    if (field.config.positiveOnly) parts.push("positive only");
+    return parts.join(" · ");
+  }
+  if (field.type === "percent") {
+    return `${field.config.precision ?? 0} decimals`;
+  }
+  if (field.type === "single_select" || field.type === "multi_select") {
+    const options = "options" in field.config ? field.config.options : [];
+    return `${options.length} options`;
+  }
+  return fieldTypeLabel(field.type);
+}
+
+function FieldRowMetadata({ field }: { field: FieldDefinition }) {
+  return (
+    <div className="flex min-w-0 flex-wrap items-center justify-end gap-1.5">
+      <Badge variant="secondary" className="px-1.5 py-0 text-xs font-normal">
+        {fieldTypeLabel(field.type)}
+      </Badge>
+      <span className="truncate text-xs text-muted-foreground">
+        {fieldDescription(field)}
+      </span>
+    </div>
+  );
+}
+
+export interface FieldListRowProps {
+  sortable: SortableItemRenderProps;
+  item: FieldDefinition;
+  highlighted?: boolean;
+  onOpenDetails: () => void;
+  onRequestDelete: () => void;
+}
+
+export function FieldListRow({
+  sortable,
+  item,
+  highlighted = false,
+  onOpenDetails,
+  onRequestDelete,
+}: FieldListRowProps) {
+  return (
+    <ListRow
+      sortable={sortable}
+      item={item}
+      itemLabel={item.title}
+      highlighted={highlighted}
+      onActivate={onOpenDetails}
+      dataAttributes={{ "data-field-id": item.id }}
+    >
+      {({ rowDrag, rowSelection }) => (
+        <>
+          <ListRowDragHandle
+            rowDrag={rowDrag}
+            rowSelection={rowSelection}
+            displayTitle={item.title}
+          />
+
+          <div className="min-w-0 flex-1">
+            <div className="flex h-8 min-w-0 items-center truncate text-sm font-medium">
+              {item.title}
+            </div>
+          </div>
+
+          <div className="min-w-0 shrink-0">
+            <FieldRowMetadata field={item} />
+          </div>
+
+          <Button
+            type="button"
+            variant="ghost"
+            size="icon"
+            aria-label={`Delete ${item.title}`}
+            onPointerDown={(event) => event.stopPropagation()}
+            onClick={(event) => {
+              event.stopPropagation();
+              onRequestDelete();
+            }}
+            className="relative z-10 size-8 text-muted-foreground hover:bg-destructive/10 hover:text-destructive"
+          >
+            <IconTrash />
+          </Button>
+        </>
+      )}
+    </ListRow>
+  );
+}