@agent-native/core 0.132.2 → 0.133.1

package/corpus/templates/factory/app/global.css

@@ -0,0 +1,93 @@
+/* Self-hosted via @fontsource-variable/inter — no render-blocking Google Fonts request */
+@import "@fontsource-variable/inter";
+
+@import "tailwindcss";
+@import "@agent-native/core/styles/agent-native.css";
+@import "@agent-native/toolkit/styles.css";
+
+@source "./**/*.{ts,tsx}";
+
+:root {
+  --background: 0 0% 100%;
+  --foreground: 0 0% 10%;
+  --card: 0 0% 100%;
+  --card-foreground: 0 0% 10%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 0 0% 10%;
+  --primary: 0 0% 15%;
+  --primary-foreground: 0 0% 100%;
+  --secondary: 0 0% 95%;
+  --secondary-foreground: 0 0% 15%;
+  --muted: 0 0% 95%;
+  --muted-foreground: 0 0% 45%;
+  --accent: 0 0% 95%;
+  --accent-foreground: 0 0% 15%;
+  --destructive: 0 91% 71%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 0 0% 90%;
+  --input: 0 0% 90%;
+  --ring: 0 0% 40%;
+  --radius: 0.5rem;
+  --sidebar-background: 0 0% 97%;
+  --sidebar-foreground: 0 0% 45%;
+  --sidebar-primary: 0 0% 15%;
+  --sidebar-primary-foreground: 0 0% 100%;
+  --sidebar-accent: 0 0% 95%;
+  --sidebar-accent-foreground: 0 0% 15%;
+  --sidebar-border: 0 0% 90%;
+  --sidebar-ring: 0 0% 40%;
+}
+
+.dark {
+  --background: 0 0% 13%;
+  --foreground: 0 0% 90%;
+  --card: 0 0% 15%;
+  --card-foreground: 0 0% 90%;
+  --popover: 0 0% 15%;
+  --popover-foreground: 0 0% 90%;
+  --primary: 0 0% 75%;
+  --primary-foreground: 0 0% 10%;
+  --secondary: 0 0% 18%;
+  --secondary-foreground: 0 0% 90%;
+  --muted: 0 0% 16%;
+  --muted-foreground: 0 0% 60%;
+  --accent: 0 0% 18%;
+  --accent-foreground: 0 0% 90%;
+  --destructive: 0 84% 60%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 0 0% 24%;
+  --input: 0 0% 24%;
+  --ring: 0 0% 60%;
+  --radius: 0.5rem;
+  --sidebar-background: 0 0% 10%;
+  --sidebar-foreground: 0 0% 60%;
+  --sidebar-primary: 0 0% 75%;
+  --sidebar-primary-foreground: 0 0% 10%;
+  --sidebar-accent: 0 0% 16%;
+  --sidebar-accent-foreground: 0 0% 90%;
+  --sidebar-border: 0 0% 20%;
+  --sidebar-ring: 0 0% 60%;
+}
+
+@layer base {
+  body {
+    @apply bg-background text-foreground;
+    font-family: "Inter Variable", "Inter", sans-serif;
+    font-feature-settings: "cv02", "cv03", "cv04", "cv11";
+  }
+}
+
+::-webkit-scrollbar {
+  width: 5px;
+  height: 5px;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+::-webkit-scrollbar-thumb {
+  background: hsl(var(--border));
+  border-radius: 3px;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: hsl(var(--muted-foreground) / 0.4);
+}

package/corpus/templates/factory/app/hooks/use-navigation-state.ts

@@ -0,0 +1,113 @@
+import { appBasePath, appPath } from "@agent-native/core/client/api-path";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
+
+import { TAB_ID } from "@/lib/tab-id";
+
+export interface NavigationState {
+  view: string;
+  path?: string;
+  threadId?: string;
+  factoryId?: string;
+  factoryTab?: string;
+  factoryNodeId?: string;
+  factoryEdgeId?: string;
+}
+
+export function useNavigationState() {
+  useAgentRouteState<NavigationState>({
+    browserTabId: TAB_ID,
+    requestSource: TAB_ID,
+    getNavigationState: ({ pathname, searchParams }) => {
+      const threadId = threadIdFromPath(pathname);
+      return {
+        view: viewForPath(pathname),
+        path: appPath(pathname),
+        ...(threadId ? { threadId } : {}),
+        ...(pathname.startsWith("/factory") && searchParams.get("factoryId")
+          ? { factoryId: searchParams.get("factoryId") ?? undefined }
+          : {}),
+        ...(pathname.startsWith("/factory") && searchParams.get("tab")
+          ? { factoryTab: searchParams.get("tab") ?? undefined }
+          : {}),
+        ...(pathname.startsWith("/factory") && searchParams.get("node")
+          ? { factoryNodeId: searchParams.get("node") ?? undefined }
+          : {}),
+        ...(pathname.startsWith("/factory") && searchParams.get("edge")
+          ? { factoryEdgeId: searchParams.get("edge") ?? undefined }
+          : {}),
+      };
+    },
+    getCommandPath: (command) =>
+      routerPath(command.path || pathForCommand(command)),
+  });
+}
+
+function threadIdFromPath(pathname: string): string | null {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+    // coercion-ok: malformed route input has no valid thread id and remains outside thread selection.
+  } catch {
+    return null;
+  }
+}
+
+function viewForPath(pathname: string): string {
+  if (isChatPath(pathname)) return "chat";
+  if (pathname.startsWith("/database")) return "database";
+  if (pathname.startsWith("/extensions")) return "extensions";
+  if (pathname.startsWith("/observability")) return "observability";
+  if (pathname.startsWith("/factory")) return "factory";
+  if (pathname.startsWith("/agent")) return "agent";
+  if (pathname.startsWith("/team")) return "settings";
+  return "chat";
+}
+
+function pathForView(view?: string): string {
+  switch (view) {
+    case "chat":
+    case "home":
+    case "ask":
+      return "/";
+    case "database":
+      return "/database";
+    case "extensions":
+      return "/extensions";
+    case "observability":
+      return "/observability";
+    case "factory":
+      return "/factory";
+    case "agent":
+      return "/agent";
+    case "settings":
+      return "/settings";
+    case "team":
+      return "/settings#organization";
+    default:
+      return "/";
+  }
+}
+
+function pathForCommand(command: any): string {
+  const path = pathForView(command?.view);
+  if (path !== "/") return path;
+  const threadId =
+    typeof command?.threadId === "string" ? command.threadId.trim() : "";
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/";
+}
+
+function routerPath(path: string): string {
+  const basePath = appBasePath();
+  if (!basePath) return path;
+  if (path === basePath) return "/";
+  if (path.startsWith(`${basePath}/`)) {
+    return path.slice(basePath.length) || "/";
+  }
+  return path;
+}
+
+function isChatPath(pathname: string): boolean {
+  return pathname === "/" || pathname.startsWith("/chat/");
+}

