@songsid/agend 2.2.0-beta.3 → 2.2.0-beta.5

package/dist/fleet-manager.d.ts

@@ -51,7 +51,9 @@ export declare function applyTaskListCap<T extends {
     omitted: number;
     hint: string;
 } | T[];
+import { type PublicPreviewForUi } from "./web-api.js";
 import { WebChatHistory } from "./web-chat-history.js";
+import { SeenUsers, type MentionNames, type MentionQuery } from "./web-mentions.js";
 import { WebPrefsStore } from "./web-prefs.js";
 import { ReplyButtonsController } from "./reply-buttons-controller.js";
 import { WebFileLedger } from "./web-upload.js";
@@ -160,6 +162,8 @@ export declare const LOGIN_CALLBACK_PREFIX = "login:";
  * and hides exactly the newly released model the user opened `/model` to find.
  * The wait is announced before it starts, so it reads as progress, not a stall.
  */
+/** #1690: how long `/model` waits for the daemon's word on our own runtime switch (its dialog wait plus settling). */
+export declare const RUNTIME_SWITCH_RESULT_MS = 12000;
 export declare const CLI_ENV_PROBE_DEADLINE_MS = 16000;
 /**
  * How many CLIs may cold-start at once, from BOTH memory and cores.
@@ -411,6 +415,13 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private updateProgressEditRunning;
     private lastUpdateProgressText;
     private updateCompletionTipText;
+    /**
+     * #1660: an adopted update whose retire outcome is still owed. The
+     * completion summary was (or will be) posted; this watch appends the
+     * cleanup outcome to the same receipt instead of letting stage edits
+     * clobber it — and refuses a receipt that no longer matches (checklist 3/5).
+     */
+    private updateCleanupWatch;
     /** Injectable only to keep the chat→CLI reload hand-off deterministic in tests. */
     private fullRestartLauncher;
     private eventLogPruneTimer;
@@ -430,8 +441,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private memoryLogAt;
     private memoryDebugAt;
     private memoryLogLevel;
-    private memoryNoticeAt;
-    private memoryNoticeLevel;
+    /** #1685: the host_memory value the last status frame carried, so a change re-sends the frame. */
+    private memoryIndicatorShown;
     private mirrorBuffer;
     private mirrorTimer;
     private sseClients;
@@ -441,6 +452,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private webChatStore;
     /** Uploaded files and the files the dashboard may fetch back (uploads, reply attachments). */
     readonly webFiles: WebFileLedger;
+    /** #1682: the people seen on inbound messages (id → name), for the web chat's mention pills; bounded, in memory. */
+    readonly seenUsers: SeenUsers;
     private webPrefsStore?;
     /** #1665: the web preferences kept on the host (<home>/web-prefs.json), read on first use. */
     get webPrefs(): WebPrefsStore;
@@ -542,6 +555,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * notice when the owner is not working and nothing came back in time.
      */
     sweepReplyObligations(now?: Date): void;
+    private expireReplyObligations;
     private scheduleDeliveryOutboxPump;
     private runDeliveryOutboxPump;
     /**
@@ -558,6 +572,9 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private dispatchDurableDelivery;
     private waitForDurableLaneRelease;
     private spawnConcurrency;
+    /** #1685: "elevated" or "critical" while host memory pressure slows or holds new agents; otherwise null (an
+     *  unknown macOS reading — the advisory case — is unknown, so null too). */
+    private hostMemoryIndicator;
     /** Separate cooldown: changing measurements must not create new text-throttle keys. */
     private reportMemoryPressure;
     /** Wire the one fleet-wide storm into notification and recovery surfaces. */
@@ -901,6 +918,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * the check and the act, so the channel's instance cannot be rebound to another bot in between.
      */
     private dispatchSlash;
