@songsid/agend 2.3.0-beta.7 → 2.3.0-beta.9

package/dist/decision-list.d.ts

@@ -0,0 +1,25 @@
+/**
+ * #2152: what `list_decisions` answers. The fleet's decisions are long (82 of them were 126 KB, ≈31k–42k tokens in one
+ * call) and every instance lists them after a restart, so by default it answers titles — id, title, scope, date, tags —
+ * and the full text is asked for: one decision by `id`, or all of them with `full: true`. One function for both entry
+ * paths (the MCP tool through the daemon, and the agent endpoint's `decision-*` ops).
+ */
+import type { Decision } from "./scheduler/types.js";
+export interface DecisionTitle {
+    id: string;
+    title: string;
+    scope: Decision["scope"];
+    /** The day it was last changed (YYYY-MM-DD). */
+    date: string;
+    tags?: string[];
+    status?: Decision["status"];
+}
+export declare const DECISION_TITLES_HINT = "Titles only. Call list_decisions with { id } for one decision's full text, or { full: true } for every one.";
+/**
+ * The answer: `{ decision }` for an id, the full records for `full`, else the titles. `all` is the list as the store
+ * returns it (already filtered by scope, archive and tags).
+ */
+export declare function decisionListAnswer(all: readonly Decision[], opts?: {
+    id?: unknown;
+    full?: unknown;
+}): unknown;

package/dist/decision-list.js

@@ -0,0 +1,30 @@
+export const DECISION_TITLES_HINT = "Titles only. Call list_decisions with { id } for one decision's full text, or { full: true } for every one.";
+/** One decision by id (exact, or a unique prefix of at least 6 characters); null when none or more than one match. */
+function byId(all, id) {
+    const exact = all.find(d => d.id === id);
+    if (exact)
+        return exact;
+    if (id.length < 6)
+        return null;
+    const hits = all.filter(d => d.id.startsWith(id));
+    return hits.length === 1 ? hits[0] : null;
+}
+/**
+ * The answer: `{ decision }` for an id, the full records for `full`, else the titles. `all` is the list as the store
+ * returns it (already filtered by scope, archive and tags).
+ */
+export function decisionListAnswer(all, opts = {}) {
+    if (typeof opts.id === "string" && opts.id.trim()) {
+        const d = byId(all, opts.id.trim());
+        return d ? { decision: d } : { error: `No decision '${opts.id.trim()}' among these (an id, or a unique prefix of 6 or more characters).` };
+    }
+    if (opts.full === true)
+        return all;
+    const titles = all.map(d => ({
+        id: d.id, title: d.title, scope: d.scope, date: (d.updated_at || d.created_at || "").slice(0, 10),
+        ...(d.tags?.length ? { tags: d.tags } : {}),
+        ...(d.status && d.status !== "active" ? { status: d.status } : {}),
+    }));
+    return { decisions: titles, hint: DECISION_TITLES_HINT };
+}
+//# sourceMappingURL=decision-list.js.map

package/dist/decision-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-list.js","sourceRoot":"","sources":["../src/decision-list.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,oBAAoB,GAAG,6GAA6G,CAAC;AAElJ,sHAAsH;AACtH,SAAS,IAAI,CAAC,GAAwB,EAAE,EAAU;IAChD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAwB,EAAE,OAAyC,EAAE;IACtG,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,oEAAoE,EAAE,CAAC;IAC7I,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,MAAM,GAAoB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACjG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;AAC3D,CAAC"}

package/dist/fleet-manager.d.ts

@@ -75,7 +75,7 @@ import { ModStore } from "./web-mod-store.js";
 import { AgentMods } from "./web-mod-agent.js";
 import { type CachedImage } from "./web-images.js";
 import { WebSettingsTools } from "./web-settings-tools.js";
-import { type TrafficItem } from "./fleet-traffic.js";
+import { type Delegation, type TrafficItem } from "./fleet-traffic.js";
 import { type RawConfigPatch } from "./settings-api.js";
 import { type AgentEndpointContext } from "./agent-endpoint.js";
 import { ClassicChannelManager } from "./classic-channel-manager.js";