package/corpus/templates/factory/app/i18n/en-US.ts

@@ -0,0 +1,211 @@
+const messages = {
+  settings: {
+    title: "Settings",
+    description: "Language and workspace preferences for this app.",
+    languageTitle: "Language",
+    languageDescription:
+      "Choose the interface language. This preference is saved for your account.",
+    languageLabel: "Interface language",
+    workspaceTitle: "Workspace",
+    workspaceDescription:
+      "Manage team members, organization access, and shared workspace preferences.",
+    openTeamSettings: "Open team settings",
+    openResourceSettings: "Open resource settings",
+    agentTitle: "Manage agent",
+    agentDescription:
+      "Manage the agent's model, API keys, automations, voice, and other controls.",
+    openAgentSettings: "Manage agent",
+  },
+  chat: {
+    archiveChat: "Archive Chat",
+    archiveFailed: "Archive Failed",
+    chats: "Chats",
+    composerPlaceholder: "Ask the agent...",
+    emptyState: "Ask me anything",
+    heroDescription: "Ask the agent to inspect, explain, or change this app.",
+    heroTitle: "How can I help?",
+    inspectEmptyState: "Ask me anything about this app",
+    inspectSuggestionAction: "Show available actions",
+    inspectSuggestionCapabilities: "What can this app do?",
+    inspectSuggestionHello: "Help me get started",
+    newChat: "New Chat",
+    optionsFor: "Options For",
+    pinChat: "Pin Chat",
+    renameChat: "Rename Chat",
+    renameFailed: "Rename Failed",
+    renameThread: "Rename Thread",
+    suggestionActions: "Show me the available actions",
+    suggestionCapabilities: "What can this app do?",
+    suggestionCustomize: "Help me customize this app",
+    unpinChat: "Unpin Chat",
+  },
+  navigation: {
+    chat: "Chat",
+    collapseSidebar: "Collapse Sidebar",
+    database: "Database",
+    expandSidebar: "Expand Sidebar",
+    extensions: "Extensions",
+    navigation: "Navigation",
+    navigationDescription: "Main navigation",
+    observability: "Observability",
+    openNavigation: "Open navigation",
+    settings: "Settings",
+    team: "Team",
+    triage: "Factory",
+  },
+  triage: {
+    title: "Factory",
+    description: "Build agent factories with gates you control.",
+    queueTitle: "Observation queue",
+    statusFilter: "Status",
+    statusPlaceholder: "All statuses",
+    refresh: "Refresh",
+    queueError: "Could not load the observation queue.",
+    retry: "Retry",
+    loading: "Loading observations...",
+    empty: "No observations yet.",
+    risk: "Risk",
+    status: "Status",
+    coverage: "Coverage",
+    reason: "Reason",
+    detailTitle: "Decision detail",
+    selectItem: "Select an item to inspect its evidence and decisions.",
+    detailError: "Could not load this observation.",
+    openSource: "Open source",
+    decisions: "Shadow decisions",
+    verdict: {
+      correct: "Correct",
+      incorrect: "Incorrect",
+      uncertain: "Uncertain",
+    },
+    notePlaceholder: "Optional note",
+    noteLabel: "Feedback note",
+    submitFeedback: "Record feedback",
+    feedbackError: "Could not record feedback.",
+    noDecisions: "No decisions recorded yet.",
+    rulesTitle: "Triage rules",
+    rulesDescription:
+      "Rules start in shadow mode so you can inspect decisions before enabling work.",
+    newRule: "New rule",
+    ruleError: "Could not load or save rules.",
+    noRules: "No rules configured yet.",
+    shadowOnly: "Shadow mode only",
+    ruleName: "Name",
+    ruleNamePlaceholder: "For example, low-risk docs fixes",
+    rulePrompt: "Classification prompt",
+    rulePromptPlaceholder: "Describe the signal this rule should classify.",
+    hardGuards:
+      "Protected categories always remain blocked: identity, credentials, migrations, payments, security, and publishable packages.",
+    saveRule: "Save rule",
+    ruleSaved: "Rule saved.",
+    settingsTitle: "Observation settings",
+    settingsDescription:
+      "Configure the read-only Slack poller and repository context.",
+    slackWorkspace: "Slack workspace",
+    slackChannelId: "Slack channel ID",
+    slackChannelPlaceholder: "For example, C0123456789",
+    slackChannelName: "Channel name",
+    slackChannelNamePlaceholder: "For example, product-agent-native-feedback",
+    repository: "Repository",
+    repositoryPlaceholder: "For example, BuilderIO/agent-native",
+    enablePolling: "Enable one-minute observation polling",
+    saveSettings: "Save settings",
+    settingsError: "Could not save observation settings.",
+    settingsSaved: "Observation settings saved.",
+    approvalError: "Approval could not be started.",
+  },
+  factoryRoute: {
+    newStep: "New step",
+    newStepDescription: "Describe what this step should do.",
+    newRoute: "new route",
+    newFactory: "New agent factory",
+    newFactoryDescription:
+      "Describe the work this factory turns into shipped outcomes.",
+    selectFactory: "Select factory",
+    askAI: "Ask Factory AI",
+    factoryViews: "Factory views",
+    observeFirst: "Observe-first · shadow mode",
+    mapEyebrow: "Factory map",
+    mapTitle: "From signal to shipped outcome",
+    mapHint: "Select a step or route to edit.",
+    unsavedChanges: "Unsaved visual changes",
+    inboxTitle: "Observation inbox",
+    inboxDescription: "Evidence entering the factory, before autonomous work.",
+    selectObservation:
+      "Select an observation to inspect its path and feedback.",
+    approveAndStart: "Approve and start",
+    rulesDescription: "Every rule is shadow-only until deliberately promoted.",
+    editRule: "Edit triage rule",
+    settingsDescription:
+      "Connect the sources that feed this Factory. These settings only observe; they do not send provider messages.",
+    blueprintTitle: "Blueprint mode.",
+    blueprintDescription:
+      "The current runtime evaluates enabled rules in parallel and stays in shadow mode. This map records the intended handoffs; it does not silently change execution behavior.",
+    metricSignals: "Signals",
+    metricDecisions: "Decisions",
+    metricRuns: "Runs",
+  },
+  factoryCanvas: {
+    dragHint: "Drag to arrange",
+    zoomOut: "Zoom out",
+    zoomIn: "Zoom in",
+    fitToView: "Fit to view",
+    fitFactoryToView: "Fit factory to view",
+    commentFactory: "Comment on this factory",
+    selectRoute: "Select route {route}",
+    addContext: "Add context for this step.",
+    signals: "signals",
+    events: "events",
+    commentOne: "comment",
+    commentMany: "comments",
+  },
+  factoryInspector: {
+    title: "Inspector",
+    askSelection: "Ask the agent about this selection",
+    stepName: "Step name",
+    stepDescription: "What happens here",
+    agentOwner: "Agent or owner",
+    optional: "Optional",
+    connectStep: "Connect this step",
+    connectDescription:
+      "Add a route from this step to another step. Conditions stay visible on the edge so the graph remains explainable.",
+    targetStep: "Target step",
+    chooseTarget: "Choose a target",
+    connectSteps: "Connect steps",
+    removeStep: "Remove step",
+    routeLabel: "Route label",
+    routeCondition: "When does this route run?",
+    routePlaceholder: "For example, when the decision is a low-risk docs fix",
+    factoryComments: "Factory comments",
+    selectionComments: "Comments on this selection",
+    commentEmpty: "Add a note about this part of the factory.",
+    leaveComment: "Leave a comment...",
+    addComment: "Add comment",
+    savingGraph: "Saving graph...",
+    saveGraph: "Save factory changes",
+    savedGraph: "Factory is saved",
+    saveNote: "Saves a new version. Existing runs keep their original context.",
+    factoryName: "Factory name",
+    factoryDescription: "What this factory does",
+    designWithAgent: "Design with the agent",
+    designDescription:
+      "Describe a new factory, ask why an item took a route, or request a change. The agent returns a versioned graph proposal you can inspect.",
+    openCopilot: "Open Factory copilot",
+    addStep: "Add a step",
+  },
+  pages: {
+    databaseTitle: "Database",
+    observabilityPageTitle: "Agent Observability",
+    teamTitle: "Team",
+    teamCreateOrgDescription:
+      "Create an organization to invite teammates and share this app.",
+  },
+  root: {
+    commandActions: "Actions",
+    commandAppearance: "Appearance",
+    commandSearch: "Search",
+    toggleTheme: "Toggle theme",
+  },
+};
+
+export default messages;

package/corpus/templates/factory/app/i18n/index.ts

@@ -0,0 +1,34 @@
+import { type AgentNativeI18nCatalog } from "@agent-native/core/client/i18n";
+
+import enUS from "./en-US";
+
+export const i18nCatalog = {
+  sourceLocale: "en-US",
+  messages: enUS,
+  loadMessages: async (locale) => {
+    switch (locale) {
+      case "zh-CN":
+        return (await import("./zh-CN")).default;
+      case "zh-TW":
+        return (await import("./zh-TW")).default;
+      case "es-ES":
+        return (await import("./es-ES")).default;
+      case "fr-FR":
+        return (await import("./fr-FR")).default;
+      case "de-DE":
+        return (await import("./de-DE")).default;
+      case "ja-JP":
+        return (await import("./ja-JP")).default;
+      case "ko-KR":
+        return (await import("./ko-KR")).default;
+      case "pt-BR":
+        return (await import("./pt-BR")).default;
+      case "hi-IN":
+        return (await import("./hi-IN")).default;
+      case "ar-SA":
+        return (await import("./ar-SA")).default;
+      default:
+        return null;
+    }
+  },
+} satisfies AgentNativeI18nCatalog;