+    private dispatchSlashCore;
     /**
      * The door every Discord slash command goes through (src/slash-authz.ts has the rule and the reasoning): the scope
      * it lets the command into, or the reply that refuses it. Synchronous, so the dispatch acts on what it judged.
@@ -1128,7 +1146,10 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
         ttlMinutes: number;
     } | null;
     private tunnelPurposeLane;
+    private previewTunnel;
     private publicWebLink;
+    /** #1723: the public link's preview tunnel — a manager and lease of its own, never the fleet's one tunnel lane. */
+    private getPreviewTunnel;
     private getTunnelLane;
     private publicOwnerCurrent;
     /** Exact owning General. No primary-adapter or name fallback participates in authorization. */
@@ -1146,6 +1167,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     }, current: () => boolean): Promise<void>;
     /** Telegram's typed command enters through the same strict owner and nonce path as Discord. */
     dashboardMenu(msg: InboundMessage): Promise<void>;
+    /**
+     * #1686: build the Telegram deep-link that opens a DM with this bot pre-seeded with `/start web`.
+     * Returns null when no botUsername is known or the username fails Telegram's format validation.
+     */
+    private tgStartWebUrl;
     private sendLocalDashboard;
     /**
      * #1586: the sign-in code once more, as a message of its own, so a phone can copy it by itself: Telegram's monospace
@@ -1217,6 +1243,20 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private reportFullRestartFailure;
     failUpdateProgress(message: string): void;
     /** The old fleet edits CLI install stages; the new fleet adopts the same message below. */
+    /**
+     * #1660: arm the post-completion cleanup watch and make sure its monitor
+     * actually runs. The new fleet adopts the receipt at boot but nothing else
+     * starts this timer on that path (Prism a) — without this, the owed
+     * outcome would sit in the marker unwatched. READY never waits for it.
+     */
+    private armCleanupWatch;
+    /**
+     * #1660: append a recorded cleanup outcome to the adopted update message,
+     * then release the receipt — but only if this receipt still owns the
+     * marker. The await yields, so a newer receipt (e.g. a full-restart that
+     * landed mid-edit) must not be cleared or disturbed (Prism b).
+     */
+    private appendCleanupWarning;
     private startUpdateProgressMonitor;
     /** Start all instances from fleet config */
     startAll(configPath: string): Promise<void>;
@@ -1421,6 +1461,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     private resolveInboundTarget;
     private handleInboundMessage;
+    private handleInboundMessageCore;
     /** Handle outbound tool calls from a daemon instance */
     /** Warn (but don't block) when rate limits are high. 30-min debounce per instance. */
     private rateLimitWarnedAt;
@@ -1729,6 +1770,13 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private webIdentityImage;
     /** GET /ui/img/bot|avatar/<key>: what is cached, never a fetch. Only an own-bot connection, or a known instance's upload. */
     webImage(kind: "bot" | "avatar", key: string): CachedImage | null;
