@songsid/agend 2.3.0-beta.25 → 2.3.0-beta.27

package/dist/fleet-manager.d.ts

@@ -57,12 +57,13 @@ export declare function applyTaskListCap<T extends {
 } | T[];
 import { type PublicPreviewForUi } from "./web-api.js";
 import { type LogAnswer, type LogQuery } from "./log-service.js";
-import { WebChatHistory } from "./web-chat-history.js";
+import { WebChatHistory, type WebChatPost } from "./web-chat-history.js";
 import { type WebEchoCopy } from "./web-reactions.js";
 import { SeenUsers, type MentionNames, type MentionQuery } from "./web-mentions.js";
 import { WebPrefsStore } from "./web-prefs.js";
 import { OwnerCssStore } from "./web-owner-css-store.js";
 import { ThemeStore } from "./web-theme-store.js";
+import { OfficeStore, OfficeWriteLimiter } from "./web-office-store.js";
 import { WebAppearance } from "./web-appearance.js";
 import { WebEffectLibrary } from "./web-effect-library.js";
 import { WebEffectTrials } from "./web-effect-trials.js";
@@ -290,7 +291,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private static readonly TOPIC_PROBE_ADAPTER_SCOPED_REASONS;
     logger: Logger;
     /** Report each bundled skill collision once per fleet, across instance starts. */
-    private skippedBundledSkills;
+    /** #2482: per skills directory, the skipped set (names + their content) last said — this process's view of the record. */
+    private skippedSkillsSaid;
     private topicCommands;
     sessionRegistry: Map<string, string>;
     eventLog: EventLog | null;
@@ -422,6 +424,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private adapterRestarting;
     /** #2175: this boot's progress message, whose completion may still be owed by its background retry. */
     private startupProgress;
+    private startupDashboard;
     private adapterState;
     private adapterRetryInFlight;
     /** Web Settings secret rotation is deliberately separate from reconnect
@@ -502,6 +505,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** Days of event/activity history to keep. */
     private static readonly EVENT_LOG_RETENTION_DAYS;
     private watchdogTimer;
+    private startupMemoryDeadline;
     private eventLoopWatch;
     private startedAt;
     private stormOpenNotifyTimer;
@@ -534,6 +538,22 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     readonly webFiles: WebFileLedger;
     /** #1770: per instance, its last web reply still copying its files — the next one is shown after it, in order. */
     private readonly webReplyOrder;
+    /**
+     * #1774: an instance name's reply generation — moved on when a removal of it starts, so replies sent from then on (a
+     * same-name replacement's) are told from the removed instance's. `webChatRemovals`: once a removal succeeded, the
+     * generations and the daemon whose replies are no longer anyone's to show.
+     */
+    private readonly webChatGenerations;
+    private readonly webChatRemovals;
+    /** #1774: a removal under way — its replies' fate waits for its outcome (success: theirs no more; failure: theirs). */
+    private readonly webChatRemovalsPending;
+    private webChatGeneration;
+    /** #1774: who an instance's reply is from, taken when it is sent: the name's generation and its daemon then. */
+    private webChatIdentity;
+    /** #1774: the reply's instance was not removed (a removal that failed changes nothing). */
+    private webChatIdentityCurrent;
+    /** #1774: the removal still deciding this reply's fate (it was sent by what is being removed), or null. */
+    private webChatRemovalPending;
     /** #1770: an instance's web-files byte cap (a field, so a test can make it small). */
     private webReplyMaxBytes;
     /** #1682: the people seen on inbound messages (id → name), for the web chat's mention pills; bounded, in memory. */
@@ -572,6 +592,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private webAppearanceService?;
     /** #1629: every instance's theme, placements, assets and lock (web-themes.json). */
     get themeStore(): ThemeStore;
+    private officeStoreInstance?;
+    /** Fleet → Org chart → Office: the offices people made (web-offices.json, beside web-themes.json). */
+    get officeStore(): OfficeStore;
+    /** How often a person may save the offices (PUT /ui/offices); memory only, as the appearance limiter. */
+    readonly officeWrites: OfficeWriteLimiter;
     /** #1629: the theme tools, a person's reset and lock, and the one appearance rate limiter (shared with effects). */
     get webAppearance(): WebAppearance;
     private effectLibraryInstance?;
@@ -1149,7 +1174,14 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
         error: string;
     }>;
     /** #2305: `copies` collects each room's copy (its message id), for a reaction to the web message. */
-    sendClassicWebEcho(instance: string, text: string, sender?: string, copies?: WebEchoCopy[]): Promise<number>;
+    /**
+     * `reply` (#2281): where the message a web reply quotes is on a platform. A room that has it gets the reply as a
+     * native reply to it (`reply.text`: without the quoted line); every other room gets `text`, as before.
+     */
+    sendClassicWebEcho(instance: string, text: string, sender?: string, copies?: WebEchoCopy[], reply?: {
+        posts: readonly WebChatPost[];
+        text: string;
+    }): Promise<number>;
     /**
      * #1666: a delivered web chat message starts the same cancel/progress lifecycle in the instance's topic as a platform
      * inbound (afterUserInboundDelivered): the same bubble, ticker and retire rules. Not its ✅ tracking — the web message
@@ -1296,6 +1328,9 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     resumePaused?: boolean, 
     /** Phase 2a: the caller's transition, for a start made from inside a restart or wake. */
     transition?: TransitionHandle, execution?: SettingsExecution): Promise<void>;
