npm - @agent-native/core - Versions diffs - 0.101.14 → 0.102.1 - Mend

@agent-native/core 0.101.14 → 0.102.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (316) hide show

package/corpus/templates/tasks/app/root.tsx ADDED Viewed

@@ -0,0 +1,130 @@
+import { useDbSync } from "@agent-native/core/client";
+import {
+  AppProviders,
+  CommandMenu,
+  appPath,
+  configureTracking,
+  createAgentNativeQueryClient,
+  getThemeInitScript,
+  useCommandMenuShortcut,
+} from "@agent-native/core/client";
+import { IconSun, IconMoon } from "@tabler/icons-react";
+import { useQueryClient } from "@tanstack/react-query";
+import { useTheme } from "next-themes";
+import { useCallback, useState } from "react";
+import { Links, Meta, Outlet, Scripts, ScrollRestoration } from "react-router";
+import type { LinksFunction } from "react-router";
+import { Layout as AppLayout } from "@/components/layout/Layout";
+import { Toaster } from "@/components/ui/sonner";
+import { useNavigationState } from "@/hooks/use-navigation-state";
+import { APP_TITLE } from "@/lib/app-config";
+import { TAB_ID } from "@/lib/tab-id";
+import stylesheet from "./global.css?url";
+configureTracking({
+  getDefaultProps: (_name, properties) => ({
+    ...properties,
+    app: "tasks",
+    template: "tasks",
+  }),
+});
+export const links: LinksFunction = () => [
+  { rel: "stylesheet", href: stylesheet },
+];
+const THEME_INIT_SCRIPT = getThemeInitScript();
+export function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <meta charSet="utf-8" />
+        <meta
+          name="viewport"
+          content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"
+        />
+        <script
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{ __html: THEME_INIT_SCRIPT }}
+        />
+        <link rel="manifest" href={appPath("/manifest.json")} />
+        <meta name="theme-color" content="#18181B" />
+        <meta name="mobile-web-app-capable" content="yes" />
+        <meta
+          name="apple-mobile-web-app-status-bar-style"
+          content="black-translucent"
+        />
+        <meta name="apple-mobile-web-app-title" content={APP_TITLE} />
+        <link rel="icon" type="image/svg+xml" href={appPath("/favicon.svg")} />
+        <link rel="apple-touch-icon" href={appPath("/icon-180.svg")} />
+        <Meta />
+        <Links />
+      </head>
+      <body>
+        {children}
+        <ScrollRestoration />
+        <Scripts />
+      </body>
+    </html>
+  );
+}
+function DbSyncSetup() {
+  const qc = useQueryClient();
+  useNavigationState();
+  useDbSync({
+    queryClient: qc,
+    ignoreSource: TAB_ID,
+  });
+  return null;
+}
+function ThemeToggleItem() {
+  const { resolvedTheme, setTheme } = useTheme();
+  const isDark = resolvedTheme === "dark";
+  return (
+    <CommandMenu.Item
+      onSelect={() => setTheme(isDark ? "light" : "dark")}
+      keywords={["theme", "dark", "light", "mode"]}
+    >
+      {isDark ? <IconSun size={16} /> : <IconMoon size={16} />}
+      Toggle {isDark ? "light" : "dark"} mode
+    </CommandMenu.Item>
+  );
+}
+function AppContent() {
+  const [cmdkOpen, setCmdkOpen] = useState(false);
+  useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
+  return (
+    <>
+      <CommandMenu open={cmdkOpen} onOpenChange={setCmdkOpen}>
+        <CommandMenu.Group heading="Actions">
+          <CommandMenu.Item onSelect={() => {}}>Search</CommandMenu.Item>
+        </CommandMenu.Group>
+        <CommandMenu.Group heading="Appearance">
+          <ThemeToggleItem />
+        </CommandMenu.Group>
+      </CommandMenu>
+      <Toaster position="bottom-left" />
+      <AppLayout>
+        <Outlet />
+      </AppLayout>
+    </>
+  );
+}
+export default function Root() {
+  const [queryClient] = useState(() => createAgentNativeQueryClient());
+  return (
+    <AppProviders queryClient={queryClient}>
+      <DbSyncSetup />
+      <AppContent />
+    </AppProviders>
+  );
+}
+export { ErrorBoundary } from "@agent-native/core/client";

package/corpus/templates/tasks/app/routes/_index.tsx ADDED Viewed

