@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/fleet-context.d.ts

@@ -105,6 +105,11 @@ export interface FleetContext {
      * keep working (they fall back to the receiving adapter).
      */
     getInstanceAdapterId?(instanceName: string): string | undefined;
+    /** #1990: a message for world `worldId`'s group with its place tokens rendered (fleet-manager.ts renderPlaces). */
+    renderPlaces?(worldId: string | undefined, text: string, opts?: import("./channel/types.js").SendOpts): {
+        text: string;
+        opts?: import("./channel/types.js").SendOpts;
+    };
     changeInstancePauseState(name: string, action: "pause" | "wake"): Promise<"paused" | "awake" | "not_idle">;
     startInstance(name: string, config: InstanceConfig, topicMode: boolean): Promise<void>;
     /** #1716: resolves whether the stop ended background work that was running. */

package/dist/fleet-manager.d.ts

@@ -57,10 +57,21 @@ import { type LogAnswer, type LogQuery } from "./log-service.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 { OwnerCssStore } from "./web-owner-css-store.js";
+import { ThemeStore } from "./web-theme-store.js";
+import { WebAppearance } from "./web-appearance.js";
+import { WebEffectLibrary } from "./web-effect-library.js";
+import { WebEffectTrials } from "./web-effect-trials.js";
+import { WebEffectService } from "./web-effect-service.js";
+import { WebEffectProfiles } from "./web-effect-profiles.js";
+import { WebEffectTools } from "./web-effect-tools.js";
 import { type WebAccount } from "./web-profile.js";
 import type { WebPerson as WebPersonView } from "./web-api.js";
 import { ReplyButtonsController } from "./reply-buttons-controller.js";
 import { WebFileLedger } from "./web-upload.js";
+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 { type RawConfigPatch } from "./settings-api.js";
 import { type AgentEndpointContext } from "./agent-endpoint.js";
@@ -512,6 +523,57 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     private webNameReserved;
     private webNameTaken;
+    private themeStoreInstance?;
+    private webAppearanceService?;
+    /** #1629: every instance's theme, placements, assets and lock (web-themes.json). */
+    get themeStore(): ThemeStore;
+    /** #1629: the theme tools, a person's reset and lock, and the one appearance rate limiter (shared with effects). */
+    get webAppearance(): WebAppearance;
+    private effectLibraryInstance?;
+    private effectTrialsInstance?;
+    /** Lazy, single-owner storage. Register every host reference source before any operation can collect. */
+    get effectLibrary(): WebEffectLibrary;
+    /** Volatile Try offers and session-bound runs share this library. */
+    get effectTrials(): WebEffectTrials;
+    private effectProfilesInstance?;
+    get effectProfiles(): WebEffectProfiles;
+    private effectServiceInstance?;
+    get effectService(): WebEffectService;
+    private effectToolsService?;
+    /** Caller identity is supplied only by the owned IPC connection / verified agent endpoint token. */
+    get effectTools(): WebEffectTools;
+    private appearanceToolsService?;
+    /** #1629 r4 §1: get_web_appearance / preview_web_appearance — the caller's own look, resolved as the page resolves it. */
+    get appearanceTools(): AppearanceTools;
+    /** #1958: a profile, card or colour write (view-api.ts) landed: every open page gets a fresh status frame. */
+    identityChanged(): void;
+    /** A fleet.yaml instance (own key) or a ClassicBot room, now (#1629: a person's reset/lock names one). */
+    isKnownInstance(name: string): boolean;
+    private modStore?;
+    /**
+     * #1629 r4-5 / B2: installed mods use the same validated library and scoped holder claims as direct uploads.
+     */
+    get mods(): ModStore;
+    private agentModsService?;
+    /** #1629 r4-5b: export_web_mod / propose_web_mod — the caller's own look as a file, and a proposal for a person. */
+    get agentMods(): AgentMods;
+    /**
+     * #1629 r4-5c: an effect as this person may carry it away in an export — their own claim, or one a person shared —
+     * read with their principal (Sol's ACL). Being able to view or run a placed effect never grants packaging someone
+     * else's private claim: the library's reference read is runtime access, not an export path. Null: not theirs.
+     */
+    modPlacedEffect(person: string, id: string): {
+        name: string;
+        files: ReadonlyMap<string, Uint8Array>;
+    } | null;
+    /** #1629 r4-5: an instance's card text as every viewer sees it (a person's fields over the agent's). */
+    modCardText(name: string): {
+        tagline?: string;
+        bio?: string;
+    };
+    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;
     get webPrefs(): WebPrefsStore;
     /**
      * Read from disk on every access rather than cached at startup: `agend
@@ -1506,6 +1568,22 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private disposeSettingsAdapter;
     /** Restart a channel adapter after fatal error with infinite retry + 60s cap */
     private restartAdapter;
+    /**
+     * #1990: how a reader in world `worldId`'s group reaches a place token's target — undefined (plain text) for another
+     * world's instance, an instance without a fleet topic (a ClassicBot room may be anywhere), or an id no link is built
+     * from. Discord: the channel mention; Telegram: the topic URL (General's topic included).
+     */
+    private placeLink;
+    /** #1990: a message for world `worldId`'s group with its place tokens rendered (links as text or Telegram entities). */
+    renderPlaces(worldId: string | undefined, text: string, opts?: import("./channel/types.js").SendOpts): {
+        text: string;
+        opts?: import("./channel/types.js").SendOpts;
+    };
+    /** #1990: renderPlaces for the world that owns `instanceName`'s topic. */
+    renderPlacesFor(instanceName: string, text: string, opts?: import("./channel/types.js").SendOpts): {
+        text: string;
+        opts?: import("./channel/types.js").SendOpts;
+    };
     /** Handle inbound message — transcribe voice if present, then route */
     private findGeneralInstance;
     /**
@@ -1724,6 +1802,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      */
     private refuseTypedIpc;
     private dispatchTypedIpc;
+    /**
+     * #1629: the caller's own web theme over IPC (the agent endpoint calls the same service). `name` is the instance this
+     * IPC connection belongs to — never anything the message says. A refusal is a result the agent reads (its `error`
+     * and what to do), not a transport error.
+     */
+    private handleWebTheme;
     /** `list_emojis` / `set_persona_emoji` / `preview_emojis` / `list_stickers` / `preview_stickers` over IPC; the agent endpoint calls the same methods. */
     private handlePersonaEmoji;
     private handleScheduleCrud;
@@ -1759,6 +1843,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     handleListStickersHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
     handlePreviewStickersHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
     handleSetPersonaEmojiHttp(instance: string, args: Record<string, unknown>): Promise<unknown>;
+    /** #1629: `agend-agent theme …` — the same service as the tools; `instance` is the token's. */
+    handleWebThemeHttp(instance: string, tool: 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;
@@ -2285,6 +2371,9 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
      * (cache-service.ts) — never a vendor call, never a synchronous transcript read.
      */
     cacheReport(window: string): Promise<CacheReport>;
+    /** #2001: get_cache_report's — the same report, as last worked out (reused for a minute, until the next pass). */
+    cacheReportPublished(window: string): Promise<CacheReport>;
+    private cacheServiceFor;
     /** The web's Acknowledge (any item; a signed-in session is fleet-admin level). */
     acknowledgeNeedsItem(id: string, principal: string): {
         status: 200 | 400 | 404 | 409 | 500;
@@ -2309,6 +2398,7 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
             label: string;
         }>;
         expiresAt: number;
+        links?: import("./topic-link.js").TextLink[];
     }>;
     /**
      * A click on a prompt in the web dashboard (web track C4). It is the platform click, made by the
@@ -2744,6 +2834,8 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private restoreWebChat;
     /** #1565: who an instance is, for its web chat file: its working directory, or its ClassicBot room; null if neither. */
     private webChatOwner;
+    /** The only Try-card publisher: no arbitrary SSE sender/role can manufacture this metadata. */
+    private publishEffectTrial;
     /** Push an SSE event to all connected Web UI clients. */
     emitSseEvent(event: string, data: unknown): void;
     listClaimedTasks(assignee: string): Array<{