npm - @agent-native/core - Versions diffs - 0.101.13 → 0.102.0 - Mend

@agent-native/core 0.101.13 → 0.102.0

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 (561) hide show

package/src/templates/chat/app/root.tsx ADDED Viewed

@@ -0,0 +1,172 @@
+import { useDbSync } from "@agent-native/core/client";
+import {
+  AppProviders,
+  CommandMenu,
+  appPath,
+  configureTracking,
+  createAgentNativeQueryClient,
+  getLocaleInitScript,
+  getThemeInitScript,
+  useCommandMenuShortcut,
+  useT,
+} from "@agent-native/core/client";
+import { IconBrain, 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,
+  useNavigate,
+} from "react-router";
+import type { LinksFunction } from "react-router";
+import { Layout as AppLayout } from "@/components/layout/Layout";
+import { AppToolkitProvider } from "@/components/ui/toolkit-provider";
+import { useNavigationState } from "@/hooks/use-navigation-state";
+import { APP_TITLE } from "@/lib/app-config";
+import { TAB_ID } from "@/lib/tab-id";
+import changelog from "../CHANGELOG.md?raw";
+import { i18nCatalog } from "./i18n";
+import stylesheet from "./global.css?url";
+configureTracking({
+  getDefaultProps: (_name, properties) => ({
+    ...properties,
+    app: "chat",
+  }),
+});
+export const links: LinksFunction = () => [
+  { rel: "stylesheet", href: stylesheet },
+];
+const THEME_INIT_SCRIPT = getThemeInitScript();
+const LOCALE_INIT_SCRIPT = getLocaleInitScript();
+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 }}
+        />
+        <script
+          data-agent-native-locale-init
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{ __html: LOCALE_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 t = useT();
+  const isDark = resolvedTheme === "dark";
+  return (
+    <CommandMenu.Item
+      onSelect={() => setTheme(isDark ? "light" : "dark")}
+      keywords={["theme", "dark", "light", "mode"]}
+    >
+      {isDark ? <IconSun size={16} /> : <IconMoon size={16} />}
+      {t("root.toggleTheme")}
+    </CommandMenu.Item>
+  );
+}
+function AppContent() {
+  const [cmdkOpen, setCmdkOpen] = useState(false);
+  const navigate = useNavigate();
+  const t = useT();
+  useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
+  return (
+    <>
+      <CommandMenu
+        open={cmdkOpen}
+        onOpenChange={setCmdkOpen}
+        changelog={changelog}
+        changelogKey="chat"
+      >
+        <CommandMenu.Group heading={t("root.commandActions")}>
+          <CommandMenu.Item onSelect={() => {}}>
+            {t("root.commandSearch")}
+          </CommandMenu.Item>
+          <CommandMenu.Item
+            onSelect={() => navigate("/agent")}
+            keywords={[
+              "agent",
+              "context",
+              "files",
+              "connections",
+              "jobs",
+              "access",
+            ]}
+          >
+            <IconBrain size={16} />
+            {t("settings.openAgentSettings")}
+          </CommandMenu.Item>
+        </CommandMenu.Group>
+        <CommandMenu.Group heading={t("root.commandAppearance")}>
+          <ThemeToggleItem />
+        </CommandMenu.Group>
+      </CommandMenu>
+      <AppLayout>
+        <Outlet />
+      </AppLayout>
+    </>
+  );
+}
+export default function Root() {
+  const [queryClient] = useState(() => createAgentNativeQueryClient());
+  return (
+    <AppToolkitProvider>
+      <AppProviders queryClient={queryClient} i18n={{ catalog: i18nCatalog }}>
+        <DbSyncSetup />
+        <AppContent />
+      </AppProviders>
+    </AppToolkitProvider>
+  );
+}
+export { ErrorBoundary } from "@agent-native/core/client";

package/src/templates/chat/app/routes/_index.tsx ADDED Viewed