@@ -0,0 +1,22 @@
+import { redirect } from "react-router";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [
+    { title: APP_TITLE },
+    {
+      name: "description",
+      content:
+        "Redirect to the task list home for this agent-native tasks app.",
+    },
+  ];
+}
+export function loader() {
+  return redirect("/tasks");
+}
+export default function IndexRedirect() {
+  return null;
+}

package/corpus/templates/tasks/app/routes/extensions.$id.$slug.tsx ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from "./extensions.$id";
2	+ export { default } from "./extensions.$id";

package/corpus/templates/tasks/app/routes/extensions.$id.tsx ADDED Viewed

@@ -0,0 +1,11 @@
+import { ExtensionViewerPage } from "@agent-native/core/client/extensions";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [{ title: `Extension — ${APP_TITLE}` }];
+}
+export default function ExtensionViewerRoute() {
+  return <ExtensionViewerPage />;
+}

package/corpus/templates/tasks/app/routes/extensions._index.tsx ADDED Viewed

@@ -0,0 +1,11 @@
+import { ExtensionsListPage } from "@agent-native/core/client/extensions";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [{ title: `Extensions — ${APP_TITLE}` }];
+}
+export default function ExtensionsRoute() {
+  return <ExtensionsListPage />;
+}

package/corpus/templates/tasks/app/routes/extensions.tsx ADDED Viewed

@@ -0,0 +1,5 @@
+import { Outlet } from "react-router";
+export default function ExtensionsLayout() {
+  return <Outlet />;
+}

package/corpus/templates/tasks/app/routes/fields.tsx ADDED Viewed

@@ -0,0 +1,16 @@
+import { FieldsPage } from "@/components/custom-fields/FieldsPage";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [
+    { title: `Fields · ${APP_TITLE}` },
+    {
+      name: "description",
+      content: "Define reusable custom fields for tasks.",
+    },
+  ];
+}
+export default function FieldsRoute() {
+  return <FieldsPage />;
+}

package/corpus/templates/tasks/app/routes/inbox.tsx ADDED Viewed

@@ -0,0 +1,16 @@
+import { InboxListPage } from "@/components/inbox/InboxListPage";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [
+    { title: `Inbox · ${APP_TITLE}` },
+    {
+      name: "description",
+      content: "Capture rough ideas in the inbox before they become tasks.",
+    },
+  ];
+}
+export default function InboxRoute() {
+  return <InboxListPage />;
+}

package/corpus/templates/tasks/app/routes/tasks.tsx ADDED Viewed

@@ -0,0 +1,17 @@
+import { TaskListPage } from "@/components/tasks/TaskListPage";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [
+    { title: `Tasks · ${APP_TITLE}` },
+    {
+      name: "description",
+      content:
+        "Manage tasks, reorder by drag-and-drop, and ask chat to add or update reminders.",
+    },
+  ];
+}
+export default function TasksRoute() {
+  return <TaskListPage />;
+}

package/corpus/templates/tasks/app/routes/team.tsx ADDED Viewed

@@ -0,0 +1,17 @@
+import { TeamPage } from "@agent-native/core/client/org";
+import { useSetPageTitle } from "@/components/layout/HeaderActions";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [{ title: `Team — ${APP_TITLE}` }];
+}
+export default function TeamRoute() {
+  useSetPageTitle("Team");
+  return (
+    <main className="mx-auto w-full max-w-3xl px-4 py-6 sm:px-6 sm:py-10">
+      <TeamPage createOrgDescription="Set up a team to share this app with your colleagues." />
+    </main>
+  );
+}

package/corpus/templates/tasks/app/routes.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { type RouteConfig } from "@react-router/dev/routes";
+import { flatRoutes } from "@react-router/fs-routes";
+export default flatRoutes() satisfies RouteConfig;

package/corpus/templates/tasks/app/vite-env.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+/// <reference types="vite/client" />
+declare module "react-dom/server.browser" {
+  export * from "react-dom/server";
+  export { default } from "react-dom/server";
+}

package/corpus/templates/tasks/components.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/global.css",
+    "baseColor": "slate",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/corpus/templates/tasks/data/sync-config.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ { "patterns": ["data/*/.json"] }

package/corpus/templates/tasks/docs/features/README.md ADDED Viewed

