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

package/dist/tool-permissions.d.ts

@@ -74,13 +74,6 @@ export declare const IPC_TYPE_TOOLS: Readonly<Record<string, string>>;
  * table built from the map alone would have six gaps in it.
  */
 export declare const EARLY_AGENT_OP_TOOLS: Readonly<Record<string, string>>;
-/**
- * What to say to an agent that was refused.
- *
- * It will read this as an instruction, so it says what to do instead rather
- * than only what went wrong. Naming the profile matters too: "not allowed" with
- * no reason invites retrying.
- */
 export declare function toolRefusedMessage(profile: ToolSetName, tool: string): string;
 /**
  * #2001: whose rows get_cache_report shows a caller — every instance's and the fleet summary for the profiles that

package/dist/tool-permissions.js

@@ -42,6 +42,8 @@ const WORKER = [
     "get_fleet_status", "get_fleet_config", "get_usage", "get_effort", "get_instance_logs", "kiro_engine_status",
     // #2001: the prompt-cache report — its own row only, unless the profile reads the fleet (cacheReportScope).
     "get_cache_report",
+    // #2122: the usage report — its own row only, unless the profile reads the fleet (cacheReportScope).
+    "get_usage_report",
     "list_decisions", "list_schedules", "list_deployments", "validate_config",
     // Its own things.
     "task", "post_decision", "set_display_name", "set_description", "list_emojis", "set_persona_emoji", "preview_emojis",
@@ -52,6 +54,8 @@ const WORKER = [
     "get_web_appearance", "preview_web_appearance",
     // Its own declarative widgets (#1629 r4-4): no target, the same lock and limits.
     "set_web_widget", "remove_web_widget",
+    // Its own declarative ambient (#2117): no target, the same lock and limits.
+    "set_web_ambient", "clear_web_ambient",
     // Mods (#1629 r4-5b): its own look as a file, and proposing one for a person — never importing.
     "export_web_mod", "propose_web_mod",
     "upload_web_effect", "list_web_effects", "preview_web_effect", "profile_web_effect", "apply_web_effect", "remove_web_effect", "delete_web_effect",
@@ -76,6 +80,8 @@ const ORCHESTRATION = [
     "update_fleet_defaults", "update_instance_config",
     // Changing a decision somebody else recorded; `post_decision` adds, and stays.
     "update_decision",
+    // #2056: Settings → Web appearance for the user (General has these too; a worker changes only its own theme).
+    "get_web_settings", "set_web_settings",
 ];
 const ALL_TOOLS = TOOLS.map(t => t.name);
 /**
@@ -90,7 +96,7 @@ export const TOOL_PROFILES = {
     coordinator: [...WORKER, ...ORCHESTRATION],
     general: [
         "reply", "react", "edit_message", "download_attachment", "close_poll",
-        "list_teams", "list_instances", "describe_instance", "get_fleet_status", "get_usage", "get_effort", "list_models", "get_cache_report",
+        "list_teams", "list_instances", "describe_instance", "get_fleet_status", "get_usage", "get_effort", "list_models", "get_cache_report", "get_usage_report",
         // Read-only: what each kiro instance runs on, for explaining a kiro incompatibility.
         "kiro_engine_status",
         "send_to_instance", "delegate_task", "request_information", "report_result", "broadcast", "delivery_status",
@@ -101,9 +107,20 @@ export const TOOL_PROFILES = {
         // a dispatcher can choose its own status stamp like any worker.
         "list_emojis", "preview_emojis", "set_persona_emoji",
         "list_stickers", "preview_stickers",
-        // Its own web theme (#1629), like its own status stamp. (The read-only appearance tools stay out: this profile is
-        // the lean one — a dispatcher reads its theme with get_web_theme.)
+        // Its own identity — same as any worker.
+        "set_display_name", "set_description",
+        // Its own web theme (#1629), like its own status stamp.
         "get_web_theme", "set_web_theme", "set_web_theme_asset", "reset_web_theme",
+        // Own-appearance family (#2132 + user decision hmsg-07371500): no target, caller-scoped.
+        // General carries the full own-appearance family — same as a worker (#2134 opened, user added
+        // ambient and effect tools on 2026-10-18).
+        "get_web_appearance", "preview_web_appearance",
+        "set_web_widget", "remove_web_widget",
+        "set_web_ambient", "clear_web_ambient",
+        "export_web_mod", "propose_web_mod",
+        "upload_web_effect", "list_web_effects", "preview_web_effect", "profile_web_effect", "apply_web_effect", "remove_web_effect", "delete_web_effect",
+        // #2056: Settings → Web appearance for the user (the page's own checks; a worker's are its own theme only).
+        "get_web_settings", "set_web_settings",
     ],
     standard: [
         "reply", "react", "edit_message", "close_poll",
@@ -111,9 +128,9 @@ export const TOOL_PROFILES = {
         "list_decisions", "post_decision", "task", "set_display_name", "set_description", "list_emojis", "set_persona_emoji", "preview_emojis",
         "list_stickers", "preview_stickers",
         "get_web_theme", "set_web_theme", "set_web_theme_asset", "reset_web_theme",
-        "get_web_appearance", "preview_web_appearance", "set_web_widget", "remove_web_widget", "export_web_mod", "propose_web_mod",
+        "get_web_appearance", "preview_web_appearance", "set_web_widget", "remove_web_widget", "set_web_ambient", "clear_web_ambient", "export_web_mod", "propose_web_mod",
         "upload_web_effect", "list_web_effects", "preview_web_effect", "profile_web_effect", "apply_web_effect", "remove_web_effect", "delete_web_effect",
-        "validate_config", "get_fleet_status", "get_usage", "get_effort", "get_instance_logs", "get_fleet_config", "kiro_engine_status", "get_cache_report",
+        "validate_config", "get_fleet_status", "get_usage", "get_effort", "get_instance_logs", "get_fleet_config", "kiro_engine_status", "get_cache_report", "get_usage_report",
         // Self-scheduling, same scope as worker (#895).
         "create_schedule", "list_schedules", "update_schedule", "delete_schedule",
     ],
@@ -226,6 +243,8 @@ export const IPC_TYPE_TOOLS = {
     fleet_preview_web_appearance: "preview_web_appearance",
     fleet_set_web_widget: "set_web_widget",
     fleet_remove_web_widget: "remove_web_widget",
+    fleet_set_web_ambient: "set_web_ambient",
+    fleet_clear_web_ambient: "clear_web_ambient",
     fleet_export_web_mod: "export_web_mod",
     fleet_propose_web_mod: "propose_web_mod",
     fleet_upload_web_effect: "upload_web_effect",
@@ -252,6 +271,7 @@ export const EARLY_AGENT_OP_TOOLS = {
     "decision-post": "post_decision",
     "decision-create": "post_decision",
     "decision-list": "list_decisions",
+    "decision-get": "list_decisions",
     "decision-update": "update_decision",
     task: "task",
     usage: "get_usage",
@@ -271,6 +291,8 @@ export const EARLY_AGENT_OP_TOOLS = {
     "appearance-preview": "preview_web_appearance",
     "widget-set": "set_web_widget",
     "widget-remove": "remove_web_widget",
+    "ambient-set": "set_web_ambient",
+    "ambient-clear": "clear_web_ambient",
     "mod-export": "export_web_mod",
     "mod-propose": "propose_web_mod",
     "effect-upload": "upload_web_effect",
@@ -287,8 +309,25 @@ export const EARLY_AGENT_OP_TOOLS = {
  * It will read this as an instruction, so it says what to do instead rather
  * than only what went wrong. Naming the profile matters too: "not allowed" with
  * no reason invites retrying.
+ *
+ * Own-appearance tools (no target, act only on the caller's look) need a wider
+ * worker-tier profile, not a coordinator — suggesting coordinator for a
+ * cosmetic change is misleading and grants far more than needed. (#2132)
  */