@@ -705,8 +705,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private ensureDeliveryOutbox;
     /** #1918: cross-instance traffic, as the org canvas draws it (fleet-traffic.ts). */
     private readonly trafficLog;
+    private readonly delegations;
     private trafficMemo;
-    /** One delivery row's traffic item, kept for the snapshot and sent to the open pages when it is news. */
+    /**
+     * One delivery row's traffic item, kept for the snapshot and sent to the open pages when it is news; and the
+     * delegation it opens or closes (a task and its report), sent as "delegation".
+     */
     private publishTraffic;
     /**
      * GET /ui/traffic: what is in flight now (the outbox's pending rows) and what finished in the last two minutes, at
@@ -716,6 +720,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     trafficSnapshot(): {
         now: string;
         items: TrafficItem[];
+        delegations: Delegation[];
     };
     /** Synchronous SQLite admission; the caller may acknowledge only after this returns. */
     admitDurableDelivery(input: {
@@ -2198,6 +2203,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private guildEmojiCache;
     private guildEmojiFetches;
     private webImageCaches;
+    /** Server emoji whose picture fetch failure was already logged at warn (once each; bounded). */
+    private readonly webEmojiFailures;
     private webImageCache;
     /**
      * The bots instances and ClassicBot rooms speak through, by connections configured now (a connection removed from

package/dist/fleet-manager.js

@@ -183,7 +183,7 @@ import { crossInstanceVisibility, runVisibilityCommand } from "./cross-instance-
 import { WebSettingsTools } from "./web-settings-tools.js";
 import { bindGuestRequest, guestRouteDecision } from "./web-guest-access.js";
 import { GUEST_ROOM_TICK_MS, GuestRoomMembership, guestGroupRooms } from "./web-guest-rooms.js";
-import { TrafficLog, trafficItem } from "./fleet-traffic.js";
+import { Delegations, TrafficLog, trafficItem } from "./fleet-traffic.js";
 import { installedChannel, updateNoticeKey } from "./update-check.js";
 import { resolveInstalledAgend } from "./update-dispatch.js";
 import { resolveUpdateLaunch, openUpdateLog, updateLogPath, watchUpdateLaunch } from "./update-launch.js";
@@ -232,6 +232,7 @@ import { AuthorityStateStore } from "./authority/authority-state.js";
 import { SessionAuthorizations } from "./authority/session-authorizations.js";
 import { SessionAuthorizationRequests } from "./web-session-authorization.js";
 import { GuestLoginCodes, WebLoginCodes, LOGIN_CODE_TTL_MS } from "./web-login.js";
+import { decisionListAnswer } from "./decision-list.js";
 import { CodeRequestLimiter, ReturningDevices } from "./web-returning-device.js";
 import { allowedHostNames, applyWebSecurityHeaders, hostnameOf, isHostAllowed, LOOPBACK_HOST_NAMES, WEB_HOST_REJECTED_MESSAGE } from "./web-host-guard.js";
 import { createPreviewListener, normalizeOrigin, previewAvailability, previewSettings } from "./web-preview.js";
@@ -1693,16 +1694,27 @@ export class FleetManager {
     }
     /** #1918: cross-instance traffic, as the org canvas draws it (fleet-traffic.ts). */
     trafficLog = new TrafficLog();
+    delegations = new Delegations();
     trafficMemo = null;
-    /** One delivery row's traffic item, kept for the snapshot and sent to the open pages when it is news. */
+    /**
+     * One delivery row's traffic item, kept for the snapshot and sent to the open pages when it is news; and the
+     * delegation it opens or closes (a task and its report), sent as "delegation".
+     */
     publishTraffic(row, state) {
         try {
             const item = trafficItem(row, this.fleetConfig, new Date().toISOString(), state);
             const news = item ? this.trafficLog.note(item) : null;
-            if (news) {
+            const work = news ? this.delegations.note(row, news) : [];
+            if (news || work.length)
                 this.trafficMemo = null;
+            if (news)
                 this.emitSseEvent("traffic", news);
-            }
+            // Each delegation as its two instances are seen now: one that expires or is pushed out may be older than a change
+            // to their visibility (the incoming row's own item was checked; these can be anyone's).
+            const visible = (name) => crossInstanceVisibility(this.fleetConfig, name) !== "hidden";
+            for (const d of work)
+                if (visible(d.from) && visible(d.to))
+                    this.emitSseEvent("delegation", d);
         }
         catch (err) {
             this.logger.debug({ err }, "traffic: an item was not published");
@@ -1722,7 +1734,8 @@ export class FleetManager {
             .map((r) => trafficItem(r, this.fleetConfig, r.createdAt ?? now)).filter((i) => i !== null);
         const visible = (name) => crossInstanceVisibility(this.fleetConfig, name) !== "hidden";
         const items = this.trafficLog.snapshot(pending).filter((i) => visible(i.from) && visible(i.to));
-        this.trafficMemo = { atMs: nowMs, value: { now, items } };
+        const delegations = this.delegations.snapshot().filter((d) => visible(d.from) && visible(d.to));
+        this.trafficMemo = { atMs: nowMs, value: { now, items, delegations } };
         return this.trafficMemo.value;
     }
     /** Synchronous SQLite admission; the caller may acknowledge only after this returns. */
@@ -10163,10 +10176,11 @@ export class FleetManager {
                 }
                 case "fleet_decision_list":
                     db.pruneExpiredDecisions();
-                    result = db.listDecisions(projectRoot, {
+                    // #2152: titles by default; the full text by id, or all of it with full: true.
+                    result = decisionListAnswer(db.listDecisions(projectRoot, {
                         includeArchived: payload.include_archived,
                         tags: payload.tags,
-                    });
+                    }), { id: payload.id, full: payload.full });
                     break;
                 case "fleet_decision_update": {
                     const id = payload.id;
@@ -10359,10 +10373,16 @@ export class FleetManager {
                     created_by: instance,
                 });
             }
-            case "list": return db.listDecisions(projectRoot, {
-                includeArchived: args.includeArchived === true,
-                tags: asStrArr(args.tags),
-            });
+            // #2152: titles by default (agend-agent decision-list); one decision's full text by id (decision-get <id>).
+            // The CLI sends include_archived (snake case, as the MCP tool): both spellings are read.
+            case "list":
+            case "get":
+                if (op === "get" && !asStr(args.id)?.trim())
+                    return { error: "id is required" };
+                return decisionListAnswer(db.listDecisions(projectRoot, {
+                    includeArchived: args.includeArchived === true || args.include_archived === true,
+                    tags: asStrArr(args.tags),
+                }), { id: op === "get" ? asStr(args.id) ?? "" : args.id, full: args.full });
             case "update": {
                 const id = asStr(args.id);
                 if (!id)
@@ -11398,11 +11418,23 @@ export class FleetManager {
     guildEmojiFetches = new Map();
     // ── #1630: what stands for an instance in the web app, and Discord server emoji in web chat ──
     webImageCaches = null;
+    /** Server emoji whose picture fetch failure was already logged at warn (once each; bounded). */
+    webEmojiFailures = new Set();
     webImageCache(kind) {
         const onError = (key, err) => this.logger.debug({ err: err?.message, key }, "web image fetch failed (kept what was cached)");
+        // A server emoji's picture that cannot be fetched reads `:name:` in web chat (it used to be an empty box, the user's
+        // "tofu"): say why once per emoji, where it can be seen, not on every render (its key is quiet for an hour anyway).
+        const emojiError = (key, err) => {
+            if (this.webEmojiFailures.has(key))
+                return onError(key, err);
+            this.webEmojiFailures.add(key);
+            while (this.webEmojiFailures.size > 512)
+                this.webEmojiFailures.delete(this.webEmojiFailures.values().next().value);
+            this.logger.warn({ err: err?.message, key }, "Discord server emoji picture could not be fetched (web chat shows its :name:)");
+        };
         this.webImageCaches ??= {
             avatars: new WebImageCache({ dir: join(this.dataDir, "cache", "avatars"), onError }),
-            emoji: new WebImageCache({ dir: join(this.dataDir, "cache", "emoji"), onError }),
+            emoji: new WebImageCache({ dir: join(this.dataDir, "cache", "emoji"), onError: emojiError }),
         };
         return this.webImageCaches[kind];
     }