@@ -0,0 +1,81 @@
+# Tasks — Features
+This folder describes **what the Tasks app is** — its product capabilities, not implementation plans.
+Features are **ordered** (F1, F2, …). Read in order when learning the product.
+## Shipped core
+The app is **task-list-first** with agent parity:
+- **Tasks** (F1) — add, edit title, mark complete / incomplete, delete, **filter completed**, **drag reorder** on the main task page
+- **Inbox** (F4) — capture, edit, reorder, select, mark ready, delete
+- **Chat** (F8) — task and inbox operations via actions; **capture defaults to inbox** (`create-inbox-item`)
+See the repository [README](../../README.md) for implementation backlog items.
+## Where work lives
+| Surface                                  | What appears there                                       | Status  |
+| ---------------------------------------- | -------------------------------------------------------- | ------- |
+| **Main task page**                       | All **tasks**                                            | done    |
+| **[F4 Inbox](./f4-inbox.mdx)**           | Not-ready **items** — capture and triage (not tasks yet) | partial |
+| **[F3 Project](./f3-projects.mdx) page** | **Tasks** in that project only                           | planned |
+Inbox items become tasks when **marked ready**. An item may have a project assigned before then — it still won't show on the project page until ready.
+## Features (in order)
+|        | Feature                                    | Status  | Description                                                                         |
+| ------ | ------------------------------------------ | ------- | ----------------------------------------------------------------------------------- |
+| **F1** | [Tasks](./f1-tasks.mdx)                    | partial | Core task list + bulk actions shipped; project/field assignment remains             |
+| **F2** | [Custom fields](./f2-custom-fields.mdx)    | done    | Definitions, per-task values, UI, and actions shipped                               |
+| **F3** | [Projects](./f3-projects.mdx)              | planned | Group tasks by area; focused project pages                                          |
+| **F4** | [Inbox](./f4-inbox.mdx)                    | partial | Triage UI shipped; custom fields and project assignment on items remain             |
+| **F5** | [Views](./f5-views.mdx)                    | planned | Filter, sort, group, and save list arrangements                                     |
+| **F6** | [Search](./f6-search.mdx)                  | planned | Find tasks by title and projects by name                                            |
+| **F7** | [First-run experience](./f7-first-run.mdx) | partial | Empty slate shipped; starter config remains                                         |
+| **F8** | [Chat](./f8-chat.mdx)                      | partial | Task, inbox, and custom-field parity shipped; extended parity with F3/F5/F6 remains |
+## What Tasks is
+Tasks is a **task-list-first to-do app**. Users capture and manage work on the main list and [inbox](./f4-inbox.mdx) through the UI or chat. Planned additions: [projects](./f3-projects.mdx), [custom fields](./f2-custom-fields.mdx), [saved views](./f5-views.mdx), and [search](./f6-search.mdx). The app ships increasingly pre-configured ([F7](./f7-first-run.mdx)). **Chat** (F8) stays at parity with the UI at every stage.
+## Status flags
+Each capability is **planned**, **partial**, or **done**. Flags apply to a whole file or to a section within a file.
+### File-level
+```yaml
+---
+id: F1
+title: Tasks
+status: partial
+order: 1
+---
+```
+### Section-level
+```md
+<!-- status: done -->
+## Task list filter
+```
+```md
+<!-- status: todo -->
+## Bulk actions
+```
+| Value     | Meaning                              |
+| --------- | ------------------------------------ |
+| `planned` | Described but not yet in the product |
+| `partial` | Some sections shipped                |
+| `done`    | Shipped and matches the description  |
+## Adding a capability
+Pick the next `F{n}`, set `order`, add `f{n}-<slug>.mdx`, and a row in the table above.

package/corpus/templates/tasks/docs/features/f1-tasks.mdx ADDED Viewed

