@agentprojectcontext/apx 1.67.0 → 1.69.0

package/src/interfaces/web/src/components/config/project-config-sections.ts

@@ -4,7 +4,10 @@ import { t } from "../../i18n";
 
 // These are functions (not module-level consts) so t() runs per-render with the
 // active locale — a frozen const would lock the strings to the locale at import.
-export function projectOverrideSections(): ConfigSection[] {
+// Config is organized by concept: Settings (routing / super-agent behaviour) and
+// Engines (provider keys) are separate top-level tabs. Telegram is edited on its
+// own channel page (the canonical mechanism), not here.
+export function projectSettingsSections(): ConfigSection[] {
   return [
     {
       key: "routing",
@@ -22,16 +25,11 @@ export function projectOverrideSections(): ConfigSection[] {
         { path: "super_agent.system", label: t("settings_ui.cfg_extra_prompt"), kind: "textarea" },
       ],
     },
-    {
-      key: "telegram",
-      label: t("settings_ui.cfg_telegram_label"),
-      fields: [
-        { path: "telegram.route_to_agent", label: t("settings_ui.cfg_route_to_agent") },
-        { path: "telegram.chat_id", label: t("settings_ui.cfg_chat_id") },
-        { path: "telegram.bot_token", label: t("settings_ui.cfg_bot_token"), kind: "password" },
-        { path: "telegram.respond_with_engine", label: t("settings_ui.cfg_respond_with_engine"), kind: "boolean" },
-      ],
-    },
+  ];
+}
+
+export function projectEnginesSections(): ConfigSection[] {
+  return [
     {
       key: "engines",
       label: t("settings_ui.cfg_engines_label"),

package/src/interfaces/web/src/components/memory/MemoryBrowser.tsx

@@ -0,0 +1,162 @@
+import { useMemo, useState } from "react";
+import useSWR from "swr";
+import { Brain, Bot, Crown, RefreshCw } from "lucide-react";
+import { Agents, Projects } from "../../lib/api";
+import type { AgentEntry, FileContent } from "../../types/daemon";
+import { cn } from "../../lib/cn";
+import { Spinner, Empty } from "../ui";
+import { useToast } from "../Toast";
+import { t } from "../../i18n";
+import { FileViewer } from "../files/FileViewer";
+
+// Which memory is open in the right pane.
+type Sel = { kind: "project" } | { kind: "agent"; slug: string };
+
+function selId(s: Sel): string {
+  return s.kind === "project" ? "project" : `agent:${s.slug}`;
+}
+
+// On-disk-ish path shown in the viewer header (mirrors the real memory.md
+// locations so it reads familiarly, like the docs surface).
+function selPath(s: Sel): string {
+  return s.kind === "project" ? ".apc/memory.md" : `agents/${s.slug}/memory.md`;
+}
+
+function loadBody(pid: string, s: Sel): Promise<string> {
+  return s.kind === "project"
+    ? Projects.memory.get(pid).then((r) => r.body)
+    : Agents.memory.get(pid, s.slug).then((r) => r.body);
+}
+
+function saveBody(pid: string, s: Sel, body: string): Promise<void> {
+  return s.kind === "project"
+    ? Projects.memory.put(pid, body).then(() => {})
+    : Agents.memory.put(pid, s.slug, body).then(() => {});
+}
+
+function SidebarItem({
+  active, onClick, icon: Icon, iconClass, label, sub,
+}: {
+  active: boolean;
+  onClick: () => void;
+  icon: typeof Bot;
+  iconClass?: string;
+  label: string;
+  sub?: string;
+}) {
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      className={cn(
+        "flex w-full items-center gap-2 rounded px-1.5 py-1 text-left text-[13px]",
+        active ? "bg-primary/15 text-foreground" : "text-foreground/80 hover:bg-accent/40",
+      )}
+    >
+      <Icon className={cn("size-3.5 shrink-0", iconClass ?? "text-muted-foreground")} />
+      <span className="min-w-0 flex-1 truncate">{label}</span>
+      {sub && <span className="shrink-0 truncate text-[11px] text-muted-foreground">{sub}</span>}
+    </button>
+  );
+}
+
+// Docs-style two-pane browser for durable memory: a sidebar listing the project
+// ("General") memory plus every agent's memory, and the shared FileViewer on the
+// right for markdown edit / split-preview / save — the same surface as /docs.
+export function MemoryBrowser({ pid }: { pid: string }) {
+  const toast = useToast();
+  const [sel, setSel] = useState<Sel>({ kind: "project" });
+
+  const agents = useSWR(`/projects/${pid}/agents`, () => Agents.list(pid));
+
+  const bodyKey = `/memory/${pid}/${selId(sel)}`;
+  const body = useSWR(bodyKey, () => loadBody(pid, sel));
+
+  // Adapt the raw memory body into the FileContent shape FileViewer expects.
+  const file = useMemo<FileContent | null>(() => {
+    if (body.data === undefined) return null;
+    const content = body.data ?? "";
+    return {
+      path: selPath(sel),
+      name: "memory.md",
+      kind: "markdown",
+      size: content.length,
+      modified: "",
+      encoding: "utf8",
+      content,
+    };
+  }, [body.data, sel]);
+
+  const onSave = async (content: string) => {
+    await saveBody(pid, sel, content);
+    toast.success(t("project.memories.saved"));
+    void body.mutate(content, { revalidate: false });
+  };
+
+  const list = (agents.data || []) as AgentEntry[];
+
+  return (
+    <div className="flex h-full min-h-0 overflow-hidden rounded-xl border border-border bg-card">
+      {/* Sidebar */}
+      <div className="flex w-64 shrink-0 flex-col border-r border-border">
+        <div className="flex shrink-0 items-center gap-2 border-b border-border px-3 py-2">
+          <Brain className="size-4 text-muted-foreground" />
+          <span className="flex-1 text-xs font-semibold uppercase tracking-wide text-muted-foreground">
+            {t("project.memories.sidebar_title")}
+          </span>
+          <button
+            type="button"
+            onClick={() => { void agents.mutate(); void body.mutate(); }}
+            className="text-muted-foreground hover:text-foreground"
+            aria-label={t("common.refresh")}
+          >
+            <RefreshCw className={agents.isValidating ? "size-3.5 animate-spin" : "size-3.5"} />
+          </button>
+        </div>
+
+        <div className="min-h-0 flex-1 overflow-y-auto p-1.5">
+          {/* General / project memory */}
+          <p className="px-1.5 pb-1 pt-1 text-[10px] font-semibold uppercase tracking-wide text-muted-foreground/60">
+            {t("project.memories.general_group")}
+          </p>
+          <SidebarItem
+            active={sel.kind === "project"}
+            onClick={() => setSel({ kind: "project" })}
+            icon={Brain}
+            iconClass="text-sky-500"
+            label={t("project.memories.general_item")}
+          />
+
+          {/* Agent memories */}
+          <p className="px-1.5 pb-1 pt-3 text-[10px] font-semibold uppercase tracking-wide text-muted-foreground/60">
+            {t("project.memories.agents_title")}
+          </p>
+          {agents.isLoading ? (
+            <div className="flex justify-center py-4"><Spinner size={14} /></div>
+          ) : list.length === 0 ? (
+            <div className="px-1.5 py-2">
+              <Empty>{t("project.memories.no_agents")}</Empty>
+            </div>
+          ) : (
+            list.map((a) => (
+              <SidebarItem
+                key={a.slug}
+                active={sel.kind === "agent" && sel.slug === a.slug}
+                onClick={() => setSel({ kind: "agent", slug: a.slug })}
+                icon={a.is_master ? Crown : Bot}
+                iconClass={a.is_master ? "text-violet-400" : "text-muted-foreground"}
+                label={a.slug}
+                sub={a.role || undefined}
+              />
+            ))
+          )}
+        </div>
+      </div>
+
+      {/* Viewer */}
+      <div className="flex min-w-0 flex-1 flex-col">
+        <FileViewer file={file} loading={body.isLoading} onSave={onSave} />
+      </div>
+    </div>
+  );
+}

package/src/interfaces/web/src/i18n/en.ts

@@ -324,6 +324,9 @@ export const en = {
       specialists: "Specialists",
       recent_tasks: "Recent tasks",
       no_activity: "No open tasks.",
+      brain_title: "Team brain",
+      brain_desc: "The whole agent map — orchestrators at the core, their specialists clustered around them. Click a node to open it.",
+      brain_core: "Team",
     },
 
     artifacts: {
@@ -711,6 +714,8 @@ export const en = {
       save_fields_success: "Overrides saved.",
       save_meta_success: "Project metadata saved.",
       no_data:     "No data.",
+      tab_settings: "Settings",
+      tab_project:  "Project",
     },
 
     telegram: {
@@ -731,6 +736,9 @@ export const en = {
     },
 
     memories: {
+      sidebar_title:   "Memories",
+      general_group:   "General",
+      general_item:    "Project memory",
       project_title:   "Project memory",
       project_desc:    "Durable facts at the project level. .apc/memory.md — read by agents and the super-agent.",
       project_ph:      "# Project Memory\n\nStable facts that any agent should know…",
@@ -756,6 +764,7 @@ export const en = {
     workspaces_empty:   "No projects. Add one with the button above.",
     sessions_title:     "Sessions",
     sessions_desc:      "Sessions from all engines (apx · claude · codex), newest first.",
+    sessions_desc_scoped: "Sessions in this project's folder ({path}), all engines, newest first.",
     sessions_all:       "All engines",
     sessions_empty:     "No sessions.",
     sessions_error:     "Could not read sessions: {msg}",
@@ -1477,6 +1486,7 @@ export const en = {
     stat_records:            "Records",
     stat_tasks:              "Tasks",
     stat_heartbeats:         "Heartbeats",
+    uncategorized:           "Uncategorized",
     config_def_desc:         "definition (frontmatter + system prompt).",
     memory_durable_desc:     "durable facts the agent remembers.",
     running:                 "running",

package/src/interfaces/web/src/i18n/es.ts

@@ -325,6 +325,9 @@ export const es = {
       specialists: "Especialistas",
       recent_tasks: "Tasks recientes",
       no_activity: "No hay tasks abiertas.",
+      brain_title: "Cerebro del equipo",
+      brain_desc: "El mapa completo de agentes — los orquestadores en el núcleo y sus especialistas en racimo alrededor. Clic en un nodo para abrirlo.",
+      brain_core: "Equipo",
     },
 
     artifacts: {
@@ -709,6 +712,8 @@ export const es = {
       save_fields_success: "Overrides guardados.",
       save_meta_success: "Project metadata guardado.",
       no_data:     "Sin datos.",
+      tab_settings: "Settings",
+      tab_project:  "Project",
     },
 
     telegram: {
@@ -729,6 +734,9 @@ export const es = {
     },
 
     memories: {
+      sidebar_title:   "Memorias",
+      general_group:   "General",
+      general_item:    "Memoria del proyecto",
       project_title:   "Memoria del proyecto",
       project_desc:    "Hechos durables a nivel proyecto. .apc/memory.md — la leen los agentes y el super-agente.",
       project_ph:      "# Memoria del proyecto\n\nHechos estables que cualquier agente debería saber…",
@@ -754,6 +762,7 @@ export const es = {
     workspaces_empty:   "Sin proyectos. Agregá uno con el botón de arriba.",
     sessions_title:     "Sessions",
     sessions_desc:      "Sesiones de todos los engines (apx · claude · codex), más nuevas primero.",
+    sessions_desc_scoped: "Sesiones en la carpeta de este proyecto ({path}), todos los engines, más nuevas primero.",
     sessions_all:       "Todos los engines",
     sessions_empty:     "Sin sesiones.",
     sessions_error:     "No pude leer las sesiones: {msg}",
@@ -1475,6 +1484,7 @@ export const es = {
     stat_records:            "Records",
     stat_tasks:              "Tasks",
     stat_heartbeats:         "Heartbeats",
+    uncategorized:           "Sin categoría",
     config_def_desc:         "definición (frontmatter + system prompt).",
     memory_durable_desc:     "hechos durables que el agente recuerda.",
     running:                 "running",

package/src/interfaces/web/src/lib/api/agents.ts

@@ -2,7 +2,8 @@ import { http } from "../http";
 import type { AgentDetail, AgentEntry } from "../../types/daemon";
 
 export const Agents = {
-  list:   (pid: string) => http.get<AgentEntry[]>(`/projects/${pid}/agents`),
+  list:   (pid: string, opts?: { stats?: boolean }) =>
+    http.get<AgentEntry[]>(`/projects/${pid}/agents${opts?.stats ? "?stats=1" : ""}`),
   get:    (pid: string, slug: string) => http.get<AgentDetail>(`/projects/${pid}/agents/${slug}`),
   create: (pid: string, body: Partial<AgentEntry> & { slug: string }) =>
     http.post<AgentEntry>(`/projects/${pid}/agents`, body),

package/src/interfaces/web/src/lib/api/sessions.ts

@@ -19,11 +19,12 @@ export const Sessions = {
       .then((b) => ({ sessions: unwrapPage<SessionRow>(b).items })),
   // Server-paginated page. Optional `q` runs the same search core as
   // `apx session find` (title; + transcript content when `deep`).
-  page: ({ engine, q, deep, limit, offset }: { engine?: string; q?: string; deep?: boolean; limit: number; offset: number }) => {
+  page: ({ engine, q, deep, cwd, limit, offset }: { engine?: string; q?: string; deep?: boolean; cwd?: string; limit: number; offset: number }) => {
     const params = new URLSearchParams({ limit: String(limit), offset: String(offset) });
     if (engine) params.set("engine", engine);
     if (q?.trim()) params.set("q", q.trim());
     if (deep) params.set("deep", "1");
+    if (cwd?.trim()) params.set("cwd", cwd.trim());
     return http.get<unknown>(`/sessions?${params.toString()}`).then((b) => unwrapPage<SessionRow>(b));
   },
 };

package/src/interfaces/web/src/screens/ProjectScreen.tsx

@@ -1,8 +1,8 @@
 import { useMemo } from "react";
 import { useParams, Routes, Route, Navigate, useLocation, useNavigate } from "react-router-dom";
 import {
-  Bot, Heart, Zap, Puzzle, FolderKanban, Settings,
-  MessagesSquare, Send, KeyRound,
+  Bot, Heart, Zap, Puzzle, Settings,
+  MessagesSquare, KeyRound,
   LayoutDashboard, Boxes, Cpu, ScrollText, History, Brain, FileCode2, Cable,
   Building2, FileText, FolderTree, Sparkles,
 } from "lucide-react";
@@ -40,7 +40,7 @@ import { SkillsTab } from "./project/SkillsTab";
 type NavKey =
   | "" | "chat" | "config" | "telegram"
   | "agents" | "routines" | "tasks" | "mcps" | "integrations" | "vars" | "logs" | "memories" | "artifacts"
-  | "structure" | "docs" | "files" | "skills";
+  | "structure" | "docs" | "files" | "skills" | "sessions";
 
 export function ProjectScreen() {
   const navigate = useNavigate();
@@ -51,85 +51,75 @@ export function ProjectScreen() {
 
   const isBase = String(pid) === "0";
   const sections: TabSection[] = useMemo(() => {
-    if (isBase) {
-      // Base = menú global / admin del daemon (distinto al de un proyecto).
-      return [
-        {
-          title: t("base.nav_general"),
-          items: [
-            { key: "",               label: "Dashboard",                    icon: LayoutDashboard },
-            { key: "workspaces",     label: t("base.workspaces_title"),     icon: Boxes },
-            { key: "models",         label: t("settings.tabs.engines"),     icon: Cpu },
-            { key: "agent-defaults", label: t("base.defaults_title"),       icon: Bot },
-          ],
-        },
-        {
-          title: t("base.nav_activity"),
-          items: [
-            { key: "chat",     label: t("project.nav.chat"),     icon: MessagesSquare },
-            { key: "sessions", label: t("base.sessions_title"),  icon: History },
-            { key: "tasks",    label: t("project.nav.tasks"),    icon: Zap },
-            { key: "logs",     label: t("project.nav.logs"),     icon: ScrollText },
-          ],
-        },
-        {
-          title: t("base.nav_system"),
-          items: [
-            { key: "agents",   label: t("project.nav.agents"),   icon: Bot },
-            { key: "memories", label: t("project.nav.memories"), icon: Brain },
-            { key: "skills",   label: t("skills_page.title"),    icon: Sparkles },
-            { key: "routines",  label: t("project.nav.routines"),  icon: Heart },
-            { key: "mcps",      label: t("project.nav.mcps"),      icon: Puzzle },
-            { key: "integrations", label: "Integrations",          icon: Cable },
-            { key: "vars",      label: t("project.nav.vars"),      icon: KeyRound },
-            { key: "artifacts", label: t("project.nav.artifacts"), icon: FileCode2 },
-            { key: "config",    label: t("project.nav.config"),    icon: Settings },
-          ],
-        },
-      ];
-    }
-    // Structure (org roles/areas) is only meaningful for company/enterprise
-    // projects — gate it on the project kind.
-    const isCompany = project?.kind === "company";
-    return [
+    // One shared taxonomy for both Base and projects, in the same order, so the
+    // two menus mirror each other. Base additionally gets a "General" admin
+    // section (workspaces / engines / agent defaults) and drops "Content"
+    // (no docs/files surface). "Workspace" and "Automation" are identical on
+    // both. Structure (org roles/areas) only makes sense for company projects.
+    const isCompany = !isBase && project?.kind === "company";
+
+    const out: (TabSection | null)[] = [
+      // General — Base-only daemon admin.
+      isBase ? {
+        title: t("base.nav_general"),
+        items: [
+          { key: "workspaces",     label: t("base.workspaces_title"), icon: Boxes },
+          { key: "models",         label: t("settings.tabs.engines"), icon: Cpu },
+          { key: "agent-defaults", label: t("base.defaults_title"),   icon: Bot },
+        ],
+      } : null,
+      // Workspace — the overview plus the team's own building blocks
+      // (agents / memories / skills / artifacts). "Overview" on both sides.
       {
         title: t("project.sections.workspace"),
         items: [
-          { key: "",         label: t("project.nav.overview"),  icon: FolderKanban },
-          { key: "telegram", label: t("project.nav.telegram"),  icon: Send },
-          { key: "chat",     label: t("project.nav.chat"),      icon: MessagesSquare },
-          { key: "agents",   label: t("project.nav.agents"),    icon: Bot },
+          { key: "", label: t("project.nav.overview"), icon: LayoutDashboard },
           ...(isCompany ? [{ key: "structure", label: t("project.nav.structure"), icon: Building2 }] : []),
-          { key: "memories", label: t("project.nav.memories"),  icon: Brain },
-          { key: "skills",   label: t("skills_page.title"),     icon: Sparkles },
+          { key: "agents",    label: t("project.nav.agents"),    icon: Bot },
+          { key: "memories",  label: t("project.nav.memories"),  icon: Brain },
+          { key: "skills",    label: t("skills_page.title"),     icon: Sparkles },
+          { key: "artifacts", label: t("project.nav.artifacts"), icon: FileCode2 },
         ],
       },
+      // Activity — chat / sessions / logs.
       {
+        title: t("base.nav_activity"),
+        items: [
+          { key: "chat", label: t("project.nav.chat"), icon: MessagesSquare },
+          { key: "sessions", label: t("base.sessions_title"), icon: History },
+          { key: "logs", label: t("project.nav.logs"), icon: ScrollText },
+        ],
+      },
+      // Content — docs / files. Project-only (Base has no such surface).
+      !isBase ? {
         title: t("project.sections.content"),
         items: [
           { key: "docs",  label: t("project.nav.docs"),  icon: FileText },
           { key: "files", label: t("project.nav.files"), icon: FolderTree },
         ],
-      },
+      } : null,
+      // Automation — routines / tasks / mcps / integrations / vars.
+      // Identical on both sides.
       {
         title: t("project.sections.automation"),
         items: [
-          { key: "routines",  label: t("project.nav.routines"),  icon: Heart },
-          { key: "tasks",     label: t("project.nav.tasks"),     icon: Zap },
-          { key: "mcps",      label: t("project.nav.mcps"),      icon: Puzzle },
-          { key: "integrations", label: "Integrations",          icon: Cable },
-          { key: "vars",      label: t("project.nav.vars"),      icon: KeyRound },
-          { key: "artifacts", label: t("project.nav.artifacts"), icon: FileCode2 },
-          { key: "logs",      label: t("project.nav.logs"),      icon: ScrollText },
+          { key: "routines",     label: t("project.nav.routines"),  icon: Heart },
+          { key: "tasks",        label: t("project.nav.tasks"),     icon: Zap },
+          { key: "mcps",         label: t("project.nav.mcps"),      icon: Puzzle },
+          { key: "integrations", label: "Integrations",             icon: Cable },
+          { key: "vars",         label: t("project.nav.vars"),      icon: KeyRound },
         ],
       },
+      // Config — the general project/daemon config.
       {
         title: t("project.sections.config"),
         items: [
-          { key: "config",   label: t("project.nav.config"),    icon: Settings },
+          { key: "config", label: t("project.nav.config"), icon: Settings },
         ],
       },
     ];
+
+    return out.filter(Boolean) as TabSection[];
   }, [isBase, project?.kind]);
 
   // First path segment after /p/:pid — so deep routes like agents/:slug still
@@ -171,7 +161,7 @@ export function ProjectScreen() {
         <Route path="workspaces"   element={<WorkspacesTab />} />
         <Route path="models"       element={<ModelsTab />} />
         <Route path="agent-defaults" element={<AgentDefaultsTab />} />
-        <Route path="sessions"     element={<SessionsTab />} />
+        <Route path="sessions"     element={<SessionsTab pid={pid} />} />
         <Route path="logs"         element={<LogsTab pid={pid} />} />
         <Route path="config"       element={<ConfigTab pid={pid} />} />
         <Route path="telegram"     element={<TelegramTab pid={pid} />} />

package/src/interfaces/web/src/screens/base/SessionsTab.tsx

@@ -7,15 +7,21 @@ import { Badge, Button, Empty, Input, Loading, Tip } from "../../components/ui";
 import { UiSelect } from "../../components/UiSelect";
 import { useToast } from "../../components/Toast";
 import { usePersonaName } from "../../hooks/usePersonaName";
+import { useProject } from "../../hooks/useProjects";
 import { t } from "../../i18n";
 
 const ENGINE_TONE: Record<string, "success" | "info" | "warning" | "muted"> = {
   apx: "success", claude: "info", codex: "warning",
 };
 
-export function SessionsTab() {
+// `pid` present + not base → scope to that project's local folder. Base (or no
+// pid) shows every session across engines and folders.
+export function SessionsTab({ pid }: { pid?: string } = {}) {
   const toast = useToast();
   const persona = usePersonaName();
+  const isBase = !pid || String(pid) === "0";
+  const { project } = useProject(isBase ? "" : pid);
+  const cwd = isBase ? undefined : project?.path || undefined;
   const [engine, setEngine] = useState("");
   const [input, setInput] = useState("");
   const [query, setQuery] = useState("");
@@ -28,10 +34,10 @@ export function SessionsTab() {
   }, [input]);
 
   const paged = usePagedQuery<SessionRow>({
-    key: `/sessions?engine=${engine}&q=${query}&deep=${deep ? 1 : 0}`,
+    key: `/sessions?engine=${engine}&q=${query}&deep=${deep ? 1 : 0}&cwd=${cwd || ""}`,
     fetchPage: (limit, offset) =>
-      Sessions.page({ engine: engine || undefined, q: query || undefined, deep, limit, offset }),
-    resetKey: `${engine}|${query}|${deep ? 1 : 0}`,
+      Sessions.page({ engine: engine || undefined, q: query || undefined, deep, cwd, limit, offset }),
+    resetKey: `${engine}|${query}|${deep ? 1 : 0}|${cwd || ""}`,
   });
 
   const clear = () => { setInput(""); setQuery(""); setEngine(""); setDeep(false); };
@@ -72,7 +78,7 @@ export function SessionsTab() {
     <Section
       fullHeight
       title={t("base.sessions_title")}
-      description={t("base.sessions_desc")}
+      description={isBase ? t("base.sessions_desc") : t("base.sessions_desc_scoped", { path: cwd || "…" })}
       action={
         <Tip content={t("base.sessions_refresh")}>
           <Button size="sm" variant="secondary" onClick={() => paged.mutate()}><RefreshCw size={13} /></Button>