@songsid/agend 2.1.8-beta.2 → 2.1.8-beta.4

package/dist/fleet-context.d.ts

@@ -6,6 +6,7 @@ import type { Logger } from "./logger.js";
 import type { CostGuard } from "./cost-guard.js";
 import type { ClassicChannelManager } from "./classic-channel-manager.js";
 import type { ExplicitInstanceRemoval } from "./instance-removal.js";
+import type { BackendCliVersionSnapshot } from "./backend/types.js";
 export type RouteTarget = {
     kind: "instance";
     name: string;
@@ -68,6 +69,10 @@ export interface FleetContext {
     /** Classic-bot channels (defined in classicBot.yaml, not fleet.yaml instances). */
     readonly classicChannels: ClassicChannelManager | null;
     getSysInfo(): SysInfo;
+    /** Read cached CLI versions without triggering a probe. */
+    getBackendCliVersionSnapshot?(): BackendCliVersionSnapshot;
+    /** Refresh stale/missing CLI versions after the sysinfo reply has been sent. */
+    refreshBackendCliVersions?(): void;
     getInstanceStatus(name: string): "running" | "paused" | "stopped" | "crashed";
     /** Current cancellation epoch stamped onto direct daemon IPC deliveries. */
     getDeliveryEpoch?(name: string): number;

package/dist/fleet-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"fleet-context.js","sourceRoot":"","sources":["../src/fleet-context.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACpC,CAAC"}
+{"version":3,"file":"fleet-context.js","sourceRoot":"","sources":["../src/fleet-context.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACpC,CAAC"}

package/dist/fleet-manager.d.ts

@@ -1,13 +1,14 @@
 import { type FleetMemory } from "./process-memory.js";
 import { ReplyDeduper } from "./reply-dedup.js";
 import type { FleetConfig, RawFleetConfig, InstanceConfig } from "./types.js";
-import { type DeliveryStatus, type ResolvedStatusEmojis } from "./status-emojis.js";
+import { type DeliveryStatus, type GuildEmoji, type GuildEmojiGroup, type ResolvedStatusEmojis } from "./status-emojis.js";
 import { type RouteTarget } from "./fleet-context.js";
 import { EventLog } from "./event-log.js";
 import { AdapterWorld } from "./adapter-world.js";
 import { CostGuard } from "./cost-guard.js";
 import { IpcClient } from "./channel/ipc-bridge.js";
 import type { AdapterHealthSnapshot, ChannelAdapter, InboundReaction } from "./channel/types.js";
+import { type BackendCliVersionSnapshot } from "./backend/types.js";
 import { type Logger } from "./logger.js";
 import { Scheduler } from "./scheduler/index.js";
 import type { FleetContext } from "./fleet-context.js";
@@ -960,6 +961,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     private refuseTypedIpc;
     private dispatchTypedIpc;
+    /** `list_emojis` / `set_persona_emoji` / `preview_emojis` over IPC; the agent endpoint calls the same methods. */
+    private handlePersonaEmoji;
     private handleScheduleCrud;
     private handleDecisionCrud;
     /** Resolve display name for an instance, fallback to instance name. */
@@ -987,6 +990,9 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     handleDecisionCrudHttp(instance: string, op: string, args: Record<string, unknown>): Promise<unknown>;
     handleTaskCrudHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
     handleSetDisplayNameHttp(instance: string, name: string): Promise<unknown>;
+    handleListEmojisHttp(instance: string, refresh: boolean): Promise<unknown>;
+    handleSetPersonaEmojiHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
+    handlePreviewEmojisHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
     handleSetDescriptionHttp(instance: string, description: string): Promise<unknown>;
     private summarizeToolCall;
     private handleTaskCrud;
@@ -1077,6 +1083,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private deliveryStatusChains;
     /** #725: in-flight CLI env probes, keyed by backend name. Coalesces concurrent /model requests. */
     private pendingCliEnvProbes;
+    /** Forced vendor catalog refreshes are separate flights, but sysinfo joins either flight. */
+    private pendingVendorCliEnvProbes;
     /**
      * The status emojis for an instance (#1005): its own `status_emojis`, then
      * its channel's `options.status_emojis`, then the platform built-in. An
@@ -1088,27 +1096,67 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     };
     private warnedStatusEmojis;
     /**
-     * A Discord connection's server emojis for the Settings picker (#1005).
-     * Cached per connection — a server's emoji set changes rarely — and one
-     * fetch at a time; `refresh` forces a new one. Uses the running adapter, so
-     * the bot token never leaves the server.
+     * A Discord connection's server emojis for the Settings picker (#1005), from
+     * every server its bot can draw on (#1021): the primary `group_id` server,
+     * then each other server the bot is a member of that ClassicBot's
+     * `allowed_guilds` admits (unset = all, as for classic routing). A bot can
+     * react with a custom emoji from any server it is in. Cached per server — a
+     * server's emoji set changes rarely — and one fetch per server at a time;
+     * `refresh` forces new ones. One server refusing (e.g. Missing Access) is
+     * reported on that server and does not hide the others. Uses the running
+     * adapter, so the bot token never leaves the server.
      */
     listGuildEmojis(channelId: string, refresh?: boolean): Promise<{
         ok: true;
         fetched_at: number;
-        emojis: Array<{
-            id: string;
-            name: string;
-            animated: boolean;
-            available: boolean;
-        }>;
+        emojis: GuildEmoji[];
+        guilds: GuildEmojiGroup[];
     } | {
         ok: false;
         error: string;
     }>;
     private static GUILD_EMOJI_TTL_MS;
+    /** Keyed `<connection>\0<server id>`. */
     private guildEmojiCache;
     private guildEmojiFetches;
+    /**
+     * What `instanceName` may pick as its persona emoji (the `list_emojis`
+     * tool): its current status set with where each value comes from, the
+     * standard emojis its platform takes, and on Discord the server emojis its
+     * bot can draw on — the same lists, and the same resolution, as the
+     * Settings picker (#1005/#1021), so an agent and an operator see one truth.
+     */
+    listEmojisFor(instanceName: string, refresh?: boolean): Promise<Record<string, unknown>>;
+    /**
+     * `preview_emojis` (#1040): download a few Discord server emojis so an agent
+     * can look at them before it picks one — a name and an id say nothing about
+     * what an emoji looks like. The fleet fetches, not the agent (not every
+     * backend can), and returns a local path per emoji to Read, as
+     * download_attachment does for an attachment.
+     *
+     * SSRF-safe by construction: nothing from the caller reaches a URL. The
+     * caller names emojis; each must be an available one in a server this bot
+     * can draw on (the list set_persona_emoji checks), and the CDN URL is built
+     * from that listed emoji's numeric id. Static PNG, size-capped, cached by id.
+     */
+    previewEmojis(instanceName: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private static EMOJI_PREVIEW_MAX;
+    private static EMOJI_PREVIEW_MAX_BYTES;
+    private static EMOJI_PREVIEW_TTL_MS;
+    /** One emoji's static PNG under the inbox, reused while fresh; stale ones are pruned. */
+    private fetchEmojiPreview;
+    /**
+     * `set_persona_emoji`: `instanceName` sets one of its own status emojis —
+     * `delivered` unless it names another — in its per-instance `status_emojis`
+     * override (#1005 addendum 2), so its stamp is told apart from other bots'
+     * on a shared message. The value is judged exactly as Settings and the
+     * react path judge it (statusEmojiProblem on the instance's platform), and
+     * a Discord server emoji must be one its bot can use: an emoji from a
+     * server it is not in would be stored, preview fine, and fail every react.
+     * An empty emoji removes that status's override.
+     */
+    setPersonaEmoji(instanceName: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private personaEmojiMissing;
     /** What the instructions tell `instanceName` not to react with (its own status set). */
     statusEmojiAvoidList(instanceName: string): string[];
     /** The progress bubble's leading emoji, in the form the channel renders. */
@@ -1711,6 +1759,10 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private cliEnvPath;
     /** Read the cached CLI env for a backend, or null if missing/stale/unparseable. */
     private readCliEnv;
+    /** Return cached CLI versions immediately. Refresh is started after /sysinfo is sent. */
+    getBackendCliVersionSnapshot(): BackendCliVersionSnapshot;
+    /** Called only after the user-visible sysinfo send/respond has settled. */
+    refreshBackendCliVersions(): void;
     /** True when a cached CLI env is old enough that `/model` should re-probe. */
     private cliEnvNeedsRefresh;
     /**
@@ -1719,6 +1771,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * previous list, never stall the command that asked for it.
      */
     private probeBackendBounded;
+    private startCliEnvProbeWorker;
     /**
      * Resolve the effective model for a fleet or ClassicBot instance, plus where it
      * came from. Single source of truth for `/model` and `/ctx` — precedence:
@@ -1745,6 +1798,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * the old list off as fresh.
      */
     private probeBackend;
+    /** Preserve the existing cache merge rules for both in-process and worker probes. */
+    private persistCliEnvProbeResult;
     /** Background-probe every distinct backend in use at startup (non-blocking). */
     private probeCliEnvs;
     /** Best-effort model list for `/model`: cached CLI env first, else live probe. Never throws. */