@agentprojectcontext/apx 1.74.2 → 1.76.0

package/src/interfaces/web/src/components/settings/ProfilePanel.tsx

@@ -0,0 +1,245 @@
+import { useEffect, useState } from "react";
+import { AlertTriangle, CheckCircle2, Info } from "lucide-react";
+import { Section } from "../Section";
+import { Badge, Button, Dialog, Empty, Field, Input, Loading } from "../ui";
+import { UiSelect } from "../UiSelect";
+import { useToast } from "../Toast";
+import { useProfiles, useProfile, useProfileDoctor } from "../../hooks/useProfiles";
+import { ProfilesApi, type ProfileSchemaProp } from "../../lib/api/profiles";
+import { t } from "../../i18n";
+
+/**
+ * Agent profiles — an installable line of work for the super-agent.
+ *
+ * Not to be confused with the agent's persona (its visible name, under
+ * Identity), nor with configuration profiles. With none active, APX behaves
+ * exactly as it always has, and the panel says so rather than looking broken.
+ */
+export function ProfilePanel() {
+  const toast = useToast();
+  const { active, profiles, isLoading, mutate } = useProfiles();
+  const [selectedId, setSelectedId] = useState<string | null>(null);
+
+  const currentId = selectedId ?? active ?? profiles[0]?.id ?? null;
+  const { profile, mutate: mutateProfile } = useProfile(currentId);
+  const { doctor, mutate: mutateDoctor } = useProfileDoctor(active);
+
+  const [draft, setDraft] = useState<Record<string, string>>({});
+  const [busy, setBusy] = useState(false);
+  const [confirmOff, setConfirmOff] = useState(false);
+
+  useEffect(() => {
+    if (!profile) return;
+    const next: Record<string, string> = {};
+    for (const [k, v] of Object.entries(profile.config || {})) next[k] = String(v ?? "");
+    setDraft(next);
+  }, [profile?.id, profile?.config]);
+
+  const refreshAll = async () => {
+    await Promise.all([mutate(), mutateProfile(), mutateDoctor()]);
+  };
+
+  if (isLoading) return <Loading />;
+
+  const activate = async (id: string, force: boolean) => {
+    setBusy(true);
+    try {
+      const r = await ProfilesApi.use(id, force);
+      for (const w of r.warnings || []) toast.error(w);
+      await refreshAll();
+      toast.success(t("settings.profile.activated"));
+    } catch (e) {
+      toast.error((e as Error).message);
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const deactivate = async () => {
+    setBusy(true);
+    try {
+      await ProfilesApi.off();
+      await refreshAll();
+      toast.success(t("settings.profile.deactivated"));
+    } catch (e) {
+      toast.error((e as Error).message);
+    } finally {
+      setBusy(false);
+      setConfirmOff(false);
+    }
+  };
+
+  const saveConfig = async () => {
+    if (!profile) return;
+    setBusy(true);
+    try {
+      const r = await ProfilesApi.setConfig(draft, profile.id);
+      await refreshAll();
+      const moved = r.routines?.installed?.length ?? 0;
+      toast.success(
+        moved > 0 ? t("settings.profile.saved_with_routines") : t("settings.profile.saved"),
+      );
+    } catch (e) {
+      toast.error((e as Error).message);
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const props: Record<string, ProfileSchemaProp> = profile?.schema?.properties || {};
+  const overBudget = !!profile?.budget && !!profile?.tokens && profile.tokens > profile.budget;
+
+  return (
+    <div className="flex flex-col gap-4" data-testid="profile-panel">
+      <Section
+        title={t("settings.profile.title")}
+        description={t("settings.profile.subtitle")}
+      >
+        {!active ? (
+          <div
+            data-testid="profile-vanilla-hint"
+            className="mb-3 flex items-start gap-2 rounded-md border border-border bg-muted/40 p-3 text-sm"
+          >
+            <Info size={16} className="mt-0.5 shrink-0 opacity-70" />
+            <span>{t("settings.profile.vanilla_hint")}</span>
+          </div>
+        ) : null}
+
+        {!profiles.length ? (
+          <Empty>{t("settings.profile.none_available")}</Empty>
+        ) : (
+          <div className="flex flex-col gap-2">
+            {profiles.map((p) => (
+              <button
+                key={p.id}
+                data-testid={`profile-row-${p.id}`}
+                type="button"
+                onClick={() => setSelectedId(p.id)}
+                className={`flex items-start justify-between gap-3 rounded-md border p-3 text-left transition ${
+                  p.id === currentId ? "border-primary bg-muted/40" : "border-border hover:bg-muted/20"
+                }`}
+              >
+                <span className="min-w-0">
+                  <span className="flex items-center gap-2">
+                    <span className="font-medium">{p.name}</span>
+                    <Badge>{p.source}</Badge>
+                    {p.active ? <Badge tone="success">{t("settings.profile.active")}</Badge> : null}
+                  </span>
+                  {p.description ? (
+                    <span className="mt-0.5 block text-sm opacity-70">{p.description}</span>
+                  ) : null}
+                </span>
+                <span className="shrink-0 text-xs opacity-60">{p.version ? `v${p.version}` : ""}</span>
+              </button>
+            ))}
+          </div>
+        )}
+
+        {profile ? (
+          <div className="mt-4 flex flex-wrap items-center gap-2">
+            {profile.active ? (
+              <Button variant="destructive" loading={busy} onClick={() => setConfirmOff(true)}>
+                {t("settings.profile.deactivate")}
+              </Button>
+            ) : (
+              <Button variant="primary" loading={busy} onClick={() => activate(profile.id, !!active)}>
+                {active ? t("settings.profile.replace_active") : t("settings.profile.activate")}
+              </Button>
+            )}
+            <span className="text-xs opacity-60">
+              {t("settings.profile.token_cost")}: ~{profile.tokens ?? 0}
+              {profile.budget ? ` / ${profile.budget}` : ""}
+              {overBudget ? ` — ${t("settings.profile.over_budget")}` : ""}
+            </span>
+          </div>
+        ) : null}
+      </Section>
+
+      {profile && Object.keys(props).length ? (
+        <Section
+          title={t("settings.profile.settings_title")}
+          description={t("settings.profile.settings_subtitle")}
+        >
+          <div className="grid grid-cols-2 gap-3">
+            {Object.entries(props).map(([key, def]) => (
+              <Field key={key} label={def.title || key} hint={def.description}>
+                {def.enum ? (
+                  <UiSelect
+                    value={draft[key] ?? String(def.default ?? "")}
+                    onChange={(v) => setDraft({ ...draft, [key]: v })}
+                    options={def.enum.map((o) => ({ value: String(o), label: String(o) }))}
+                  />
+                ) : (
+                  <Input
+                    value={draft[key] ?? ""}
+                    onChange={(e) => setDraft({ ...draft, [key]: e.target.value })}
+                  />
+                )}
+              </Field>
+            ))}
+          </div>
+          <div className="mt-4">
+            <Button variant="primary" loading={busy} onClick={saveConfig}>
+              {t("common.save")}
+            </Button>
+          </div>
+        </Section>
+      ) : null}
+
+      {active && doctor ? (
+        <Section title={t("settings.profile.doctor_title")} description={doctor.summary}>
+          {!doctor.checks.length ? (
+            <div className="flex items-center gap-2 text-sm">
+              <CheckCircle2 size={16} className="text-emerald-500" />
+              {t("settings.profile.doctor_clean")}
+            </div>
+          ) : (
+            <ul className="flex flex-col gap-2">
+              {doctor.checks.map((c, i) => (
+                <li key={i} className="flex items-start gap-2 text-sm">
+                  <AlertTriangle
+                    size={16}
+                    className={`mt-0.5 shrink-0 ${c.level === "error" ? "text-red-500" : "text-amber-500"}`}
+                  />
+                  <span className="min-w-0">
+                    <span className="opacity-60">[{c.label}]</span> {c.detail}
+                    {c.fix ? (
+                      <code className="mt-1 block rounded bg-muted px-1.5 py-0.5 text-xs">{c.fix}</code>
+                    ) : null}
+                  </span>
+                </li>
+              ))}
+            </ul>
+          )}
+        </Section>
+      ) : null}
+
+      {profile ? (
+        <Section
+          title={t("settings.profile.preview_title")}
+          description={t("settings.profile.preview_subtitle")}
+        >
+          <pre data-testid="profile-preview" className="max-h-96 overflow-auto whitespace-pre-wrap rounded-md border border-border bg-muted/30 p-3 text-xs leading-relaxed">
+            {profile.preview || t("settings.profile.preview_empty")}
+          </pre>
+        </Section>
+      ) : null}
+
+      <Dialog
+        open={confirmOff}
+        onClose={() => setConfirmOff(false)}
+        title={t("settings.profile.deactivate_title")}
+        footer={
+          <>
+            <Button onClick={() => setConfirmOff(false)}>{t("common.cancel")}</Button>
+            <Button variant="destructive" loading={busy} onClick={deactivate}>
+              {t("settings.profile.deactivate")}
+            </Button>
+          </>
+        }
+      >
+        {t("settings.profile.deactivate_confirm")}
+      </Dialog>
+    </div>
+  );
+}

package/src/interfaces/web/src/hooks/useProfiles.ts

@@ -0,0 +1,37 @@
+import useSWR from "swr";
+import { ProfilesApi } from "../lib/api/profiles";
+import type { ProfileDetail, ProfileDoctor, ProfileSummary } from "../lib/api/profiles";
+
+/** The catalogue of agent profiles, plus which one is active. */
+export function useProfiles() {
+  const { data, error, isLoading, mutate } = useSWR<{
+    active: string | null;
+    profiles: ProfileSummary[];
+  }>("/profiles", () => ProfilesApi.list());
+
+  return {
+    active: data?.active ?? null,
+    profiles: data?.profiles ?? [],
+    error,
+    isLoading,
+    mutate,
+  };
+}
+
+/** One profile, including its schema, settings and rendered prompt preview. */
+export function useProfile(id: string | null) {
+  const { data, error, isLoading, mutate } = useSWR<ProfileDetail>(
+    id ? `/profiles/${id}` : null,
+    () => ProfilesApi.get(id as string),
+  );
+  return { profile: data, error, isLoading, mutate };
+}
+
+/** Health of the active profile (or a named one). */
+export function useProfileDoctor(id: string | null) {
+  const { data, error, isLoading, mutate } = useSWR<ProfileDoctor>(
+    id ? `/profiles/doctor?id=${id}` : "/profiles/doctor",
+    () => ProfilesApi.doctor(id || undefined),
+  );
+  return { doctor: data, error, isLoading, mutate };
+}

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

@@ -192,12 +192,43 @@ export const en = {
     tabs: {
       identity: "Identity",
       super_agent: "Super-agent",
+      profile: "Agent profile",
       engines: "Engines & models",
       telegram: "Telegram",
       devices: "Devices",
       advanced: "Advanced",
     },
 
+    profile: {
+      title: "Agent profile",
+      subtitle:
+        "An installable line of work for the super-agent: what it does with its day and when it speaks to you. Distinct from the agent's name (that lives under Identity).",
+      vanilla_hint:
+        "No profile is active. APX behaves exactly as it always has — the super-agent prompt is identical to a clean install.",
+      none_available: "No profiles available yet.",
+      active: "active",
+      activate: "Activate",
+      replace_active: "Replace the active one",
+      deactivate: "Deactivate",
+      deactivate_title: "Deactivate the profile?",
+      deactivate_confirm:
+        "APX goes back to vanilla. The profile's routines are disabled but not deleted, and your settings, tasks and memory are untouched — activating it again restores everything.",
+      activated: "Profile active",
+      deactivated: "Profile off — APX is back to vanilla",
+      token_cost: "Prompt cost",
+      over_budget: "over its declared budget",
+      settings_title: "Profile settings",
+      settings_subtitle:
+        "Blank fields fall back to the package default. Changing a time really reschedules the routine.",
+      saved: "Settings saved",
+      saved_with_routines: "Settings saved and routines rescheduled",
+      doctor_title: "Doctor",
+      doctor_clean: "All good.",
+      preview_title: "Prompt block",
+      preview_subtitle: "Exactly what reaches the model, with your values substituted.",
+      preview_empty: "(empty)",
+    },
+
     identity: {
       title: "Identity",
       subtitle: "User data. Agent configuration goes in Super-agent.",
@@ -395,6 +426,7 @@ export const en = {
     },
 
     global_tasks: {
+      any_status: "any status",
       title:       "Tasks (all projects)",
       subtitle:    "Aggregated tasks from all registered projects.",
       empty:       "No tasks.",

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

@@ -193,12 +193,43 @@ export const es = {
     tabs: {
       identity: "Identidad",
       super_agent: "Super-agente",
+      profile: "Perfil del agente",
       engines: "Engines & modelos",
       telegram: "Telegram",
       devices: "Dispositivos",
       advanced: "Avanzado",
     },
 
+    profile: {
+      title: "Perfil del agente",
+      subtitle:
+        "Un oficio instalable para el super-agente: qué hace con su día y cuándo te habla. Distinto del nombre del agente (eso está en Identidad).",
+      vanilla_hint:
+        "No hay ningún perfil activo. APX se comporta exactamente como siempre — el prompt del super-agente es idéntico al de una instalación limpia.",
+      none_available: "No hay perfiles disponibles todavía.",
+      active: "activo",
+      activate: "Activar",
+      replace_active: "Reemplazar el activo",
+      deactivate: "Desactivar",
+      deactivate_title: "¿Desactivar el perfil?",
+      deactivate_confirm:
+        "APX vuelve a vanilla. Las rutinas del perfil se deshabilitan pero no se borran, y tu configuración, tareas y memoria quedan intactas: volver a activarlo restaura todo.",
+      activated: "Perfil activo",
+      deactivated: "Perfil desactivado — APX está en vanilla",
+      token_cost: "Costo de prompt",
+      over_budget: "excede su presupuesto declarado",
+      settings_title: "Configuración del perfil",
+      settings_subtitle:
+        "Los valores en blanco toman el default del paquete. Cambiar un horario reprograma la rutina de verdad.",
+      saved: "Configuración guardada",
+      saved_with_routines: "Configuración guardada y rutinas reprogramadas",
+      doctor_title: "Diagnóstico",
+      doctor_clean: "Todo en orden.",
+      preview_title: "Bloque de prompt",
+      preview_subtitle: "Exactamente lo que recibe el modelo, con tus valores ya sustituidos.",
+      preview_empty: "(vacío)",
+    },
+
     identity: {
       title: "Identidad",
       subtitle: "Datos del usuario. Configuración del agente va en Super-agente.",
@@ -396,6 +427,7 @@ export const es = {
     },
 
     global_tasks: {
+      any_status: "cualquier estado",
       title:       "Tasks (todos los proyectos)",
       subtitle:    "Tareas agregadas de todos los proyectos registrados.",
       empty:       "Sin tasks.",

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

@@ -0,0 +1,86 @@
+import { http } from "../http";
+
+/** A property of a profile's config.schema.json (the supported subset). */
+export type ProfileSchemaProp = {
+  type?: "string" | "integer" | "number" | "boolean";
+  enum?: (string | number | boolean)[];
+  default?: string | number | boolean;
+  title?: string;
+  description?: string;
+};
+
+export type ProfileSchema = {
+  type?: string;
+  properties?: Record<string, ProfileSchemaProp>;
+};
+
+export type ProfileSummary = {
+  id: string;
+  name: string;
+  version: string | null;
+  description: string;
+  author: string | null;
+  languages: string[];
+  source: "bundled" | "user" | "user-override";
+  active: boolean;
+  dir: string;
+};
+
+export type ProfileDetail = ProfileSummary & {
+  provides: Record<string, string[]>;
+  requires: Record<string, string[]>;
+  schema: ProfileSchema | null;
+  defaults: Record<string, unknown>;
+  config: Record<string, unknown>;
+  budget: number | null;
+  tokens: number | null;
+  /** The rendered prompt block, exactly as it reaches the model. */
+  preview: string;
+};
+
+export type ProfileCheck = {
+  level: "error" | "warn";
+  label: string;
+  detail: string;
+  fix: string | null;
+};
+
+export type ProfileDoctor = {
+  id: string | null;
+  active: boolean;
+  ok: boolean;
+  tokens?: number;
+  budget?: number | null;
+  checks: ProfileCheck[];
+  summary: string;
+};
+
+export type ProfileRoutineSync = {
+  installed: string[];
+  skipped: { name: string; reason: string }[];
+};
+
+export const ProfilesApi = {
+  list: () => http.get<{ active: string | null; profiles: ProfileSummary[] }>("/profiles"),
+  get: (id: string) => http.get<ProfileDetail>(`/profiles/${encodeURIComponent(id)}`),
+  doctor: (id?: string) =>
+    http.get<ProfileDoctor>(`/profiles/doctor${id ? `?id=${encodeURIComponent(id)}` : ""}`),
+  install: (source: string, force = false) =>
+    http.post<{ ok: true; profile: ProfileDetail; warnings: string[]; tokens: number }>(
+      "/profiles/install",
+      { source, force }
+    ),
+  use: (id: string, force = false) =>
+    http.post<{ ok: true; profile: ProfileDetail; routines: ProfileRoutineSync; warnings: string[] }>(
+      "/profiles/use",
+      { id, force }
+    ),
+  off: () => http.post<{ ok: true; was: string | null; routines: string[] }>("/profiles/off", {}),
+  setConfig: (values: Record<string, unknown>, id?: string) =>
+    http.patch<{ ok: true; config: Record<string, unknown>; changed: string[]; routines: ProfileRoutineSync }>(
+      "/profiles/config",
+      { values, id }
+    ),
+  uninstall: (id: string) =>
+    http.del<{ ok: true; id: string; source: string }>(`/profiles/${encodeURIComponent(id)}`),
+};

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

@@ -25,8 +25,12 @@ export const Tasks = {
   // (globalPage). Each returns the requested window plus the full total.
   listPage: (pid: string, { state, limit, offset }: { state: TaskEntry["state"] | "all"; limit: number; offset: number }) =>
     http.get<unknown>(`/projects/${pid}/tasks?state=${state}&limit=${limit}&offset=${offset}`).then((b) => unwrapPage<TaskEntry>(b)),
-  globalPage: ({ state, limit, offset }: { state: TaskEntry["state"] | "all"; limit: number; offset: number }) =>
-    http.get<unknown>(`/tasks?state=${state}&limit=${limit}&offset=${offset}`).then((b) => unwrapPage<GlobalTaskEntry>(b)),
+  globalPage: ({ state, limit, offset, status }: { state: TaskEntry["state"] | "all"; limit: number; offset: number; status?: TaskStatus | "" }) =>
+    http
+      .get<unknown>(
+        `/tasks?state=${state}&limit=${limit}&offset=${offset}` + (status ? `&status=${status}` : ""),
+      )
+      .then((b) => unwrapPage<GlobalTaskEntry>(b)),
   get:    (pid: string, id: string) => http.get<TaskEntry>(`/projects/${pid}/tasks/${id}`),
   add:    (pid: string, body: Partial<TaskEntry>) =>
     http.post<TaskEntry>(`/projects/${pid}/tasks`, body),

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

@@ -1,12 +1,13 @@
 import { type ReactElement } from "react";
 import { useLocation, useNavigate } from "react-router-dom";
 import {
-  Bot, Cpu, Database, Globe, KeyRound, LayoutGrid, MessageCircle, Mic, Monitor, ScrollText, Send, Smartphone, Sparkles, User,
+  Bot, Cpu, Database, Globe, IdCard, KeyRound, LayoutGrid, MessageCircle, Mic, Monitor, ScrollText, Send, Smartphone, Sparkles, User,
 } from "lucide-react";
 import { useNavCollapse, type TabSection } from "../components/common/TabNav";
 import { TabLayout } from "../components/common/TabLayout";
 import { IdentityPanel } from "../components/settings/IdentityPanel";
 import { SuperAgentPanel } from "../components/settings/SuperAgentPanel";
+import { ProfilePanel } from "../components/settings/ProfilePanel";
 import { MemoryPanel } from "../components/settings/MemoryPanel";
 import { SkillsSettings } from "../components/settings/SkillsSettings";
 import { ModelsTab } from "./base/ModelsTab";
@@ -21,7 +22,7 @@ import { STORAGE } from "../constants";
 import { t } from "../i18n";
 
 type TabKey =
-  | "identity" | "super_agent" | "engines" | "memory" | "skills" | "telegram" | "devices"
+  | "identity" | "super_agent" | "profile" | "engines" | "memory" | "skills" | "telegram" | "devices"
   | "voice" | "deck" | "desktop" | "web" | "advanced";
 
 const SECTIONS: TabSection[] = [
@@ -35,6 +36,7 @@ const SECTIONS: TabSection[] = [
     title: t("settings.agents_section"),
     items: [
       { key: "super_agent", label: t("settings.tabs.super_agent"), icon: Bot },
+      { key: "profile",     label: t("settings.tabs.profile"),     icon: IdCard },
       { key: "engines",     label: t("settings.tabs.engines"),     icon: Cpu },
       { key: "memory",      label: "Memory (RAG)",                 icon: Database },
       { key: "skills",      label: t("skills_page.title"),         icon: Sparkles },
@@ -73,6 +75,7 @@ const WIDE_TABS = new Set<TabKey>(["engines", "telegram", "memory", "skills", "w
 const PANELS: Record<TabKey, () => ReactElement> = {
   identity:    () => <IdentityPanel />,
   super_agent: () => <SuperAgentPanel />,
+  profile:     () => <ProfilePanel />,
   engines:     () => <ModelsTab />,
   memory:      () => <MemoryPanel />,
   skills:      () => <SkillsSettings />,
@@ -113,6 +116,7 @@ function tabFromPath(pathname: string): TabKey {
   const raw = pathname.split("/").filter(Boolean)[1] || "identity";
   switch (raw) {
     case "super-agent": return "super_agent";
+    case "profile": return "profile";
     case "engines": return "engines";
     case "memory": return "memory";
     case "skills": return "skills";

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

@@ -1,6 +1,7 @@
 import { useState } from "react";
 import { useNavigate } from "react-router-dom";
 import { Tasks } from "../../lib/api";
+import type { TaskStatus } from "../../types/daemon";
 import { Section } from "../../components/Section";
 import { PagedList, usePagedQuery } from "../../components/Pager";
 import { Badge, Button, Empty, Loading } from "../../components/ui";
@@ -10,10 +11,14 @@ import { t } from "../../i18n";
 export function GlobalTasksTab() {
   const navigate = useNavigate();
   const [state, setState] = useState<"open" | "done" | "dropped" | "all">("open");
+  // Workflow sub-status is a different question from state: "what is blocked
+  // right now" is not "what is open". Only meaningful for open tasks.
+  const [status, setStatus] = useState<TaskStatus | "">("");
+  const effectiveStatus = state === "open" ? status : "";
   const paged = usePagedQuery({
-    key: `/tasks?state=${state}`,
-    fetchPage: (limit, offset) => Tasks.globalPage({ state, limit, offset }),
-    resetKey: state,
+    key: `/tasks?state=${state}&status=${effectiveStatus}`,
+    fetchPage: (limit, offset) => Tasks.globalPage({ state, limit, offset, status: effectiveStatus }),
+    resetKey: `${state}|${effectiveStatus}`,
   });
 
   return (
@@ -29,6 +34,19 @@ export function GlobalTasksTab() {
         </div>
       }
     >
+      {state === "open" ? (
+        <div className="mb-3 flex flex-wrap gap-1">
+          <Button size="sm" variant={status === "" ? "primary" : "ghost"} onClick={() => setStatus("")}>
+            {t("project.global_tasks.any_status")}
+          </Button>
+          {(["pending", "running", "in_review", "blocked"] as const).map((s) => (
+            <Button key={s} size="sm" variant={status === s ? "primary" : "ghost"} onClick={() => setStatus(s)}>
+              {s.replace("_", " ")}
+            </Button>
+          ))}
+        </div>
+      ) : null}
+
       {paged.isLoading && <Loading />}
       {!paged.isLoading && paged.total === 0 && <Empty>{t("project.global_tasks.empty")}</Empty>}
       <PagedList paged={paged} fullHeight>