@@ -0,0 +1,67 @@
+---
+id: F1
+title: Tasks
+status: partial
+order: 1
+---
+# F1 — Tasks
+## What it is
+A **task** is a unit of work with a **title** and a built-in **complete / incomplete** state. Tasks appear on the **main task page**.
+Tasks also appear inside [projects](./f3-projects.mdx) (F3). Optional [custom fields](./f2-custom-fields.mdx) (F2) extend tasks with due dates, notes, and more. [Inbox](./f4-inbox.mdx) items are not tasks until **marked ready** — until then, capture can land in the inbox instead of the task list.
+## What users can do
+<!-- status: done -->
+### Single tasks
+- **Add** a task by entering a title on the main task page.
+- **Edit** a task's title.
+- **Mark complete** or **mark incomplete** via the completion control.
+- **Delete** a task (with confirmation).
+- **Filter completed tasks out** on the main task page — show incomplete only, or show all (including completed).
+- **Reorder** tasks by dragging and dropping (single task; order persisted).
+For project assignment and custom fields, see [F3 Projects](./f3-projects.mdx) and [F2 Custom fields](./f2-custom-fields.mdx).
+### Multiple tasks (bulk)
+- **Select** one or more tasks by tapping rows in selection mode (shift-click for a range, select-all for the visible list).
+- **Apply an action** to every selected task in one step:
+  - Mark complete or mark incomplete (applies immediately; already-matching tasks are skipped and summarized)
+  - Delete (requires confirmation)
+- **Reorder** selected tasks together by dragging any one of them — all selected tasks move as a group.
+- **Clear selection** after an action; skipped tasks are summarized when an action does not apply to all.
+## How it behaves
+### Completion
+Completion is a **built-in property** on every task — not a custom field.
+<!-- status: done -->
+- New tasks start **incomplete**.
+- **Mark complete** checks the task off; **mark incomplete** reopens it.
+- Completed tasks appear **greyed out** (or struck through) when shown.
+### Completed tasks
+Completed tasks **stay in the list** — there is no archive step. They remain in place but can be hidden:
+<!-- status: done -->
+- **Filter completed out** on the main task page to hide finished work (default: incomplete only, or user toggles to show all).
+- When shown, completed tasks are greyed out; when filtered out, they disappear from the list.
+<!-- status: done -->
+### Order
+- Manual drag order is remembered on the main task page (`sort_order` in the database).
+- Dragging one task reorders it; the list updates optimistically and persists via `reorder-tasks`.
+- When **multiple tasks are selected**, dragging any selected task moves **all of them** together.

package/corpus/templates/tasks/docs/features/f2-custom-fields.mdx ADDED Viewed

@@ -0,0 +1,68 @@
+---
+id: F2
+title: Custom fields
+status: done
+order: 2
+---
+# F2 — Custom fields
+<!-- status: done -->
+## What it is
+**Custom fields** extend [F1 tasks](./f1-tasks.mdx) with user-defined properties — due dates, notes, priority, and anything else the user models. Fields are defined once for the app; each task fills in its own values. [F3 Projects](./f3-projects.mdx) are not extended by custom fields — only tasks are.
+**Completion** (complete / incomplete) is **not** a custom field — it is built into every task. There is no separate built-in "description" or "due date" either; users can model those as custom fields.
+## What users can do
+- **Create** a field with a name and type.
+- **Edit** a field's name or option list (for select fields).
+- **Delete** a field definition (removes stored values on all tasks).
+## Field types
+| Type              | Example use                                                                                                     |
+| ----------------- | --------------------------------------------------------------------------------------------------------------- |
+| **Text**          | Short label, reference number                                                                                   |
+| **Rich text**     | Notes, context, links, checklists                                                                               |
+| **Number**        | Story points, quantity; decimal precision (`0` means whole numbers only) and optional positive-only constraints |
+| **Percent**       | Completion %; optional decimal precision                                                                        |
+| **Currency**      | Budget, cost; currency symbol and decimal precision                                                             |
+| **Single-select** | Priority, workflow stage — one option from a defined list                                                       |
+| **Multi-select**  | Tags, categories — multiple options                                                                             |
+| **Date**          | Due date, follow-up                                                                                             |
+### Rich text
+Bold, italic, headings, bulleted and numbered lists, links, and paragraphs.
+### Select fields
+Options are defined when the field is created (name and optional color per option). Single-select allows one choice; multi-select allows many.
+## How it behaves
+- Empty fields stay blank — values are not required.
+- The task **title** stays the primary label in lists; field values show in the detail area or optional columns.
+- [F5 Views](./f5-views.mdx) can filter, sort, and group by custom fields and by built-in **completion**.
+- [F6 Search](./f6-search.mdx) matches **task titles** only — custom field values are not searchable.
+### Field type cannot change
+Once a field is created, its **type cannot be changed**. To use a different type, create a new field and move values over manually. If the old field is no longer needed, delete it — stored values are removed from all tasks.
+### Deleting a field
+Deleting a field definition removes its values on every task. Saved [views](./f5-views.mdx) that filter, sort, or group by that field may need to be updated.
+## Shipped contract
+<!-- status: done -->
+- **Fields** in the sidebar opens the definition manager.
+- Task rows open a pinned field editor for setting values on promoted tasks.
+- Configured field values can be shown on the main task card; which fields appear is chosen on the Fields page and persisted per user in SQL (max 3).
+- Field definitions have dedicated actions; task values are read with `list-tasks` `includeFields` and written with `update-task` `fieldValues`.
+- Task-card visibility uses `list-visible-task-fields` and `update-visible-task-fields`.