@@ -0,0 +1,91 @@
+import {
+  AgentChatSurface,
+  markAgentChatHomeHandoff,
+  useT,
+} from "@agent-native/core/client";
+import { useEffect } from "react";
+import { useNavigate, useParams } from "react-router";
+import { APP_TITLE } from "@/lib/app-config";
+import { TAB_ID } from "@/lib/tab-id";
+const SEO_TITLE = `${APP_TITLE} - Open Source AI app starter with actions`;
+const SEO_DESCRIPTION =
+  "Open Source starter for agent-native apps with durable chat, shared actions, UI state, tools, and a backend your agent can extend.";
+export function meta() {
+  return [
+    { title: SEO_TITLE },
+    {
+      name: "description",
+      content: SEO_DESCRIPTION,
+    },
+    { property: "og:title", content: SEO_TITLE },
+    { property: "og:description", content: SEO_DESCRIPTION },
+    { name: "twitter:card", content: "summary" },
+    { name: "twitter:title", content: SEO_TITLE },
+    { name: "twitter:description", content: SEO_DESCRIPTION },
+  ];
+}
+function chatThreadPath(threadId: string | null) {
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/";
+}
+export default function ChatRoute() {
+  const { threadId } = useParams();
+  const navigate = useNavigate();
+  const t = useT();
+  useEffect(() => {
+    function handleChatRunning(event: Event) {
+      const detail = (event as CustomEvent).detail;
+      if (detail?.isRunning === true) markAgentChatHomeHandoff("chat");
+    }
+    window.addEventListener("agentNative.chatRunning", handleChatRunning);
+    return () =>
+      window.removeEventListener("agentNative.chatRunning", handleChatRunning);
+  }, []);
+  return (
+    <div className="flex h-full min-h-0 flex-col bg-background">
+      <AgentChatSurface
+        mode="page"
+        chatViewTransition
+        className="h-full"
+        defaultMode="chat"
+        storageKey="chat"
+        threadUrlSync={{
+          routeThreadId: threadId ?? null,
+          getPath: chatThreadPath,
+          navigate,
+        }}
+        browserTabId={TAB_ID}
+        showHeader={false}
+        showTabBar={false}
+        dynamicSuggestions={false}
+        suggestions={[
+          t("chat.suggestionCapabilities"),
+          t("chat.suggestionCustomize"),
+          t("chat.suggestionActions"),
+        ]}
+        emptyStateText={t("chat.emptyState")}
+        emptyStateDisplay="hidden"
+        centerComposerWhenEmpty
+        composerLayoutVariant="hero"
+        composerPlaceholder={t("chat.composerPlaceholder")}
+        composerSlot={
+          <div className="mx-auto mb-5 max-w-xl px-4 text-center">
+            <h1 className="text-2xl font-semibold tracking-normal text-foreground sm:text-3xl">
+              {t("chat.heroTitle")}
+            </h1>
+            <p className="mt-2 text-sm leading-6 text-muted-foreground">
+              {t("chat.heroDescription")}
+            </p>
+          </div>
+        }
+      />
+    </div>
+  );
+}

package/src/templates/chat/app/routes/agent.tsx ADDED Viewed

@@ -0,0 +1,17 @@
+import * as AgentClient from "@agent-native/core/client";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { resolveAgentPageComponent } from "@/lib/agent-page";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [{ title: `Agent - ${APP_TITLE}` }];
+}
+export default function AgentRoute() {
+  const t = AgentClient.useT();
+  useSetPageTitle(t("settings.agentTitle"));
+  const AgentPage = resolveAgentPageComponent(AgentClient);
+  return <AgentPage appName={APP_TITLE} />;
+}

package/src/templates/chat/app/routes/chat.$threadId.tsx ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { default, meta } from "./_index";

package/src/templates/chat/app/routes/database.tsx ADDED Viewed

@@ -0,0 +1,17 @@
+import { useT } from "@agent-native/core/client";
+import { DbAdminPage } from "@agent-native/core/client/db-admin";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+export function meta() {
+  return [{ title: "Database" }];
+}
+export default function DatabasePage() {
+  const t = useT();
+  useSetPageTitle(t("pages.databaseTitle"));
+  return (
+    <div className="h-full">
+      <DbAdminPage />
+    </div>
+  );
+}

package/src/templates/chat/app/routes/extensions.$id.$slug.tsx ADDED Viewed

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

package/src/templates/chat/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/src/templates/chat/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/src/templates/chat/app/routes/extensions.tsx ADDED Viewed

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

package/src/templates/chat/app/routes/observability.tsx ADDED Viewed

@@ -0,0 +1,18 @@
+import { ObservabilityDashboard, useT } from "@agent-native/core/client";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import enUS from "@/i18n/en-US";
+export function meta() {
+  return [{ title: enUS.pages.observabilityPageTitle }];
+}
+export default function ObservabilityPage() {
+  const t = useT();
+  useSetPageTitle(t("pages.observabilityPageTitle"));
+  return (
+    <div className="p-6">
+      <ObservabilityDashboard />
+    </div>
+  );
+}

package/src/templates/chat/app/routes/settings.tsx ADDED Viewed