+    /** A boot's observation cannot settle a replacement boot or a newer attempt of the same instance. */
+    private trackStartupInstance;
+    private publishStartupStatus;
     /** Recreate a daemon for a marker-only paused instance after an explicit wake/delivery. */
     startPersistedPausedInstance(name: string, transition?: TransitionHandle): Promise<void>;
     /**
@@ -1497,10 +1532,27 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** #1742: `/start web` from a fleet admin: the /web menu right here in the DM, for the General this bot serves. */
     private startWebInDm;
     private getPublicWebLink;
+    private publicLinkAutoOpen;
+    /**
+     * #named-link-ttl: the admin who last opened a named-tunnel link from /web, with the live binding — only while they
+     * still may own one (publicOwnerCurrent: a fleet admin of a live bot, the same General). Else null.
+     */
+    private rememberedPublicOwner;
+    /** A named-tunnel link was privately delivered: auto_open reopens it for this owner after a restart. */
+    private rememberPublicLinkOwner;
+    /** Closed on purpose (Close, /web revoke): a restart must not reopen it. The next /web remembers again. */
+    private forgetPublicLinkOwner;
+    /**
+     * #named-link-ttl: `web.public_link.auto_open` — once per start, after the web listener and the chat connections are
+     * up. Opens the named link with nothing posted (sign-in still needs a code from /web or a returning device); a final
+     * failure goes to its owner once, by DM, drawn as a failed /web is.
+     */
+    private startPublicLinkAutoOpen;
     getPublicWebStatus(): {
         state: string;
         expiresAt?: number;
         remainingSeconds?: number;
+        noExpiry?: true;
     };
     confirmPublicWebLogin(info: {
         label: string;
@@ -1726,6 +1778,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private startUpdateProgressMonitor;
     /** Start all instances from fleet config */
     startAll(configPath: string): Promise<void>;
+    private startAllWithinDeadline;
     /** Keep Discord profile activity aligned with the same cached usage source as /usage. */
     private startDiscordUsagePresence;
     /**
@@ -2699,19 +2752,26 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     private instanceChannelTarget;
     /**
-     * #2352: the instance whose own channel lists a waiting card — the instance that handed it out, else its project's
-     * lead — when that channel can be used now (a fleet instance of a live world, with a topic or room). undefined: its
-     * assignee's world's General, as before.
+     * #2352: the instance whose own channel lists a waiting card — its project's lead — when that channel can be used now
+     * (a fleet instance of a live world, with a topic or room). undefined: its assignee's world's General, as before.
+     * #2434: only a card the person handed out waits for them, so the instance that handed one out is never its lane.
      */
     private needsYouLane;
     /**
      * #2355 review: where a card's Needs you buttons belong now — read from the board and the fleet at the moment of a click
      * or a reply, never from the last render. null: it no longer waits for the person.
      */
+    /**
+     * #2425 follow-up: an instance that handed out a card and is no longer in the fleet — neither a configured instance nor
+     * a ClassicBot identity (deleted). Its blocked and in-review cards fall back to the person (Needs you, the summary).
+     * Not known before the config and the ClassicBot rooms are loaded: then no one is gone (a live dispatcher's cards never
+     * flash into the person's list at startup).
+     */
+    readonly dispatcherGone: (name: string) => boolean;
     private needsYouRoute;
     /**
      * #2246 step 3: the task board's cards that wait for the person, for Needs you — under each card's assignee, listed in
-     * its lane's channel (#2352: the instance that handed it out, else the project's lead), else in General.
+     * its lane's channel (#2352: its project's lead; #2434: never the instance that handed it out), else in General.
      */
     private needsYouTaskItems;
     private needsYouTasks;
@@ -2827,6 +2887,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * it is now (a change since last seen moves the epoch first; authority-state.ts). No data directory: off.
      */
     webAuthorityState(): AuthorityState;
+    /**
+     * #2453 review: the web-authority state read on every configuration change (a Settings save, the host's confirm, a
+     * reload) — so a switch turned off and on again between two requests is still seen off: its epoch moves, and the
+     * named-link sessions' authorizations are dropped. Reads that only happen on a request would miss it.
+     */
+    private observeWebAuthority;
     /**
      * #1939 S2a: Settings → Web → Web authority — the state in force (the switch counts as off while its state cannot be
      * written), what fleet.yaml says, the hosts that make the dashboard reachable from elsewhere (the warning while
@@ -2843,7 +2909,10 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
             account: string;
             authorizedAt: number;
             until: number;
+            named?: true;
         }>;
+        /** #2453 (§0.2): the admin's named-tunnel hostname, while one is configured (the named-link row shows only then). */
+        namedHost: string | null;
     };
     private authorizationRequests;
     /**
@@ -3360,6 +3429,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * migration exception is the pre-manifest Kiro General layout explicitly
      * selected by adoptLegacyUnmanaged.
      */
+    /**
+     * #2482: the user's own skills that shadow bundled ones, said once per directory and change — not once per name on
+     * every start (11 lines a start on the host). The record (`skipped-skills.json` in the AgEnD home) keeps what was said
+     * across restarts; a new name or an edited SKILL.md is said again.
+     */
+    private reportSkippedSkills;
     private syncManagedSkills;
     /** Read AgEnD's roles extension from SKILL.md YAML frontmatter. */
     private readManagedSkillRoles;
@@ -3719,6 +3794,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     stopAll(): Promise<void>;
     private tmuxExecHelperTimer;
     private stopAllInFlight;
+    /** Stops release memory. Reassess between batches without waiting for recovery. */
+    private stopInstancesInBatches;
     private doStopAll;
     /**
      * Prune stale external sessions by re-querying each daemon for live sessions.