package/corpus/templates/tasks/docs/features/f3-projects.mdx ADDED Viewed

@@ -0,0 +1,33 @@
+---
+id: F3
+title: Projects
+status: planned
+order: 3
+---
+# F3 — Projects
+<!-- status: todo -->
+## What it is
+A **project** is a named area of work — "Home renovation", "Side hustle", "Q2 goals". A project contains **tasks** ([F1](./f1-tasks.mdx)). [Inbox](./f4-inbox.mdx) items are not tasks and do not appear in a project, even if a project is already assigned.
+Opening a project shows **only that project's tasks**. The main task page still shows **all tasks** across every project.
+## What users can do
+- **Create**, **rename**, or **delete** a project.
+- **Open** a project for focused work on its tasks and [F5 views](./f5-views.mdx).
+## How it behaves
+- A task belongs to **at most one project** (or none).
+- An inbox item may have a **project assigned** for when it becomes ready — it is **not shown** on the project page until [marked ready](./f4-inbox.mdx).
+- Assigned tasks still appear on the **main** task page with a project indicator.
+- Deleting a project **unassigns** its tasks and removes its project-scoped views; tasks are not deleted.
+## Limits (v1)
+- No nested or shared projects.
+- List layout only — no per-project board or calendar.

package/corpus/templates/tasks/docs/features/f4-inbox.mdx ADDED Viewed

@@ -0,0 +1,55 @@
+---
+id: F4
+title: Inbox
+status: partial
+order: 4
+---
+# F4 — Inbox
+## What it is
+The **inbox** is where new and rough ideas land before they become **tasks**. Inbox **items** are not tasks yet — they are **not ready**. They do not appear on the main task page, in [F3 projects](./f3-projects.mdx), or in [F5 views](./f5-views.mdx) until the user **marks them ready**.
+<!-- status: done -->
+### Foundation
+- **Backend** — unified `tasks` table with a storage-only `ready` flag; inbox and task list share one store with scoped queries and actions (`list-inbox-items`, `create-inbox-item`, `update-inbox-item`, `delete-inbox-item`, `mark-inbox-item-ready`, `reorder-inbox-items`)
+- **Navigation** — `/inbox` route and sidebar entry (before Tasks)
+- **Inbox UI** — add, inline edit, delete, mark ready, drag-to-reorder, and multi-select (bulk mark ready / bulk delete)
+- **Chat capture** — [chat](./f8-chat.mdx) defaults to `create-inbox-item`; `create-task` when the user asks to add directly to the task list
+## What users can do
+<!-- status: done -->
+- **Add** an inbox item from the inbox page or via agent (`create-inbox-item`).
+- **Edit** title inline or via `update-inbox-item`.
+- **Reorder** via drag-and-drop or `reorder-inbox-items`.
+- **Select** multiple items on the inbox page; bulk mark ready or bulk delete.
+- **Mark ready** via row action, bulk toolbar, or `mark-inbox-item-ready` — becomes an incomplete task (same id).
+- **Delete** via row action, bulk toolbar, or `delete-inbox-item` (confirm with user first in chat).
+<!-- status: todo -->
+- **Edit** [custom fields](./f2-custom-fields.mdx) and project assignment on items.
+## How it behaves
+| State     | What it is     | Where it appears                                                                                |
+| --------- | -------------- | ----------------------------------------------------------------------------------------------- |
+| **Inbox** | Not-ready item | Inbox page only                                                                                 |
+| **Task**  | Ready item     | Main task page, project (if assigned), [F5 views](./f5-views.mdx), [F6 search](./f6-search.mdx) |
+- **Completion** cannot be changed on inbox items — only after mark ready (F1).
+- An item may have a **project assigned** before it is ready; the project page does not show it until mark ready.
+- **Mark ready** creates a normal **incomplete** task with any preset project applied.
+- New capture from chat defaults to **inbox** unless the user asks for the task list directly ([F8](./f8-chat.mdx)).
+- New items added on the main task page or in a project are **tasks immediately** (`ready` in storage).
+- A task cannot return to the inbox.
+- Flat list — no sub-groups within the inbox.
+## Still partial
+Feature status stays **partial** until inbox metadata (custom fields, project assignment before mark ready) ships. Core inbox triage — capture, edit, reorder, select, mark ready, delete — is shipped.