@@ -0,0 +1,88 @@
+import {
+  ChangelogSettingsCard,
+  LanguagePicker,
+  SettingsTabsPage,
+  useAgentSettingsTabs,
+  useT,
+  type SettingsSearchEntry,
+} from "@agent-native/core/client";
+import { TeamPage } from "@agent-native/core/client/org";
+import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { useMemo } from "react";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import { Label } from "@/components/ui/label";
+import { APP_TITLE } from "@/lib/app-config";
+import changelog from "../../CHANGELOG.md?raw";
+export function meta() {
+  return [{ title: `Settings - ${APP_TITLE}` }];
+}
+export default function SettingsRoute() {
+  const t = useT();
+  const agentSettingsTabs = useAgentSettingsTabs();
+  useSetPageTitle(t("settings.title"));
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "chat-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+  return (
+    <SettingsTabsPage
+      teamLabel={t("navigation.team")}
+      extraTabs={agentSettingsTabs}
+      generalSearchEntries={generalSearchEntries}
+      general={
+        <div className="mx-auto w-full max-w-2xl space-y-6">
+          <p className="text-sm leading-6 text-muted-foreground">
+            {t("settings.description")}
+          </p>
+          <Card id="language" className="scroll-mt-16">
+            <CardHeader>
+              <CardTitle className="text-base">
+                {t("settings.languageTitle")}
+              </CardTitle>
+              <CardDescription>
+                {t("settings.languageDescription")}
+              </CardDescription>
+            </CardHeader>
+            <CardContent className="max-w-xs space-y-1.5">
+              <Label>{t("settings.languageLabel")}</Label>
+              <LanguagePicker label={t("settings.languageLabel")} />
+            </CardContent>
+          </Card>
+        </div>
+      }
+      team={
+        <div className="mx-auto w-full max-w-3xl">
+          <TeamPage
+            showTitle={false}
+            createOrgDescription={t("pages.teamCreateOrgDescription")}
+          />
+        </div>
+      }
+      whatsNew={
+        <div className="mx-auto w-full max-w-2xl">
+          <ChangelogSettingsCard markdown={changelog} />
+        </div>
+      }
+    />
+  );
+}

package/src/templates/chat/app/routes/team.tsx ADDED Viewed

@@ -0,0 +1,11 @@
+import { Navigate } from "react-router";
+import { APP_TITLE } from "@/lib/app-config";
+export function meta() {
+  return [{ title: `Team — ${APP_TITLE}` }];
+}
+export default function TeamRoute() {
+  return <Navigate to="/settings#organization" replace />;
+}

package/src/templates/chat/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/src/templates/chat/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/src/templates/chat/changelog/2026-06-24-a-new-settings-page-gives-quick-access-to-language-workspace.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-24
+---
+A new Settings page gives quick access to language, workspace, and agent preferences.

package/src/templates/chat/changelog/2026-06-24-added-a-language-picker-and-localized-app-chrome-for-support.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-24
+---
+Added a language picker and localized app chrome for supported languages.

package/src/templates/chat/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-27
+---
+Traditional Chinese copy now uses Taiwan terminology and clearer technical wording.

package/src/templates/chat/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-28
+---
+Left sidebar collapse motion and footer controls now feel smoother and use less divider chrome.

package/src/templates/chat/changelog/2026-06-29-chat-layouts-adapt-when-the-agent-sidebar-is-open.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+Chat layouts adapt when the agent sidebar is open.

package/src/templates/chat/changelog/2026-07-08-settings-are-cleaner-and-searchable.md ADDED Viewed

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

package/src/templates/chat/changelog/2026-07-10-chat-now-makes-ai-connection-setup-clear-without-shifting-th.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+Chat now makes AI connection setup clear without shifting the composer.

package/src/templates/chat/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-13
+---
+A full Agent page now brings context, files, connections, jobs, and external access together

package/src/templates/chat/changelog/2026-07-14-chat-opens-reliably-on-hosted-deployments-instead-of-failing.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-14
+---
+Chat opens reliably on hosted deployments instead of failing during startup

package/src/templates/chat/changelog/2026-07-14-fixed-chat-template-startup-with-older-core-versions.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-14
+---
+Fixed chat template startup with older core versions

package/src/templates/chat/changelog/2026-07-15-chat-navigation-focuses-on-chat-and-agent.md ADDED Viewed

@@ -0,0 +1,6 @@
+---
+type: removed
+date: 2026-07-15
+---
+The main navigation is now focused on Chat, Agent, and essential workspace settings.

package/src/templates/chat/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/src/templates/chat/data/.gitkeep ADDED Viewed

File without changes

package/src/templates/chat/data/sync-config.json ADDED Viewed

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

package/src/templates/chat/learnings.defaults.md ADDED Viewed

@@ -0,0 +1,5 @@
+# Learnings
+<!-- This file is your app's memory. The AI reads it at the start of every conversation and updates it when it learns something new. -->
+<!-- Your personal learnings.md is gitignored so preferences and private info stay local. -->
+<!-- This defaults file is what new checkouts start with. -->

package/src/templates/chat/netlify.toml ADDED Viewed

@@ -0,0 +1,10 @@
+[build]
+ignore = "node ./scripts/netlify-ignore-build.mjs chat"
+command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && NITRO_PRESET=netlify pnpm --filter chat build"
+publish = "templates/chat/dist"
+functions = "templates/chat/.netlify/functions-internal"
+[build.environment]
+GA_MEASUREMENT_ID = "G-ESF7FYXGN9"
+NITRO_PRESET = "netlify"
+NPM_CONFIG_PRODUCTION = "false"