+    /**
+     * #1682 GET /ui/mentions: names for the mention ids a page found in what it rendered — never a Discord request; in order:
+     * the fleet's bots (an instance's own bot is that instance's label: fleet.yaml, and the View profiles read from
+     * profiles.db, as the status frame does), the people seen on inbound messages, and the Discord adapters' caches
+     * (members, users, roles, channels).
+     */
+    webMentionNames(query: MentionQuery): MentionNames;
     /** GET /ui/emojis: the custom emoji of every server the fleet's Discord bots are in (the Settings picker's cache). */
     webEmojiList(): Promise<Array<{
         id: string;
@@ -2039,6 +2087,19 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     orgChart(): OrgChart;
     private cacheService;
+    /**
+     * #1699: the credential profile an instance's CLI signs in with on `backend` — fleet.yaml's (with its defaults), or a
+     * ClassicBot room's launched or would-be login when the room runs that backend. Null: the backend's default login
+     * (also for a backend that has no profiles, where the option is ignored).
+     */
+    credentialProfileOf(name: string, backend: string): string | null;
+    /**
+     * #1699: the claude config dir an instance's CLI uses — its credential profile's, else exactly as before
+     * (CLAUDE_CONFIG_DIR or ~/.claude).
+     */
+    claudeConfigDirOf(name: string): string;
+    /** The instances the cache analysis reads: fleet.yaml's, then the ClassicBot rooms (their workspace under the AgEnD home, their own backend). */
+    private cacheInstances;
     /**
      * #1468: the prompt-cache expiry analysis for the web, per instance, over `window`. Read from each instance's
      * ledger as it is now; the first request starts the bounded, persisted catch-up over the transcripts
@@ -2174,7 +2235,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * Backends with no remote login flow (opencode logs in from a terminal) get
      * no button — the alert's own wording already tells them what to run.
      */
-    offerBackendLogin(targetInstance: string, backend: string): Promise<void>;
+    offerBackendLogin(targetInstance: string, backend: string, profile?: string): Promise<void>;
     /** Consume a General assist button exactly once. */
     private handleInteractivePromptAssist;
     /** Send a "🛑 Cancel" button to the instance's topic/channel after delivery. */
@@ -2407,6 +2468,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
         skipAuthCheck?: boolean;
         tokenPresent?: boolean;
         tunnel?: boolean;
+        profile?: string;
     }): Promise<string | null>;
     /** Which way a `/login` went (#1131) — so the event log shows what users actually need. */
     private recordLoginFlow;
@@ -2450,6 +2512,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
         chatId: string;
         threadId?: string;
         userId?: string;
+    }, signIn?: {
+        profile?: string;
     }): Promise<string>;
     /** Whether this backend's CLI is on the fleet's PATH (what `/login` installs when it is not). */
     isCliInstalled(backend: string): boolean;
@@ -2566,6 +2630,20 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** Forward a message to a classic channel instance with chat log context */
     private forwardToClassicInstance;
     /** Paste raw text directly to a classic instance's CLI (no [user:] wrapping) */
+    /** #1690: our own runtime switches awaiting the daemon's outcome, by id. */
+    private readonly runtimeSwitchWaiters;
+    /**
+     * #1690: type `/model <model>` and wait for what it came to: the daemon answers claude's "Switch model?" for us (Yes
+     * when it names this model, No otherwise) or sees claude's own result. Null when it could not be sent; a timeout is
+     * "not confirmed".
+     */
+    private runRuntimeModelSwitch;
+    /**
+     * #1690: the names claude-code is known to accept, for checking `/model <name>` BEFORE it is typed — claude itself
+     * accepts any string ("Set model to opsu"), and its "Switch model?" then names the typo. Static aliases (with [1m]),
+     * the cached account catalog, the configured model; without a cached catalog, any `claude-…` id too (cannot check).
+     */
+    private claudeModelKnown;
     private pasteRawToClassicInstance;
     /** Resolve the backend name configured for an instance (fleet or classic). */
     private backendNameForInstance;
@@ -2731,6 +2809,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     applyEffort(instanceName: string, requested: string): Promise<string>;
     applyModel(instanceName: string, model: string): Promise<string>;
+    /** Save an instance's model (fleet.yaml, or its ClassicBot channel). False when neither holds it. */
+    private persistInstanceModel;
     /**
      * The trailing "Current effort: …" line for a /model reply.
      *
@@ -2754,6 +2834,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private getMissingBackendWarning;
     /** Handle Discord's required static slash choice, warning before a likely startup failure. */
     private handleClassicStartSlash;
+    private handleClassicStartSlashCore;
     /** Present platform-native backend choices, then start on selection or timeout. */
     private beginClassicBackendSelection;
     /** Consume a selection callback. Returns true for all ClassicBot callback IDs, including stale ones. */
@@ -3065,6 +3146,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     previewForUi(hostHeader: string | undefined, secure: boolean): PreviewAvailability & {
         boot: string | null;
     };
+    /**
+     * #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.
+     */
+    publicPreviewForUi(exposureId: string, dashboardOrigin: string): PublicPreviewForUi;
     getUiStatus(): unknown;
     private getUiStatusSync;
 }