@agentprojectcontext/apx 1.78.0 → 1.79.0

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

@@ -0,0 +1,183 @@
+import { useEffect, useState } from "react";
+import { ThumbsDown, ThumbsUp, Info } from "lucide-react";
+import { Section } from "../Section";
+import { Badge, Button, Empty, Field, Input, Loading, Switch } from "../ui";
+import { useToast } from "../Toast";
+import { useNudges, useNudgePolicy } from "../../hooks/useNudges";
+import { NudgesApi, type NudgePolicy } from "../../lib/api/nudges";
+import { t } from "../../i18n";
+
+/**
+ * The interruption budget — how often APX may speak unprompted.
+ *
+ * Two halves that belong together: the rule, and the record of what the rule
+ * let through. Showing the ledger next to the dial is the point — someone
+ * deciding "is three a day too many?" needs to see the three.
+ */
+export function NudgePanel() {
+  const toast = useToast();
+  const { policy, source, isLoading, mutate } = useNudgePolicy();
+  const { entries, stats, mutate: mutateLedger } = useNudges(30);
+
+  const [draft, setDraft] = useState<NudgePolicy | null>(null);
+  const [busy, setBusy] = useState(false);
+
+  useEffect(() => {
+    if (policy) setDraft({ ...policy });
+  }, [policy]);
+
+  if (isLoading || !draft) return <Loading />;
+
+  const save = async () => {
+    setBusy(true);
+    try {
+      await NudgesApi.setPolicy(draft);
+      await mutate();
+      toast.success(t("settings.nudge.saved"));
+    } catch (e) {
+      toast.error((e as Error).message);
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const rate = async (id: string, useful: boolean) => {
+    try {
+      await NudgesApi.feedback(id, useful);
+      await mutateLedger();
+    } catch (e) {
+      toast.error((e as Error).message);
+    }
+  };
+
+  const num = (key: keyof NudgePolicy, label: string, hint?: string) => (
+    <Field label={label} hint={hint}>
+      <Input
+        type="number"
+        min={0}
+        value={String(draft[key] ?? 0)}
+        disabled={!draft.enabled}
+        onChange={(e) => setDraft({ ...draft, [key]: Number(e.target.value) || 0 })}
+      />
+    </Field>
+  );
+
+  const left = draft.daily_max > 0 ? Math.max(0, draft.daily_max - (stats?.today ?? 0)) : "∞";
+
+  return (
+    <div className="flex flex-col gap-4" data-testid="nudge-panel">
+      <Section title={t("settings.nudge.title")} description={t("settings.nudge.subtitle")}>
+        <div 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>
+            {draft.enabled
+              ? t("settings.nudge.on_hint")
+                  .replace("{{sent}}", String(stats?.today ?? 0))
+                  .replace("{{left}}", String(left))
+              : t("settings.nudge.off_hint")}
+            {source.length ? (
+              <span className="ml-1 opacity-60">
+                ({t("settings.nudge.source")}: {source.join(" → ")})
+              </span>
+            ) : null}
+          </span>
+        </div>
+
+        <div className="mb-4">
+          <Switch
+            checked={draft.enabled}
+            onChange={(v) => setDraft({ ...draft, enabled: v })}
+            label={t("settings.nudge.enabled")}
+          />
+        </div>
+
+        <div className="grid gap-3 sm:grid-cols-2">
+          {num("daily_max", t("settings.nudge.daily_max"), t("settings.nudge.daily_max_hint"))}
+          <Field label={t("settings.nudge.quiet_hours")} hint={t("settings.nudge.quiet_hours_hint")}>
+            <Input
+              value={draft.quiet_hours ?? ""}
+              placeholder="22:00-07:30"
+              disabled={!draft.enabled}
+              onChange={(e) => setDraft({ ...draft, quiet_hours: e.target.value })}
+            />
+          </Field>
+          {num("cooldown_minutes", t("settings.nudge.cooldown"))}
+          {num("project_cooldown_minutes", t("settings.nudge.project_cooldown"))}
+          {num("kind_cooldown_minutes", t("settings.nudge.kind_cooldown"))}
+        </div>
+
+        <div className="mt-3">
+          <Switch
+            checked={draft.critical_bypasses_budget}
+            onChange={(v) => setDraft({ ...draft, critical_bypasses_budget: v })}
+            label={t("settings.nudge.critical_bypass")}
+            disabled={!draft.enabled}
+          />
+          <p className="mt-1 text-[11px] text-muted-foreground/70">
+            {t("settings.nudge.critical_bypass_hint")}
+          </p>
+        </div>
+
+        <div className="mt-4">
+          <Button variant="primary" loading={busy} onClick={save}>
+            {t("common.save")}
+          </Button>
+        </div>
+      </Section>
+
+      <Section title={t("settings.nudge.log_title")} description={t("settings.nudge.log_subtitle")}>
+        {!entries.length ? (
+          <Empty>{t("settings.nudge.log_empty")}</Empty>
+        ) : (
+          <ul className="flex flex-col gap-2" data-testid="nudge-log">
+            {entries.map((e) => (
+              <li
+                key={e.id}
+                className="flex items-start gap-3 rounded-md border border-border bg-muted/20 p-2.5 text-sm"
+              >
+                <span className="min-w-0 flex-1">
+                  <span className="flex flex-wrap items-center gap-2">
+                    <Badge>{e.kind}</Badge>
+                    <span className="text-xs opacity-55">
+                      {String(e.at).replace("T", " ").slice(0, 16)}
+                    </span>
+                    {e.bypassed_budget ? (
+                      <Badge tone="warning">{t("settings.nudge.bypass")}</Badge>
+                    ) : null}
+                  </span>
+                  <span className="mt-1 block line-clamp-2 opacity-80">{e.preview}</span>
+                </span>
+
+                {/* Rating is available for as long as the entry is on file, not
+                    only in the chat where the buttons were. Retrospect is when
+                    people actually notice a pattern was noise. */}
+                <span className="flex shrink-0 items-center gap-1">
+                  <button
+                    type="button"
+                    aria-label={t("settings.nudge.useful")}
+                    onClick={() => rate(e.id, true)}
+                    className={`rounded p-1.5 transition hover:bg-muted ${
+                      e.feedback?.useful === true ? "text-emerald-500" : "opacity-40"
+                    }`}
+                  >
+                    <ThumbsUp size={14} />
+                  </button>
+                  <button
+                    type="button"
+                    aria-label={t("settings.nudge.noise")}
+                    onClick={() => rate(e.id, false)}
+                    className={`rounded p-1.5 transition hover:bg-muted ${
+                      e.feedback?.useful === false ? "text-red-500" : "opacity-40"
+                    }`}
+                  >
+                    <ThumbsDown size={14} />
+                  </button>
+                </span>
+              </li>
+            ))}
+          </ul>
+        )}
+      </Section>
+    </div>
+  );
+}

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

@@ -1,11 +1,12 @@
 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 { Badge, Button, Dialog, Empty, Field, Input, Loading, Switch } 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 { CronPicker } from "../cron/CronPicker";
 import { t } from "../../i18n";
 
 /**
@@ -15,6 +16,11 @@ import { t } from "../../i18n";
  * Identity), nor with configuration profiles. With none active, APX behaves
  * exactly as it always has, and the panel says so rather than looking broken.
  */
+/** Schema keys whose value is a five-field cron expression. */
+function isCronKey(key: string): boolean {
+  return /(^|_)schedule$/.test(key) || /_cron$/.test(key);
+}
+
 export function ProfilePanel() {
   const toast = useToast();
   const { active, profiles, isLoading, mutate } = useProfiles();
@@ -143,16 +149,25 @@ export function ProfilePanel() {
         )}
 
         {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>
-            )}
+          <div className="mt-4 flex flex-wrap items-center gap-3">
+            {/* A switch, like every other on/off in Settings (Engines, Skills,
+                Desktop autostart). The red "Deactivate" button read as a
+                destructive action — deactivating a profile destroys nothing:
+                its settings survive and turning it back on restores them. */}
+            <Switch
+              checked={!!profile.active}
+              disabled={busy}
+              label={profile.active ? t("settings.profile.on") : t("settings.profile.off")}
+              onChange={(on) => {
+                if (on) activate(profile.id, !!active);
+                // Switching OFF still confirms: the profile's routines stop
+                // with it, and that is worth one deliberate tap.
+                else setConfirmOff(true);
+              }}
+            />
+            {!profile.active && active ? (
+              <span className="text-xs opacity-60">{t("settings.profile.replaces_active")}</span>
+            ) : null}
             <span className="text-xs opacity-60">
               {t("settings.profile.token_cost")}: ~{profile.tokens ?? 0}
               {profile.budget ? ` / ${profile.budget}` : ""}
@@ -183,7 +198,16 @@ export function ProfilePanel() {
               <div className="grid gap-3 sm:grid-cols-2">
                 {Object.entries(props).map(([key, def]) => (
                   <Field key={key} label={def.title || key} hint={def.description}>
-                    {def.enum ? (
+                    {/* A schedule is a time and some days, not five
+                        space-separated fields. Detected by key name because the
+                        JSON-Schema subset has no "format" for cron. */}
+                    {isCronKey(key) ? (
+                      <CronPicker
+                        value={draft[key] ?? String(def.default ?? "")}
+                        onChange={(expr) => setDraft({ ...draft, [key]: expr })}
+                        disabled={!canEdit}
+                      />
+                    ) : def.enum ? (
                       <UiSelect
                         value={draft[key] ?? String(def.default ?? "")}
                         onChange={(v) => setDraft({ ...draft, [key]: v })}

package/src/interfaces/web/src/components/ui/filter-chips.tsx

@@ -0,0 +1,47 @@
+import { cn } from "../../lib/cn";
+
+/**
+ * One row of mutually-exclusive filters.
+ *
+ * Exists so every list page filters the same way and reads the same way.
+ * Labels are Capitalised: the chips used to render whatever the state value
+ * happened to be ("open", "in review"), which put raw storage vocabulary in
+ * the interface.
+ */
+export function FilterChips<T extends string>({
+  value,
+  options,
+  onChange,
+  label,
+}: {
+  value: T;
+  options: { value: T; label: string }[];
+  onChange: (v: T) => void;
+  label?: string;
+}) {
+  return (
+    <div className="flex flex-wrap items-center gap-1" role="group" aria-label={label}>
+      {options.map((o) => (
+        <button
+          key={o.value}
+          type="button"
+          aria-pressed={value === o.value}
+          onClick={() => onChange(o.value)}
+          className={cn(
+            "rounded-md px-2.5 py-1 text-xs font-medium transition-colors",
+            value === o.value
+              ? "bg-accent text-accent-fg"
+              : "text-muted-fg hover:bg-muted/50 hover:text-foreground",
+          )}
+        >
+          {capitalise(o.label)}
+        </button>
+      ))}
+    </div>
+  );
+}
+
+/** First letter up, rest untouched — so "in review" keeps its lowercase w. */
+function capitalise(s: string): string {
+  return s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}

package/src/interfaces/web/src/components/ui.tsx

@@ -15,6 +15,7 @@ import { Dialog as DialogRoot, DialogContent, DialogHeader, DialogTitle, DialogD
 // Re-export the tooltip convenience wrapper so call sites can grab it from the
 // same barrel as Button/Field/etc.: `import { Button, Tip } from "../ui"`.
 export { Tip } from "./ui/tip";
+export { FilterChips } from "./ui/filter-chips";
 
 // ── Button ──────────────────────────────────────────────────────────────────
 type Variant = "primary" | "secondary" | "ghost" | "destructive";

package/src/interfaces/web/src/constants/index.ts

@@ -65,6 +65,7 @@ export const ROUTINE_KINDS = [
   "super_agent",
   "telegram",
   "shell",
+  "watch",
 ] as const;
 export type RoutineKind = (typeof ROUTINE_KINDS)[number];
 

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

@@ -1,6 +1,6 @@
 import { useCallback, useRef, useState } from "react";
 import { SuperAgent, Agents, Conversations } from "../lib/api";
-import type { ChatStreamEvent, ChatUsage, ConversationMessage } from "../types/daemon";
+import type { ChatStreamEvent, ChatUsage, ConversationMessage, ToolSummary } from "../types/daemon";
 import { t } from "../i18n";
 
 export type ToolStatus = "running" | "done" | "error" | "deduped";
@@ -37,6 +37,9 @@ export interface ChatMsg {
   usage?: ChatUsage;
   /** Operational notes (engine fallbacks, retries, suppressions). */
   notes?: string[];
+  /** What a HISTORICAL turn did. Live turns render real ToolCall parts from
+   *  the stream; replayed ones only have this, recorded at write time. */
+  toolSummary?: ToolSummary;
   /** Skill Inspector decision for this turn (when the feature is on): which
    *  skills the per-turn RAG loaded inline vs merely hinted. */
   inspector?: {
@@ -179,6 +182,7 @@ function threadToChatMsgs(messages: ConversationMessage[]): ChatMsg[] {
         if (m.agent) turn.agentId = m.agent;
         if (m.agent_name) turn.agent = m.agent_name;
         if (m.model) turn.model = m.model;
+        if (m.tool_summary) turn.toolSummary = m.tool_summary;
         if (m.usage) {
           turn.usage = {
             input_tokens: (turn.usage?.input_tokens || 0) + (m.usage.input_tokens || 0),

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

@@ -0,0 +1,38 @@
+import useSWR from "swr";
+import { NudgesApi } from "../lib/api/nudges";
+import type { NudgeEntry, NudgePolicy, NudgeStats } from "../lib/api/nudges";
+
+/** The ledger of unrequested messages, plus what they add up to. */
+export function useNudges(limit = 50) {
+  const { data, error, isLoading, mutate } = useSWR<{
+    data: NudgeEntry[];
+    meta: { total: number; stats: NudgeStats };
+  }>(`/api/nudges?limit=${limit}`, () => NudgesApi.list(limit));
+
+  return {
+    entries: data?.data ?? [],
+    stats: data?.meta?.stats,
+    error,
+    isLoading,
+    mutate,
+  };
+}
+
+/** The effective budget, and which layer set each part of it. */
+export function useNudgePolicy() {
+  const { data, error, isLoading, mutate } = useSWR<{
+    policy: NudgePolicy;
+    source: string[];
+    defaults: NudgePolicy;
+    user_overrides: Partial<NudgePolicy>;
+  }>("/api/nudges/policy", () => NudgesApi.policy());
+
+  return {
+    policy: data?.policy,
+    source: data?.source ?? [],
+    userOverrides: data?.user_overrides ?? {},
+    error,
+    isLoading,
+    mutate,
+  };
+}

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

@@ -2,6 +2,32 @@
 // Keep entries in the same order as es.ts so diffs stay readable.
 
 export const en = {
+    cron: {
+      daily:            "every day at {at}",
+      weekdays:         "Monday to Friday at {at}",
+      weekends:         "weekends at {at}",
+      on_days:          "{days} at {at}",
+      monthly:          "day {day} of each month at {at}",
+      every_hour:       "every hour, at :{minute}",
+      every_n_hours:    "every {n} hours, at :{minute}",
+      every_n_minutes:  "every {n} minutes",
+      every_minute:     "every minute",
+      every_label:      "every N hours instead",
+      use_cron:         "edit as cron",
+      use_picker:       "use the picker",
+      preset_every_day: "every day",
+      preset_weekdays:  "weekdays",
+      preset_weekends:  "weekends",
+      day_short: { sun: "Sun", mon: "Mon", tue: "Tue", wed: "Wed", thu: "Thu", fri: "Fri", sat: "Sat" },
+    },
+    when: {
+      now:     "now",
+      in:      "in {amount}",
+      ago:     "{amount} ago",
+      minutes: "{n} min",
+      hours:   "{n} h",
+      days:    "{n} d",
+    },
   common: {
     loading:      "Loading…",
     saving:       "Saving…",
@@ -143,6 +169,11 @@ export const en = {
     no_folders:  "No folders.",
   },
   inbox: {
+    search: "Search",
+    no_match: "Nothing matches",
+    hide_quiet: "Hide quiet agents",
+    open_in_project: "Open in project",
+    super_agent_scope: "All projects",
     title: "Agent inbox",
     subtitle:
       "Every agent as a conversation, most recent first.",
@@ -195,6 +226,8 @@ export const en = {
     devices_revoke:      "Revoke",
     account_section:     "Account",
     agents_section:      "Agents & models",
+    super_agent_section: "Super-agent",
+    knowledge_section:   "Models & knowledge",
     channels_section:    "Channels & devices",
     modules_section:     "Modules",
     advanced_section:    "Advanced",
@@ -206,6 +239,7 @@ export const en = {
       engines: "Engines & models",
       telegram: "Telegram",
       devices: "Devices",
+      nudge: "Interruptions",
       advanced: "Advanced",
     },
 
@@ -222,6 +256,9 @@ export const en = {
       activate: "Activate",
       replace_active: "Replace the active one",
       deactivate: "Deactivate",
+      on: "Active",
+      off: "Inactive",
+      replaces_active: "Turning this on replaces the active profile",
       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.",
@@ -245,6 +282,34 @@ export const en = {
       doctor_vanilla: "No profile active. APX behaves as it always has.",
     },
 
+    nudge: {
+      title: "Interruption budget",
+      subtitle:
+        "How often APX may write to you without being asked. Replies to your own messages are never held back.",
+      off_hint:
+        "The budget is off: every unrequested message goes out. Everything is still recorded below.",
+      on_hint: "{{sent}} sent today, {{left}} left.",
+      source: "Set by",
+      enabled: "Enforce the budget",
+      daily_max: "Messages per day",
+      daily_max_hint: "0 means no ceiling.",
+      quiet_hours: "Quiet hours",
+      quiet_hours_hint: "HH:MM-HH:MM. Crosses midnight fine. Leave empty for none.",
+      cooldown: "Minimum gap (minutes)",
+      project_cooldown: "Minimum gap per project (minutes)",
+      kind_cooldown: "Minimum gap per kind (minutes)",
+      critical_bypass: "Critical messages may bypass the budget",
+      critical_bypass_hint: "Bypasses are always recorded and flagged.",
+      log_title: "What it has sent",
+      log_subtitle: "Unrequested messages only, newest first. Your rating feeds back into what it sends next.",
+      log_empty: "Nothing sent unprompted yet.",
+      useful: "Useful",
+      noise: "Not useful",
+      bypass: "bypassed the budget",
+      saved: "Budget updated",
+      unrated: "not rated",
+    },
+
     identity: {
       title: "Identity",
       subtitle: "User data. Agent configuration goes in Super-agent.",
@@ -338,6 +403,7 @@ export const en = {
       agents:   "Agents",
       routines: "Routines",
       tasks:    "Tasks",
+      commitments: "Commitments",
       mcps:     "MCPs",
       artifacts: "Artifacts",
       vars:     "Variables",
@@ -442,6 +508,16 @@ export const en = {
     },
 
     global_tasks: {
+
+      add: "Add",
+
+      add_title: "New task",
+
+      field_title: "Task",
+
+      field_project: "Project",
+
+      field_due: "Due",
       any_status: "any status",
       title:       "Tasks (all projects)",
       subtitle:    "Aggregated tasks from all registered projects.",
@@ -450,6 +526,44 @@ export const en = {
       go_project:  "Go to project",
     },
 
+    commitments: {
+
+      add: "Add",
+
+      add_title: "Record a promise",
+
+      add_hint: "Something you told a specific person you would do. Tasks live next door.",
+
+      field_who: "Who is waiting",
+
+      field_who_hint: "A name as you would say it — free text, not a contact.",
+
+      field_what: "What you promised",
+
+      field_what_ph: "send the revised quote",
+
+      field_due: "By when",
+
+      field_due_hint: "Optional, but it is the part that makes this useful.",
+
+      field_project: "Project",
+      title:    "Commitments",
+      subtitle: "What was promised, to whom, and by when. Separate from tasks: someone is waiting on these.",
+      empty:    "Nothing promised.",
+      overdue:  "was due",
+      overdue_only: "Past their date",
+      no_date:  "no date agreed",
+      moved:    "moved",
+      mark_kept:   "Kept",
+      mark_missed: "Missed",
+      state: {
+        open:   "open",
+        kept:   "kept",
+        missed: "missed",
+        all:    "all",
+      },
+    },
+
     routines: {
       title:       "Heartbeats / Routines",
       subtitle:    "Cron, every:Nm, once:ISO. Each routine fires an agent or a shell.",
@@ -784,6 +898,12 @@ export const en = {
     },
 
     memories: {
+
+      super_agent_group: "Super-agent",
+
+      notebook_item: "{persona}'s notebook",
+
+      tokens: "~{n} tok",
       sidebar_title:   "Memories",
       general_group:   "General",
       general_item:    "Project memory",
@@ -875,6 +995,8 @@ export const en = {
     no_activity_ch: "No activity in channel \"{ch}\".",
     error:        "Could not read messages: {msg}",
     show_more:    "show more",
+    event_routine_created: "routine created",
+    event_routine_updated: "routine updated",
     show_less:    "show less",
     daemon_errors: "Daemon errors (~/.apx/logs/errors.jsonl)",
     no_errors:    "No errors recorded. 🎉",
@@ -1566,6 +1688,9 @@ export const en = {
     kind_routine:            "routine",
     kind_hierarchy:          "hierarchy",
     nodes_drag_hint:         "{n} nodes · drag to rearrange",
+    kind_watch:              "Watcher",
+    kind_watch_desc:         "Sweeps for things worth noticing — overdue work, promises coming due, projects gone quiet. Costs nothing when there is nothing to report.",
+    action_watch:            "Watches for signals, and judges only when it finds some",
     kind_exec_agent:         "Project agent",
     kind_exec_agent_desc:    "Runs a project agent with a prompt. You pick which one.",
     kind_super_agent:        "Super-agent",
@@ -1585,6 +1710,7 @@ export const en = {
     preset_every_10m:        "every 10 min",
     preset_hourly:           "hourly",
     preset_daily_9am:        "daily 9am",
+    sched_manual:            "only when you run it",
     preset_weekdays_9am:     "weekdays 9am",
     preset_manual:           "Manual",
     var_pre_output_prompt:   "Text output of the pre-commands. Replaced inside the prompt/text before it is sent. Use it to inject fresh data (weather, an API) into the instruction.",
@@ -1875,6 +2001,7 @@ export const en = {
   shared_ui: {
     skill_inspector_title: "Skill Inspector ({embedder}) chose these skills for this turn",
     tools_count:           "{n} tools",
+    tools_failed:          "{n} failed",
     tool_read_file:        "Read file",
     tool_write_file:       "Write file",
     tool_edit_file:        "Edit file",