@agent-native/core 0.90.2 → 0.90.4

package/corpus/core/src/cli/index.ts

@@ -2,6 +2,7 @@
 
 import { execSync, spawn } from "child_process";
 import fs from "fs";
+import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
 
@@ -253,11 +254,20 @@ function handleScaffoldImportError(err: any): never {
   throw err;
 }
 
+function findBinUpwards(binName: string): string | undefined {
+  let dir = process.cwd();
+  for (let i = 0; i < 20; i++) {
+    const candidate = path.join(dir, "node_modules", ".bin", binName);
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return undefined;
+}
+
 function findViteBin(): string {
-  // Look for vite in node_modules/.bin
-  const localVite = path.resolve("node_modules/.bin/vite");
-  if (fs.existsSync(localVite)) return localVite;
-  return "vite"; // fallback to PATH
+  return findBinUpwards("vite") ?? "vite";
 }
 
 function findTsxBin(): string {
@@ -277,9 +287,7 @@ function findTypeScriptCompilerBin(): string {
 }
 
 function findReactRouterBin(): string {
-  const localBin = path.resolve("node_modules/.bin/react-router");
-  if (fs.existsSync(localBin)) return localBin;
-  return "react-router";
+  return findBinUpwards("react-router") ?? "react-router";
 }
 
 /** Check if the project uses React Router framework mode (has react-router.config.ts) */
@@ -290,6 +298,73 @@ function isReactRouterFramework(): boolean {
   );
 }
 
+function canResolveFromProject(specifier: string): boolean {
+  try {
+    const requireFromProject = createRequire(path.resolve("package.json"));
+    requireFromProject.resolve(specifier);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function projectUsesFsRoutes(): boolean {
+  for (const file of [
+    path.resolve("app/routes.ts"),
+    path.resolve("app/routes.tsx"),
+    path.resolve("routes.ts"),
+    path.resolve("routes.tsx"),
+  ]) {
+    try {
+      if (
+        fs.existsSync(file) &&
+        fs.readFileSync(file, "utf-8").includes("@react-router/fs-routes")
+      ) {
+        return true;
+      }
+    } catch {}
+  }
+  return false;
+}
+
+function validateReactRouterBuildDependencies(): void {
+  const required: Array<[packageName: string, specifier: string]> = [
+    ["react-router", "react-router"],
+    ["@react-router/dev", "@react-router/dev/vite"],
+    ["vite", "vite"],
+  ];
+  if (projectUsesFsRoutes()) {
+    required.push(["@react-router/fs-routes", "@react-router/fs-routes"]);
+  }
+
+  const missing = required
+    .filter(([, specifier]) => !canResolveFromProject(specifier))
+    .map(([packageName]) => packageName);
+
+  if (missing.length === 0) return;
+
+  const packageManager = fs.existsSync(path.resolve("pnpm-lock.yaml"))
+    ? "pnpm"
+    : fs.existsSync(path.resolve("yarn.lock"))
+      ? "yarn"
+      : "npm";
+  const installCommand =
+    packageManager === "pnpm"
+      ? `pnpm add ${missing.join(" ")}`
+      : packageManager === "yarn"
+        ? `yarn add ${missing.join(" ")}`
+        : `npm install ${missing.join(" ")}`;
+
+  console.error(
+    [
+      "React Router framework mode requires build packages that are not installed from this app root.",
+      `Missing: ${missing.join(", ")}`,
+      `Install them with: ${installCommand}`,
+    ].join("\n"),
+  );
+  process.exit(1);
+}
+
 function isWorkspaceRoot(): boolean {
   const pkgPath = path.resolve("package.json");
   if (!fs.existsSync(pkgPath)) return false;
@@ -488,6 +563,7 @@ switch (command) {
     // continuation only runs on success.
     (async () => {
       if (isReactRouterFramework()) {
+        validateReactRouterBuildDependencies();
         const rr = findReactRouterBin();
         console.log("Building (React Router framework mode)...");
         await runBuildStep(rr, ["build"], { label: "react-router-build" });
@@ -592,6 +668,7 @@ switch (command) {
     // Run TypeScript type checking
     // React Router framework mode generates route types first
     if (isReactRouterFramework()) {
+      validateReactRouterBuildDependencies();
       const rr = findReactRouterBin();
       try {
         execSync(`${rr} typegen`, { stdio: "inherit" });

package/corpus/core/src/cli/workspacify.ts

@@ -24,6 +24,12 @@ import fs from "fs";
 import path from "path";
 
 const POSTGRES_DEPENDENCY_VERSION = "^3.4.9";
+const REACT_ROUTER_BUILD_DEPENDENCIES = [
+  "@react-router/dev",
+  "@react-router/fs-routes",
+  "react-router",
+  "vite",
+] as const;
 
 export interface WorkspacifyOptions {
   /** Target app directory (already populated with the copied template) */
@@ -87,6 +93,7 @@ export function workspacifyApp(opts: WorkspacifyOptions): void {
       // Add the runtime package to workspace apps so production bundles do
       // not fail only after a hosted Postgres database is configured.
       pkg.dependencies.postgres ??= POSTGRES_DEPENDENCY_VERSION;
+      ensureReactRouterBuildDependencies(pkg);
       // pnpm build-script approvals belong at the workspace root. Leaving the
       // template's per-app setting in place makes pnpm warn on every install.
       if (pkg.pnpm && typeof pkg.pnpm === "object") {
@@ -156,6 +163,33 @@ export function workspacifyApp(opts: WorkspacifyOptions): void {
   }
 }
 
+function ensureReactRouterBuildDependencies(pkg: Record<string, any>): void {
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies,
+    ...pkg.peerDependencies,
+  };
+  if (
+    !allDeps["@react-router/dev"] &&
+    !allDeps["react-router"] &&
+    !allDeps["@react-router/fs-routes"]
+  ) {
+    return;
+  }
+
+  pkg.dependencies = pkg.dependencies ?? {};
+  for (const key of REACT_ROUTER_BUILD_DEPENDENCIES) {
+    const existing =
+      pkg.dependencies[key] ??
+      pkg.devDependencies?.[key] ??
+      pkg.peerDependencies?.[key];
+    if (!existing) continue;
+    pkg.dependencies[key] = existing;
+    delete pkg.devDependencies?.[key];
+    delete pkg.peerDependencies?.[key];
+  }
+}
+
 function writeInheritedChatPlugin(
   appDir: string,
   workspaceCoreName: string,

package/corpus/core/src/client/command-navigation/index.ts

@@ -0,0 +1,15 @@
+export {
+  CommandMenu,
+  openAgentSettings,
+  openAgentSidebar,
+  submitToAgent,
+  useCommandMenuShortcut,
+  type CommandDocsGroupProps,
+  type CommandGroupProps,
+  type CommandItemProps,
+  type CommandMenuDoc,
+  type CommandMenuProps,
+  type CommandShortcutProps,
+} from "../CommandMenu.js";
+export { focusAgentChat } from "../AgentPanel.js";
+export * from "../../navigation/index.js";

package/corpus/core/src/client/comments-review/index.ts

@@ -0,0 +1 @@
+export * from "../review/index.js";

package/corpus/core/src/client/history/VersionHistoryPanel.tsx

@@ -0,0 +1,175 @@
+import { IconClock, IconRestore, IconTimeline } from "@tabler/icons-react";
+import { useState, type ReactNode } from "react";
+
+import type { ResourceVersion } from "../../history/types.js";
+import { cn } from "../utils.js";
+import {
+  useResourceVersions,
+  useRestoreResourceVersion,
+} from "./use-history.js";
+
+export interface VersionHistoryPanelProps {
+  resourceType: string;
+  resourceId: string;
+  title?: string;
+  className?: string;
+  limit?: number;
+  emptyState?: ReactNode;
+  renderVersion?: (version: ResourceVersion) => ReactNode;
+  onRestored?: (version: ResourceVersion, result: unknown) => void;
+}
+
+export function VersionHistoryPanel({
+  resourceType,
+  resourceId,
+  title = "Version history",
+  className,
+  limit = 20,
+  emptyState = "No saved versions yet.",
+  renderVersion,
+  onRestored,
+}: VersionHistoryPanelProps) {
+  const versions = useResourceVersions({ resourceType, resourceId, limit });
+  const restore = useRestoreResourceVersion();
+  const [confirmRestoreId, setConfirmRestoreId] = useState<string | null>(null);
+
+  return (
+    <section
+      className={cn(
+        "rounded-lg border border-border bg-card text-card-foreground",
+        className,
+      )}
+    >
+      <div className="flex items-center gap-2 border-b border-border px-4 py-3">
+        <IconTimeline className="h-4 w-4 text-muted-foreground" />
+        <h2 className="text-sm font-medium">{title}</h2>
+      </div>
+      <div className="divide-y divide-border">
+        {versions.isLoading ? (
+          <div className="px-4 py-6 text-sm text-muted-foreground">
+            Loading versions...
+          </div>
+        ) : versions.data?.versions.length ? (
+          versions.data.versions.map((version) => {
+            const confirming = confirmRestoreId === version.id;
+            return (
+              <article key={version.id} className="flex gap-3 px-4 py-3">
+                <div className="mt-0.5 flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-muted">
+                  <IconClock className="h-4 w-4 text-muted-foreground" />
+                </div>
+                <div className="min-w-0 flex-1">
+                  {renderVersion ? (
+                    renderVersion(version)
+                  ) : (
+                    <>
+                      <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
+                        <h3 className="truncate text-sm font-medium">
+                          {version.title ?? `Version ${version.versionNumber}`}
+                        </h3>
+                        <span className="text-xs text-muted-foreground">
+                          {formatVersionDate(version.createdAt)}
+                        </span>
+                      </div>
+                      {version.summary ? (
+                        <p className="mt-1 text-sm text-muted-foreground">
+                          {version.summary}
+                        </p>
+                      ) : null}
+                    </>
+                  )}
+                </div>
+                <div className="flex shrink-0 items-center gap-2">
+                  {confirming ? (
+                    <>
+                      <button
+                        type="button"
+                        className="inline-flex h-8 items-center rounded-md border border-input px-2.5 text-xs font-medium hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50"
+                        disabled={restore.isPending}
+                        onClick={() => setConfirmRestoreId(null)}
+                      >
+                        Cancel
+                      </button>
+                      <button
+                        type="button"
+                        className="inline-flex h-8 items-center gap-1.5 rounded-md border border-destructive bg-destructive px-2.5 text-xs font-medium text-destructive-foreground hover:bg-destructive/90 disabled:cursor-not-allowed disabled:opacity-50"
+                        disabled={restore.isPending}
+                        onClick={() =>
+                          restore.mutate(
+                            { id: version.id },
+                            {
+                              onSuccess: (result) => {
+                                setConfirmRestoreId(null);
+                                onRestored?.(result.version, result.result);
+                              },
+                              onError: () => setConfirmRestoreId(null),
+                            },
+                          )
+                        }
+                      >
+                        <IconRestore className="h-3.5 w-3.5" />
+                        Confirm restore
+                      </button>
+                    </>
+                  ) : (
+                    <button
+                      type="button"
+                      className="inline-flex h-8 items-center gap-1.5 rounded-md border border-input px-2.5 text-xs font-medium hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50"
+                      disabled={restore.isPending}
+                      onClick={() => setConfirmRestoreId(version.id)}
+                    >
+                      <IconRestore className="h-3.5 w-3.5" />
+                      Restore
+                    </button>
+                  )}
+                </div>
+              </article>
+            );
+          })
+        ) : (
+          <div className="px-4 py-6 text-sm text-muted-foreground">
+            {emptyState}
+          </div>
+        )}
+      </div>
+    </section>
+  );
+}
+
+export function HistoryTimeline({
+  versions,
+  className,
+}: {
+  versions: ResourceVersion[];
+  className?: string;
+}) {
+  return (
+    <ol className={cn("space-y-3", className)}>
+      {versions.map((version) => (
+        <li key={version.id} className="flex gap-3">
+          <div className="mt-1 h-2 w-2 rounded-full bg-primary" />
+          <div className="min-w-0">
+            <div className="truncate text-sm font-medium">
+              {version.title ?? `Version ${version.versionNumber}`}
+            </div>
+            <div className="text-xs text-muted-foreground">
+              {formatVersionDate(version.createdAt)}
+            </div>
+            {version.summary ? (
+              <p className="mt-1 text-sm text-muted-foreground">
+                {version.summary}
+              </p>
+            ) : null}
+          </div>
+        </li>
+      ))}
+    </ol>
+  );
+}
+
+function formatVersionDate(value: string): string {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return value;
+  }
+  return date.toLocaleString();
+}

package/corpus/core/src/client/history/index.ts

@@ -0,0 +1,21 @@
+export {
+  HistoryTimeline,
+  VersionHistoryPanel,
+  type VersionHistoryPanelProps,
+} from "./VersionHistoryPanel.js";
+export {
+  useCreateResourceVersion,
+  useResourceHistory,
+  useResourceVersion,
+  useResourceVersions,
+  useRestoreResourceVersion,
+  type CreateResourceVersionInput,
+  type GetResourceVersionInput,
+  type GetResourceVersionResult,
+  type ListResourceHistoryResult,
+  type ListResourceVersionsResult,
+  type ResourceHistoryParams,
+  type ResourceVersionsParams,
+  type RestoreResourceVersionInput,
+  type RestoreResourceVersionResult,
+} from "./use-history.js";

package/corpus/core/src/client/history/use-history.ts

@@ -0,0 +1,114 @@
+import type { ResourceVersion } from "../../history/types.js";
+import { useActionMutation, useActionQuery } from "../use-action.js";
+
+export interface ResourceVersionsParams {
+  resourceType: string;
+  resourceId: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ResourceHistoryParams {
+  resourceType: string;
+  resourceId: string;
+  limit?: number;
+}
+
+export interface CreateResourceVersionInput {
+  resourceType: string;
+  resourceId: string;
+  title?: string;
+  summary?: string;
+  snapshot?: unknown;
+  metadata?: Record<string, unknown>;
+}
+
+export interface RestoreResourceVersionInput {
+  id?: string;
+  resourceType?: string;
+  resourceId?: string;
+  versionNumber?: number;
+}
+
+export interface GetResourceVersionInput {
+  id?: string;
+  resourceType?: string;
+  resourceId?: string;
+  versionNumber?: number;
+}
+
+export interface ListResourceVersionsResult {
+  versions: ResourceVersion[];
+}
+
+export interface ListResourceHistoryResult {
+  versions: ResourceVersion[];
+  auditEvents: unknown[];
+}
+
+export interface GetResourceVersionResult {
+  version: ResourceVersion;
+}
+
+export interface RestoreResourceVersionResult {
+  version: ResourceVersion;
+  result: unknown;
+}
+
+export function useResourceVersions(
+  params: ResourceVersionsParams,
+  options?: { enabled?: boolean },
+) {
+  return useActionQuery<ListResourceVersionsResult>(
+    "list-resource-versions",
+    params,
+    {
+      enabled:
+        options?.enabled ?? Boolean(params.resourceType && params.resourceId),
+    },
+  );
+}
+
+export function useResourceHistory(
+  params: ResourceHistoryParams,
+  options?: { enabled?: boolean },
+) {
+  return useActionQuery<ListResourceHistoryResult>(
+    "list-resource-history",
+    params,
+    {
+      enabled:
+        options?.enabled ?? Boolean(params.resourceType && params.resourceId),
+    },
+  );
+}
+
+export function useResourceVersion(
+  params: GetResourceVersionInput,
+  options?: { enabled?: boolean },
+) {
+  const enabled =
+    options?.enabled ??
+    Boolean(
+      params.id ||
+      (params.resourceType && params.resourceId && params.versionNumber),
+    );
+  return useActionQuery<GetResourceVersionResult>(
+    "get-resource-version",
+    params,
+    { enabled },
+  );
+}
+
+export function useCreateResourceVersion() {
+  return useActionMutation<ResourceVersion, CreateResourceVersionInput>(
+    "create-resource-version",
+  );
+}
+
+export function useRestoreResourceVersion() {
+  return useActionMutation<
+    RestoreResourceVersionResult,
+    RestoreResourceVersionInput
+  >("restore-resource-version");
+}

package/corpus/core/src/client/index.ts

@@ -639,19 +639,22 @@ export { AgentNativeIcon } from "./components/icons/AgentNativeIcon.js";
 export {
   SettingsPanel,
   SettingsTabsPage,
-  useAgentSettingsTabs,
-  type SettingsPanelProps,
-  type SettingsTabItem,
-  type SettingsTabsPageProps,
-} from "./settings/index.js";
-export { useBuilderStatus } from "./settings/useBuilderStatus.js";
-export {
+  SecretsSection,
   openBuilderConnectPopup,
+  useAgentSettingsTabs,
   useBuilderConnectFlow,
+  useBuilderStatus,
+  withBuilderConnectTrackingParams,
   type BuilderConnectFlow,
   type BuilderConnectFlowOptions,
+  type BuilderConnectStartOptions,
+  type BuilderStatus,
   type OpenBuilderConnectPopupOptions,
-} from "./settings/useBuilderStatus.js";
+  type SecretsSectionProps,
+  type SettingsPanelProps,
+  type SettingsTabItem,
+  type SettingsTabsPageProps,
+} from "./settings/index.js";
 // Deprecated — use AgentSidebar + AgentToggleButton instead
 export {
   ProductionAgentPanel,
@@ -783,6 +786,51 @@ export {
   type ResourceTreeProps,
   type ResourceEditorProps,
 } from "./resources/index.js";
+export {
+  HistoryTimeline,
+  VersionHistoryPanel,
+  useCreateResourceVersion,
+  useResourceHistory,
+  useResourceVersion,
+  useResourceVersions,
+  useRestoreResourceVersion,
+  type CreateResourceVersionInput,
+  type GetResourceVersionInput,
+  type GetResourceVersionResult,
+  type ListResourceHistoryResult,
+  type ListResourceVersionsResult,
+  type ResourceHistoryParams,
+  type ResourceVersionsParams,
+  type RestoreResourceVersionInput,
+  type RestoreResourceVersionResult,
+  type VersionHistoryPanelProps,
+} from "./history/index.js";
+export {
+  ReviewStatusBadge,
+  ReviewThreadPanel,
+  buildReviewThreads,
+  useConsumeReviewFeedback,
+  useCreateReviewComment,
+  useDeleteReviewComment,
+  useReplyReviewComment,
+  useResolveReviewThread,
+  useReviewComments,
+  useReviewFeedback,
+  useSetReviewStatus,
+  type ConsumeReviewFeedbackInput,
+  type CreateReviewCommentInput,
+  type DeleteReviewCommentInput,
+  type GetReviewFeedbackParams,
+  type GetReviewFeedbackResult,
+  type ListReviewCommentsParams,
+  type ListReviewCommentsResult,
+  type ReplyReviewCommentInput,
+  type ResolveReviewThreadInput,
+  type ReviewStatusBadgeProps,
+  type ReviewThread,
+  type ReviewThreadPanelProps,
+  type SetReviewStatusInput,
+} from "./review/index.js";
 export type {
   AppToFrameMessage,
   FrameToAppMessage,
@@ -792,10 +840,10 @@ export type {
 } from "./frame-protocol.js";
 export {
   CommandMenu,
-  useCommandMenuShortcut,
   openAgentSidebar,
   openAgentSettings,
   submitToAgent,
+  useCommandMenuShortcut,
   type CommandMenuProps,
   type CommandMenuDoc,
   type CommandDocsGroupProps,
@@ -803,6 +851,33 @@ export {
   type CommandItemProps,
   type CommandShortcutProps,
 } from "./CommandMenu.js";
+export {
+  buildOpenRouteLink,
+  buildOpenRoutePath,
+  buildResourceRoute,
+  buildSettingsRoute,
+  buildStandardAppRoute,
+  buildTeamRoute,
+  createStandardOpenPathResolver,
+  STANDARD_APP_ROUTES,
+  STANDARD_SETTINGS_TABS,
+  type BuildResourceRouteOptions,
+  type BuildStandardAppRouteOptions,
+  type NavigationLink,
+  type NavigationTarget,
+  type StandardAppRouteId,
+  type StandardOpenPathResolverOptions,
+  type StandardOpenPathRoute,
+  type StandardSettingsTabId,
+} from "../navigation/index.js";
+export {
+  BuilderConnectCard,
+  ProviderReadinessBadge,
+  SetupConnectionsPage,
+  type BuilderConnectCardProps,
+  type ProviderReadinessBadgeProps,
+  type SetupConnectionsPageProps,
+} from "./setup-connections/index.js";
 export {
   ChangelogDialog,
   ChangelogSettingsCard,