@songsid/agend 2.2.0-beta.7 → 2.2.0-beta.9

package/dist/fleet-manager.d.ts

@@ -53,6 +53,7 @@ export declare function applyTaskListCap<T extends {
     hint: string;
 } | 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 { SeenUsers, type MentionNames, type MentionQuery } from "./web-mentions.js";
 import { WebPrefsStore } from "./web-prefs.js";
@@ -814,6 +815,18 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     getActiveBackendIds(): ReadonlySet<string>;
     isClassicInstance(name: string): boolean;
     /** #1523 N2: a ClassicBot room's own summary for its Details page (classicBot.yaml), or null. */
+    /** #1218: the Log tab's on-demand service — made on first use; with `web.log_tab` off it answers off and does nothing. */
+    private logService;
+    private get log();
+    /** #1218: GET /ui/steps — an instance's steps, read on demand (null: no such instance). */
+    logSteps(name: string, q: LogQuery): Promise<LogAnswer | null>;
+    /**
+     * #1218: where an instance's steps are read from, resolved only when its Log asks: the transcript its daemon follows
+     * now; for claude-code, also the path its statusline last named (so a stopped instance's Log still shows its last
+     * work). kiro: fleet events with the reason its history is not read (kiro-log-gate.ts); other backends have no
+     * transcript AgEnD can read.
+     */
+    private logSource;
     classicRoomFor(name: string): {
         name: string;
         channel_id: string;

package/dist/fleet-manager.js

@@ -39,6 +39,7 @@ import { readFleetMemory } from "./process-memory.js";
 import { MemoryPressure } from "./memory-pressure.js";
 import { replyDedupText, ReplyDeduper } from "./reply-dedup.js";
 import { isMap, isScalar, parseDocument } from "yaml";
+import { kiroLogGate } from "./kiro-log-gate.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /** Fallback access policy for a channel with no `access:` block — open (no gate). */
@@ -132,6 +133,7 @@ export function applyTaskListCap(tasks, filterAssignee, filterStatus) {
     return tasks;
 }
 import { handleWebRequest, broadcastSseEvent, SSE_HEARTBEAT_MS } from "./web-api.js";
+import { LogService } from "./log-service.js";
 import { WebChatHistory, WEB_CHAT_TEXT_MAX, isWebMessageId, newWebMessageId } from "./web-chat-history.js";
 import { WebChatDiskStore } from "./web-chat-store.js";
 import { SeenUsers, resolveMentions } from "./web-mentions.js";
@@ -2695,6 +2697,55 @@ export class FleetManager {
         return this.classicChannels?.getAll().some(channel => channel.instanceName === name) ?? false;
     }
     /** #1523 N2: a ClassicBot room's own summary for its Details page (classicBot.yaml), or null. */
+    /** #1218: the Log tab's on-demand service — made on first use; with `web.log_tab` off it answers off and does nothing. */
+    logService = null;
+    get log() {
+        return this.logService ??= new LogService({
+            enabled: () => this.fleetConfig?.web?.log_tab === true,
+            known: (name) => Object.prototype.hasOwnProperty.call(this.fleetConfig?.instances ?? {}, name) || this.classicRoomFor(name) !== null,
+            source: (name) => this.logSource(name),
+            events: (name, limit) => (this.eventLog?.query({ instance: name, limit }) ?? []),
+            emit: (event, data) => this.emitSseEvent(event, data),
+        });
+    }
+    /** #1218: GET /ui/steps — an instance's steps, read on demand (null: no such instance). */
+    logSteps(name, q) { return this.log.steps(name, q); }
+    /**
+     * #1218: where an instance's steps are read from, resolved only when its Log asks: the transcript its daemon follows
+     * now; for claude-code, also the path its statusline last named (so a stopped instance's Log still shows its last
+     * work). kiro: fleet events with the reason its history is not read (kiro-log-gate.ts); other backends have no
+     * transcript AgEnD can read.
+     */
+    logSource(name) {
+        const instances = this.fleetConfig?.instances ?? {};
+        const config = Object.prototype.hasOwnProperty.call(instances, name) ? instances[name] : undefined;
+        const backend = config?.backend ?? (config ? null : this.classicRoomFor(name)?.backend) ?? this.fleetConfig?.defaults?.backend ?? "claude-code";
+        const live = this.lifecycle.daemons.get(name)?.logTranscriptPath() ?? null;
+        if (backend === "claude-code") {
+            let path = live;
+            if (!path) {
+                try {
+                    path = JSON.parse(readFileSync(join(this.getInstanceDir(name), "statusline.json"), "utf-8")).transcript_path ?? null;
+                }
+                catch {
+                    path = null;
+                }
+                if (typeof path !== "string" || !path)
+                    path = null;
+            }
+            return { backend, path, format: "claude", ...(path ? {} : { reason: "no_transcript" }) };
+        }
+        if (backend === "codex")
+            return { backend, path: live, format: "codex", ...(live ? {} : { reason: "not_running" }) };
+        if (backend === "kiro-cli") {
+            // #1218 PR4: events only until the launch's root and the current conversation are both proven (kiro-log-gate.ts);
+            // the reason names which proof is missing. With today's proofs the gate never opens, and nothing is read for kiro:
+            // the reader is bound to an admitted launch when the proofs arrive (#849 root, #1789 current conversation).
+            const gate = kiroLogGate(this.lifecycle.daemons.get(name)?.logLaunch() ?? null);
+            return { backend, path: null, format: null, reason: gate.open ? "kiro_session_unobservable" : gate.reason };
+        }
+        return { backend, path: null, format: null, reason: "unsupported" };
+    }
     classicRoomFor(name) {
         const ch = this.classicChannels?.getAll().find(channel => channel.instanceName === name);
         if (!ch)
@@ -16659,6 +16710,7 @@ Plus the operational skills (fleet-health, instance-lifecycle, scheduling, sessi
             clearInterval(this.eventLogPruneTimer);
             this.eventLogPruneTimer = null;
         }
+        this.logService?.unwatchAll(); // #1218: a Log's watch timers end with the fleet
         if (this.outboxPruneTimer) {
             clearInterval(this.outboxPruneTimer);
             this.outboxPruneTimer = null;