+const OWN_APPEARANCE_TOOLS = new Set([
+    "get_web_theme", "set_web_theme", "set_web_theme_asset", "reset_web_theme",
+    "get_web_appearance", "preview_web_appearance",
+    "set_web_widget", "remove_web_widget",
+    "set_web_ambient", "clear_web_ambient",
+    "export_web_mod", "propose_web_mod",
+    "upload_web_effect", "list_web_effects", "preview_web_effect", "profile_web_effect",
+    "apply_web_effect", "remove_web_effect", "delete_web_effect",
+]);
 export function toolRefusedMessage(profile, tool) {
+    if (OWN_APPEARANCE_TOOLS.has(tool)) {
+        return `${tool} is not available to this instance: it runs with the "${profile}" tool set, and ${tool} is an own-appearance tool (no target; acts only on the caller's look). `
+            + 'Ask an administrator to set `tool_set: worker` or `tool_set: standard` for this instance.';
+    }
     return `${tool} is not available to this instance: it runs with the "${profile}" tool set, and ${tool} belongs to a coordinator. `
         + "Report what you need with report_result and let the coordinator do it, "
         + 'or ask an administrator to set `tool_set: coordinator` for this instance.';

package/dist/tool-permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-permissions.js","sourceRoot":"","sources":["../src/tool-permissions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-permissions.js","sourceRoot":"","sources":["../src/tool-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAI/C,yFAAyF;AACzF,MAAM,MAAM,GAAsB;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY;IACrE,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,gDAAgD;IAChD,kBAAkB,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB;IAC3G,4DAA4D;IAC5D,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa;IAClE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB;IAC5G,4GAA4G;IAC5G,kBAAkB;IAClB,qGAAqG;IACrG,kBAAkB;IAClB,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB;IACzE,kBAAkB;IAClB,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB;IACpH,eAAe,EAAE,kBAAkB;IACnC,oHAAoH;IACpH,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB;IAC1E,qEAAqE;IACrE,oBAAoB,EAAE,wBAAwB;IAC9C,iFAAiF;IACjF,gBAAgB,EAAE,mBAAmB;IACrC,4EAA4E;IAC5E,iBAAiB,EAAE,mBAAmB;IACtC,gGAAgG;IAChG,gBAAgB,EAAE,iBAAiB;IACnC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB;IACjJ,0EAA0E;IAC1E,uEAAuE;IACvE,6EAA6E;IAC7E,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB;IACvD,gFAAgF;IAChF,eAAe,EAAE,cAAc;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,aAAa,GAAsB;IACvC,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB;IACxD,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB;IACxF,iBAAiB,EAAE,qBAAqB;IACxC,aAAa,EAAE,aAAa,EAAE,aAAa;IAC3C,uBAAuB,EAAE,wBAAwB;IACjD,+EAA+E;IAC/E,iBAAiB;IACjB,8GAA8G;IAC9G,kBAAkB,EAAE,kBAAkB;CACvC,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqD;IAC7E,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC;IAC1C,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY;QACrE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB;QACzJ,qFAAqF;QACrF,oBAAoB;QACpB,kBAAkB,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB;QAC3G,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe;QACxE,MAAM,EAAE,gBAAgB,EAAE,eAAe;QACzC,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB;QACzE,0EAA0E;QAC1E,gEAAgE;QAChE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB;QACpD,eAAe,EAAE,kBAAkB;QACnC,yCAAyC;QACzC,kBAAkB,EAAE,iBAAiB;QACrC,wDAAwD;QACxD,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB;QAC1E,yFAAyF;QACzF,8FAA8F;QAC9F,2CAA2C;QAC3C,oBAAoB,EAAE,wBAAwB;QAC9C,gBAAgB,EAAE,mBAAmB;QACrC,iBAAiB,EAAE,mBAAmB;QACtC,gBAAgB,EAAE,iBAAiB;QACnC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB;QACjJ,4GAA4G;QAC5G,kBAAkB,EAAE,kBAAkB;KACvC;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY;QAC9C,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB;QACzF,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB;QACtI,eAAe,EAAE,kBAAkB;QACnC,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB;QAC1E,oBAAoB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB;QAClK,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB;QACjJ,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB;QACvK,gDAAgD;QAChD,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB;KAC1E;IACD,2EAA2E;IAC3E,8EAA8E;IAC9E,wEAAwE;IACxE,kEAAkE;IAClE,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,CAAC;CACzK,CAAC;AAEF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CACZ,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,IAAY;IAC3D,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAkE,EAClE,IAAY,EACZ,eAA4B,QAAQ;IAEpC,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;IAClC,IAAI,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,MAAM,EAAE,aAAa,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxG,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAqC;IAC9D,qBAAqB,EAAE,iBAAiB;IACxC,mBAAmB,EAAE,gBAAgB;IACrC,qBAAqB,EAAE,iBAAiB;IACxC,qBAAqB,EAAE,iBAAiB;IACxC,qBAAqB,EAAE,eAAe;IACtC,mBAAmB,EAAE,gBAAgB;IACrC,qBAAqB,EAAE,iBAAiB;IACxC,UAAU,EAAE,MAAM;IAClB,sBAAsB,EAAE,kBAAkB;IAC1C,qBAAqB,EAAE,iBAAiB;IACxC,iBAAiB,EAAE,aAAa;IAChC,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,mBAAmB,EAAE,eAAe;IACpC,sBAAsB,EAAE,kBAAkB;IAC1C,mBAAmB,EAAE,eAAe;IACpC,mBAAmB,EAAE,eAAe;IACpC,yBAAyB,EAAE,qBAAqB;IAChD,qBAAqB,EAAE,iBAAiB;IACxC,wBAAwB,EAAE,oBAAoB;IAC9C,4BAA4B,EAAE,wBAAwB;IACtD,oBAAoB,EAAE,gBAAgB;IACtC,uBAAuB,EAAE,mBAAmB;IAC5C,qBAAqB,EAAE,iBAAiB;IACxC,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,qBAAqB,EAAE,iBAAiB;IACxC,uBAAuB,EAAE,mBAAmB;IAC5C,sBAAsB,EAAE,kBAAkB;IAC1C,wBAAwB,EAAE,oBAAoB;IAC9C,wBAAwB,EAAE,oBAAoB;IAC9C,sBAAsB,EAAE,kBAAkB;IAC1C,uBAAuB,EAAE,mBAAmB;IAC5C,uBAAuB,EAAE,mBAAmB;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,iBAAiB,EAAE,iBAAiB;IACpC,eAAe,EAAE,gBAAgB;IACjC,iBAAiB,EAAE,iBAAiB;IACpC,iBAAiB,EAAE,iBAAiB;IACpC,0EAA0E;IAC1E,yEAAyE;IACzE,eAAe,EAAE,eAAe;IAChC,iBAAiB,EAAE,eAAe;IAClC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,iBAAiB;IACpC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,kBAAkB;IAC1B,iBAAiB,EAAE,iBAAiB;IACpC,MAAM,EAAE,aAAa;IACrB,eAAe,EAAE,mBAAmB;IACpC,eAAe,EAAE,gBAAgB;IACjC,QAAQ,EAAE,eAAe;IACzB,iBAAiB,EAAE,kBAAkB;IACrC,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,iBAAiB;IAChC,gBAAgB,EAAE,oBAAoB;IACtC,oBAAoB,EAAE,wBAAwB;IAC9C,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,iBAAiB;IAChC,eAAe,EAAE,mBAAmB;IACpC,YAAY,EAAE,gBAAgB;IAC9B,aAAa,EAAE,iBAAiB;IAChC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,oBAAoB;IACtC,gBAAgB,EAAE,oBAAoB;IACtC,cAAc,EAAE,kBAAkB;IAClC,eAAe,EAAE,mBAAmB;IACpC,eAAe,EAAE,mBAAmB;CACrC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB;IAC1E,oBAAoB,EAAE,wBAAwB;IAC9C,gBAAgB,EAAE,mBAAmB;IACrC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,iBAAiB;IACnC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB;IACnF,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB;CAC7D,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,OAAoB,EAAE,IAAY;IACnE,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,GAAG,IAAI,yDAAyD,OAAO,mBAAmB,IAAI,0EAA0E;cAC3K,2FAA2F,CAAC;IAClG,CAAC;IACD,OAAO,GAAG,IAAI,yDAAyD,OAAO,mBAAmB,IAAI,6BAA6B;UAC9H,yEAAyE;UACzE,2EAA2E,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAgB,GAA6B,IAAI,GAAG,CAAc,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAC5G;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,MAAc,EACd,EAAc,EACd,OAAkG;IAElG,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAG,EAAE,WAAW,CAAC;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;IAC1D,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,SAAS,IAAI,MAAM,CAAC;QACnC,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,MAAM,GAAG,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,2EAA2E;IAC3E,qCAAqC;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7D,OAAO,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EACjD,QAAQ,CAAC,MAAM,KAAK,MAAM;YACxB,CAAC,CAAC,mCAAmC,QAAQ,CAAC,MAAM,GAAG;YACvD,CAAC,CAAC,sBAAsB,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,EAAE,KAAK,QAAQ,IAAI,SAAS,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzD,OAAO,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,yBAAyB,SAAS,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+FAA+F;AAC/F,SAAS,sBAAsB,CAAC,OAAoB,EAAE,IAAY,EAAE,MAAc,EAAE,SAAiB;IACnG,OAAO,GAAG,IAAI,wBAAwB,OAAO,6DAA6D;UACtG,yBAAyB,MAAM,yCAAyC,SAAS,IAAI;UACrF,sFAAsF;UACtF,yCAAyC,CAAC;AAChD,CAAC"}

package/dist/topic-commands.d.ts

@@ -1,3 +1,4 @@
+import { sanitizeInstanceName } from "./instance-names.js";
 import type { FleetContext } from "./fleet-context.js";
 import type { InboundMessage } from "./channel/types.js";
 import type { ChannelConfig } from "./types.js";
@@ -12,7 +13,7 @@ type ExecutionFleetContext = FleetContext & {
     instanceLaunchSupportsSteer?(instanceName: string): boolean | undefined;
 };
 /** Sanitize a directory name into a valid instance name. Keeps Unicode letters (incl. CJK). */
-export declare function sanitizeInstanceName(name: string): string;
+export { sanitizeInstanceName };
 /** Digits of the topic id kept in a fresh instance-name suffix; lengthened on collision. */
 export declare const INSTANCE_NAME_SUFFIX_DIGITS = 6;
 /**
@@ -185,12 +186,21 @@ export declare const CLEAR_UNSUPPORTED_MSG = "\u26A0\uFE0F Clear is not supporte
 export declare function formatContextUsageLine(context: number, tokenRatio?: TokenContextRatio | null): string;
 /** Claude Code statusline.json context used % (null if missing / unreadable). */
 export declare function readStatuslineContextPct(dataDir: string, instanceName: string): number | null;
+/**
+ * #1956 step 3: an instance's statusline.json, parsed — undefined when there is none or it is not JSON. A caller that
+ * needs several of its fields reads it once (the fleet's status read it three times per instance per build).
+ */
+export declare function readStatuslineJson(dataDir: string, instanceName: string): unknown;
+/** The context percentage a parsed statusline reports (readStatuslineContextPct's rule). */
+export declare function statuslineContextPct(data: unknown): number | null;
 /**
  * Claude Code's statusline payload reports the model that actually served the
  * current session. This can differ from fleet.yaml after the CLI rejects a
  * plan-gated model and keeps using its previous/default model.
  */
 export declare function readStatuslineModel(dataDir: string, instanceName: string): string | null;
+/** The model a parsed statusline reports (readStatuslineModel's rule). */
+export declare function statuslineModel(data: unknown): string | null;
 /** Live-pane scrape used by /ctx, /status Ctx, and /view sidebar. */
 export declare function scrapePaneContext(instanceName: string, backend: string): {
     context: number | null;
@@ -208,6 +218,7 @@ export declare function forgetInstanceContext(instanceName: string): void;
 export declare function resolveInstanceContext(dataDir: string, instanceName: string, backend: string, opts?: {
     bypassCache?: boolean;
     source?: import("./pane-context-cache.js").PaneContextSource | null;
+    statusline?: unknown;
 }): {
     context: number | null;
     tokenRatio: TokenContextRatio | null;
@@ -255,6 +266,11 @@ export declare class TopicCommands {
      * delivery action; rendering or previewing this text cannot retire a code.
      */
     getDashboardText(_htmlSpoiler?: boolean, showRemoteHint?: boolean): string;
+    /**
+     * #1920 step 4: a non-admin's typed `/web` while guest sign-in is on — in General or any topic of the fleet (the
+     * table keeps /web for fleet admins, so this runs before it). The code goes by DM; only a short line is posted here.
+     */
+    private guestWeb;
     /**
      * /dashboard (TG): admin-only menu in General; codes are sent privately.
      * `/dashboard revoke` also closes the public link and signs browsers out.

package/dist/topic-commands.js

@@ -1,4 +1,5 @@
 import { PaneContextCache } from "./pane-context-cache.js";
+import { sanitizeInstanceName } from "./instance-names.js";
 import { LOGIN_BACKEND_ALIASES } from "./login-flows.js";
 import { measureSyncWork } from "./sync-work-attribution.js";
 import { LOOPBACK_HOST_NAMES } from "./web-host-guard.js";
@@ -32,10 +33,7 @@ export { parseContextPercent, parseTokenContextRatio } from "./context-percent.j
 /** Longest one setMyCommands call may take. */
 const TELEGRAM_COMMANDS_TIMEOUT_MS = 10_000;
 /** Sanitize a directory name into a valid instance name. Keeps Unicode letters (incl. CJK). */
-export function sanitizeInstanceName(name) {
-    const sanitized = name.toLowerCase().replace(/[^\p{L}\d-]/gu, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-    return sanitized || "project";
-}
+export { sanitizeInstanceName };
 /** Digits of the topic id kept in a fresh instance-name suffix; lengthened on collision. */
 export const INSTANCE_NAME_SUFFIX_DIGITS = 6;
 /**
@@ -381,13 +379,25 @@ export function readStatuslineContextPct(dataDir, instanceName) {
     return measureSyncWork("topic.readStatuslineContextPct", () => readStatuslineContextPctSync(dataDir, instanceName));
 }
 function readStatuslineContextPctSync(dataDir, instanceName) {
+    return statuslineContextPct(readStatuslineJson(dataDir, instanceName));
+}
+/**
+ * #1956 step 3: an instance's statusline.json, parsed — undefined when there is none or it is not JSON. A caller that
+ * needs several of its fields reads it once (the fleet's status read it three times per instance per build).
+ */
+export function readStatuslineJson(dataDir, instanceName) {
+    // One call: a missing file is the read's ENOENT (no existsSync first).
     try {
-        const statusFile = join(dataDir, "instances", instanceName, "statusline.json");
-        if (!existsSync(statusFile))
-            return null;
-        const data = JSON.parse(readFileSync(statusFile, "utf-8"));
-        const pct = data.context_window?.used_percentage;
-        return clampContextPercent(pct);
+        return JSON.parse(readFileSync(join(dataDir, "instances", instanceName, "statusline.json"), "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The context percentage a parsed statusline reports (readStatuslineContextPct's rule). */
+export function statuslineContextPct(data) {
+    try {
+        return clampContextPercent(data?.context_window?.used_percentage);
     }
     catch {
         return null;
@@ -402,15 +412,14 @@ export function readStatuslineModel(dataDir, instanceName) {
     return measureSyncWork("topic.readStatuslineModel", () => readStatuslineModelSync(dataDir, instanceName));
 }
 function readStatuslineModelSync(dataDir, instanceName) {
+    return statuslineModel(readStatuslineJson(dataDir, instanceName));
+}
+/** The model a parsed statusline reports (readStatuslineModel's rule). */
+export function statuslineModel(data) {
     try {
-        const statusFile = join(dataDir, "instances", instanceName, "statusline.json");
-        if (!existsSync(statusFile))
-            return null;
-        const data = JSON.parse(readFileSync(statusFile, "utf-8"));
-        const id = typeof data.model?.id === "string" ? data.model.id.trim() : "";
-        const displayName = typeof data.model?.display_name === "string"
-            ? data.model.display_name.trim()
-            : "";
+        const model = data?.model;
+        const id = typeof model?.id === "string" ? model.id.trim() : "";
+        const displayName = typeof model?.display_name === "string" ? model.display_name.trim() : "";
         if (displayName && id && displayName !== id)
             return `${displayName} (${id})`;
         return id || displayName || null;
@@ -453,7 +462,8 @@ export function forgetInstanceContext(instanceName) {
  */
 export function resolveInstanceContext(dataDir, instanceName, backend, opts) {
     if (backend === "claude-code") {
-        const fromFile = readStatuslineContextPct(dataDir, instanceName);
+        // #1956: a caller that already read the statusline passes it (`statusline` present, even undefined: no file).
+        const fromFile = opts && "statusline" in opts ? statuslineContextPct(opts.statusline) : readStatuslineContextPct(dataDir, instanceName);
         if (fromFile != null)
             return { context: fromFile, tokenRatio: null };
     }
@@ -599,6 +609,8 @@ export class TopicCommands {
         if (!text)
             return false;
         const command = typedCommand(GENERAL_FORMS, text, msg.source);
+        if (command === "dashboard" && this.ctx.isGuestWebAsk?.(msg.adapterId, msg.userId))
+            return this.guestWeb(msg);
         const refusal = this.tableRefusal(msg, command, "general");
         if (refusal) {
             await this.sendRefusal(msg, refusal);
@@ -696,6 +708,18 @@ export class TopicCommands {
             ...(showRemoteHint && (LOOPBACK_HOST_NAMES.includes(host.toLowerCase()) || host === "::1") ? ["", t("dashboard.remote_hint", WEB_REMOTE_DOCS_URL)] : []),
         ].join("\n");
     }
+    /**
+     * #1920 step 4: a non-admin's typed `/web` while guest sign-in is on — in General or any topic of the fleet (the
+     * table keeps /web for fleet admins, so this runs before it). The code goes by DM; only a short line is posted here.
+     */
+    async guestWeb(msg) {
+        const adapter = this.getReplyAdapter(msg);
+        if (!adapter || !msg.adapterId || !this.ctx.guestWebCommand)
+            return false;
+        const arg = (msg.text ?? "").trim().replace(/^\/(?:dashboard|web)(?:@\S+)?/i, "").trim().toLowerCase();
+        return this.ctx.guestWebCommand({ adapterId: msg.adapterId, userId: msg.userId, username: msg.username, arg,
+            replyHere: text => adapter.sendText(msg.chatId, text, { threadId: msg.threadId }) });
+    }
     /**
      * /dashboard (TG): admin-only menu in General; codes are sent privately.
      * `/dashboard revoke` also closes the public link and signs browsers out.
@@ -741,6 +765,8 @@ export class TopicCommands {
         // to General (#1148) instead of handing it to the agent. No branch below runs it.
         const command = typedCommand(INSTANCE_FORMS, text, msg.source)
             ?? (inGeneral ? undefined : typedCommand(GENERAL_FORMS, text, msg.source));
+        if (command === "dashboard" && this.ctx.isGuestWebAsk?.(msg.adapterId, msg.userId))
+            return this.guestWeb(msg);
         const refusal = this.tableRefusal(msg, command, inGeneral ? "general" : "fleet");
         if (refusal) {
             await this.sendRefusal(msg, refusal);