@songsid/agend 2.3.0-beta.2 → 2.3.0-beta.3

package/dist/fleet-manager.d.ts

@@ -73,6 +73,8 @@ import { AppearanceTools } from "./web-appearance-tools.js";
 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 RawConfigPatch } from "./settings-api.js";
 import { type AgentEndpointContext } from "./agent-endpoint.js";
 import { ClassicChannelManager } from "./classic-channel-manager.js";
@@ -84,6 +86,7 @@ import { TargetQueueWorker } from "./target-queue-worker.js";
 import { resolveDeliveryWorkerMode } from "./types.js";
 import { type WebNeedsItem } from "./needs-you-hub.js";
 import { type OrgChart } from "./web-org.js";
+import { type MemoryHog } from "./memory-hogs.js";
 import { type CacheReport } from "./cache-service.js";
 import { type WebCommandResult } from "./web-commands.js";
 import { type ReturningDevice } from "./web-returning-device.js";
@@ -442,6 +445,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** #1306: the preview listener (health_port + 1 by default), and whether it is listening. */
     private previewListener;
     private previewListening;
+    /** The preview listener could not open its port: "<port>: <error code>", for the page (#2061 follow-up); null otherwise. */
+    private previewListenError;
     /** The ports the preview listener was started for, and the inputs it was built from (a reload compares them). */
     private previewPorts;
     private previewInputs;
@@ -474,6 +479,17 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private startedAt;
     private stormOpenNotifyTimer;
     private memoryLogAt;
+    /**
+     * #2015: while host memory is elevated or critical, the processes holding the most in the fleet's service and whose
+     * they are (an instance, the fleet, tmux), for the pressure log, /health and the dashboard — never chat (#1712).
+     * Rescanned at most once a minute (async, one at a time); cleared when pressure ends.
+     */
+    private memoryTop;
+    private memoryTopScan;
+    /** The scan (a seam for tests: they give it a fake /proc). */
+    private memoryHogScan;
+    /** The fleet's own tmux session exists (only then are its panes read: a fleet that never started has none). */
+    private tmuxSessionEnsured;
     private memoryDebugAt;
     private memoryLogLevel;
     /** #1685: the host_memory value the last status frame carried, so a change re-sends the frame. */
@@ -574,6 +590,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private ownerCssStore?;
     /** #1629 r4 §3: each person's own CSS; which version is in force is their `css.active` in the web preferences. */
     get ownerCss(): OwnerCssStore;
+    private webSettingsToolsService?;
+    /**
+     * #2056: Settings → Web appearance for a tool (General, a coordinator, full) — the page's own stores and checks, and the
+     * page's announcement after a change (web-settings-tools.ts).
+     */
+    get webSettings(): WebSettingsTools;
     get webPrefs(): WebPrefsStore;
     /**
      * Read from disk on every access rather than cached at startup: `agend
@@ -651,6 +673,20 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** #1266: the choice, delivered as an ordinary inbound message from whoever made it, and shown in the web chat. */
     private deliverReplyButtonChoice;
     private ensureDeliveryOutbox;
+    /** #1918: cross-instance traffic, as the org canvas draws it (fleet-traffic.ts). */
+    private readonly trafficLog;
+    private trafficMemo;
+    /** One delivery row's traffic item, kept for the snapshot and sent to the open pages when it is news. */
+    private publishTraffic;
+    /**
+     * GET /ui/traffic: what is in flight now (the outbox's pending rows) and what finished in the last two minutes, at
+     * most TRAFFIC_SNAPSHOT_MAX items. Worked out at most once every two seconds, so the public link's polling (or any
+     * number of pages) costs one indexed read per two seconds. Visibility is applied as of now.
+     */
+    trafficSnapshot(): {
+        now: string;
+        items: TrafficItem[];
+    };
     /** Synchronous SQLite admission; the caller may acknowledge only after this returns. */
     admitDurableDelivery(input: {
         operationId: string;
@@ -704,6 +740,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private hostMemoryIndicator;
     /** Separate cooldown: changing measurements must not create new text-throttle keys. */
     private reportMemoryPressure;
+    /**
+     * #2015: rescan the largest processes (at most once a minute, one at a time). The first result of an episode, and
+     * then at most every 10 minutes, is logged with the pressure; /health and the dashboard read the latest. Never chat.
+     */
+    private refreshMemoryTop;
     /** Wire the one fleet-wide storm into notification and recovery surfaces. */
     private bindStormWindowEvents;
     /** What the gate allows while any storm window is open (see SpawnGate.pump). */
@@ -993,7 +1034,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * for `instance` (#1320 part B). Per entry: the channel's own adapter, no
      * thread, mention suppression on. Returns the number of channels posted
      * to. Failures are per-entry warn-and-continue — a failed echo never fails
-     * the web send. Entries without `web_echo: true` are never touched.
+     * the web send. Only entries classicWebEchoOn admits are touched (#2054: unset follows web.echo_to_channel; an explicit
+     * `web_echo: false` never echoes).
      *
      * Every copy is fenced at start time: an entry whose explicit world is
      * gone is skipped (only legacy adapterId-less entries fall back to the
@@ -1545,7 +1587,10 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
          *  reported separately because they differ by ~60x and only one of them can
          *  show a fleet-manager leak. */
         memory: FleetMemory;
-        hostMemory: MemoryPressureSnapshot;
+        hostMemory: MemoryPressureSnapshot & {
+            topProcesses?: MemoryHog[];
+            topProcessesAt?: string;
+        };
         problems: string[];
     };
     /** Start the primary adapter (backward-compatible, sets this.adapter) */
@@ -2937,8 +2982,14 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private pasteRawToClassicInstance;
     /** Resolve the backend name configured for an instance (fleet or classic). */
     private backendNameForInstance;
+    /**
+     * #2072: a catalog is the account's, so a credential profile has its own. Only claude-code's probe reads an account
+     * catalog through a profile's login (its `GET /v1/models` with the profile's token); other backends' probes read the
+     * process environment, so their catalog stays the backend's own.
+     */
+    private catalogProfile;
     private cliEnvPath;
-    /** Read the cached CLI env for a backend, or null if missing/stale/unparseable. */
+    /** Read the cached CLI env for a backend (a credential profile's own, when given), or null if missing/stale/unparseable. */
     private readCliEnv;
     /** Return cached CLI versions immediately. Refresh is started after /sysinfo is sent. */
     getBackendCliVersionSnapshot(): BackendCliVersionSnapshot;
@@ -2969,6 +3020,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     };
     /** Human-readable effective model, e.g. `auto (default)`. Used by /ctx. */
     modelDisplayForInstance(instanceName: string): string;
+    /**
+     * #2072: the model an instance runs is always among its choices — one its CLI's catalog does not list (an older
+     * name, a custom provider's, a typed one) is shown first, marked, so the menu never hides what is running.
+     */
+    private withCurrentModel;
     private modelChoiceLabel;
     /** Preserve the existing cache merge rules for worker probes. */
     private persistCliEnvProbeResult;
@@ -3483,6 +3539,14 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * Only the parsed host name is logged, never the raw header.
      */
     private noteRejectedHost;
+    /**
+     * #1920: the instances a guest session may see — derived on every request, never stored. Phase 2 derives it from
+     * the account's chat access (and an admin's naming for an open connection); until then a guest sees nothing.
+     */
+    guestScope(_owner: {
+        readonly adapterId: string;
+        readonly userId: string;
+    } | undefined): ReadonlySet<string>;
     /** Shared handler dispatcher; gateway admission is enforced by its separate listener. */
     private dispatchWebHttp;
     private startHealthServer;
@@ -3504,6 +3568,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     previewForUi(hostHeader: string | undefined, secure: boolean): PreviewAvailability & {
         boot: string | null;
     };
+    private previewNotListening;
     /**
      * #1723: for one page of the public link (exposure `exposureId`, at `dashboardOrigin`): its own preview tunnel's
      * origin once up, "starting" until then, why it failed if it did — or a configured web.preview_origin, used instead.