@maudecode/talaria-web 1.17.2 → 1.18.0

package/dist/sessions/gateway-watcher.js

@@ -8,7 +8,7 @@
 import { createHash } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { cheapChangeFingerprint, readImportableAgentSessionRows } from './state-db.js';
+import { cheapChangeFingerprintAsync, readImportableAgentSessionRowsAsync } from './state-db.js';
 import { str } from '../util.js';
 export const GATEWAY_POLL_INTERVAL_S = 5;
 const PROJECTION_PARITY_INTERVAL_S = 300;
@@ -19,11 +19,11 @@ export function snapshotHash(sessions) {
     return createHash('md5').update(key).digest('hex');
 }
 /** Python `_get_agent_sessions_from_db`: the watcher's lightweight projection (null when the read failed). */
-export function agentSessionsFromDb(dbPath, onError) {
+export async function agentSessionsFromDb(dbPath, onError) {
     if (!existsSync(dbPath))
         return [];
     try {
-        return readImportableAgentSessionRows(dbPath, { limit: 200 }).map((row) => ({
+        return (await readImportableAgentSessionRowsAsync(dbPath, { limit: 200 })).map((row) => ({
             session_id: row.id, title: row.title || 'Agent Session', model: row.model || null,
             message_count: Number(row.message_count) || Number(row.actual_message_count) || 0,
             created_at: row.started_at, updated_at: row.last_activity ?? row.started_at, source: row.source || 'cli',
@@ -48,6 +48,7 @@ export class GatewayWatcher {
     lastCheapFp = '';
     lastFullProjectionAt = null;
     lastErrorLogAt = Number.NEGATIVE_INFINITY;
+    polling = null;
     constructor(profileName, hermesHome, opts) {
         this.profileName = profileName;
         this.hermesHome = hermesHome;
@@ -64,16 +65,13 @@ export class GatewayWatcher {
         const tick = () => {
             if (this.stopping)
                 return;
-            try {
-                this.pollOnce();
-            }
-            catch (error) {
-                this.warnFailure('poll loop raised', error);
-            }
-            if (this.stopping)
-                return;
-            this.timer = setTimeout(tick, this.opts.pollIntervalMs ?? GATEWAY_POLL_INTERVAL_S * 1000);
-            this.timer.unref();
+            // The next tick is armed only once this poll settles, so the timer never stacks polls.
+            void this.pollOnce().catch((error) => { this.warnFailure('poll loop raised', error); }).then(() => {
+                if (this.stopping || this.timer !== null)
+                    return;
+                this.timer = setTimeout(() => { this.timer = null; tick(); }, this.opts.pollIntervalMs ?? GATEWAY_POLL_INTERVAL_S * 1000);
+                this.timer.unref();
+            });
         };
         tick();
     }
@@ -88,14 +86,19 @@ export class GatewayWatcher {
             this.push(q, null);
     }
     subscribe() {
-        const q = { items: [], wake: null };
+        const q = { items: [], wake: null, ended: false };
         this.subscribers.add(q);
         // Stop-race safety: a subscriber attached after stop() still receives the sentinel so its SSE loop ends and reconnects.
         if (this.stopping)
             q.items.push(null);
         return {
             next: (signal) => new Promise((resolve) => {
-                const deliver = () => { resolve(q.items.shift() ?? null); };
+                const deliver = () => {
+                    const item = q.items.shift() ?? null;
+                    if (item === null)
+                        q.ended = true;
+                    resolve(item);
+                };
                 if (q.items.length) {
                     deliver();
                     return;
@@ -108,6 +111,7 @@ export class GatewayWatcher {
                 signal?.addEventListener('abort', onAbort, { once: true });
                 q.wake = () => { signal?.removeEventListener('abort', onAbort); deliver(); };
             }),
+            get ended() { return q.ended; },
             close: () => { this.subscribers.delete(q); },
         };
     }
@@ -136,18 +140,26 @@ export class GatewayWatcher {
             this.opts.log(`[webui] WARNING: Gateway watcher ${reason} for ${this.stateDbPath}; the session sidebar will not update until it recovers: ${error.message}`);
         }
     }
-    /** One change-detection pass; returns true when the projection ran. */
+    /** One change-detection pass; returns true when the projection ran. A call while a pass is in flight skips (false). */
     pollOnce(now = this.opts.now()) {
+        if (this.polling)
+            return Promise.resolve(false);
+        const pass = this.poll(now).finally(() => { this.polling = null; });
+        this.polling = pass;
+        return pass;
+    }
+    async poll(now) {
         const exists = existsSync(this.stateDbPath);
         // Never publish an empty first snapshot before the Agent has created state.db.
         if (!exists && this.lastFullProjectionAt === null && !this.lastHash)
             return false;
-        const cheapFp = exists ? cheapChangeFingerprint(this.stateDbPath, (reason, error) => { this.warnFailure(reason, error); }) : '';
+        const cheapFp = exists ? await cheapChangeFingerprintAsync(this.stateDbPath, (reason, error) => { this.warnFailure(reason, error); }) : '';
         const parityDue = this.lastFullProjectionAt === null || now - this.lastFullProjectionAt >= PROJECTION_PARITY_INTERVAL_S;
         if (cheapFp !== null && cheapFp === this.lastCheapFp && !parityDue)
             return false;
-        const sessions = agentSessionsFromDb(this.stateDbPath, (reason, error) => { this.warnFailure(reason, error); });
-        if (sessions === null)
+        const sessions = await agentSessionsFromDb(this.stateDbPath, (reason, error) => { this.warnFailure(reason, error); });
+        // A watcher stopped mid-pass has already sent its subscribers the end sentinel.
+        if (sessions === null || this.stopping)
             return false;
         const hash = snapshotHash(sessions);
         if (cheapFp !== null)

package/dist/sessions/gateway-watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-watcher.js","sourceRoot":"","sources":["../../src/sessions/gateway-watcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gateway-watcher.js","sourceRoot":"","sources":["../../src/sessions/gateway-watcher.ts"],"names":[],"mappings":"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"}

package/dist/sessions/handoff.d.ts

@@ -0,0 +1,32 @@
+type Message = Record<string, unknown>;
+/** The summary prompt the session's main model answers. */
+export declare const HANDOFF_SYSTEM_PROMPT: string;
+/** Python `_extract_handoff_text`: a content-part list joins its text parts. */
+export declare function handoffText(content: unknown): string;
+/** The transcript the model reads: each user/assistant message's text, capped at 1000 characters. */
+export declare function handoffTranscript(messages: Message[]): string;
+/** Python `_fallback_handoff_summary`: the last user and assistant point, in the conversation's language. */
+export declare function fallbackHandoffSummary(messages: Message[]): string;
+/** Python `_summary_output_incomplete`: empty, ellipsized, or a last line that stops mid-sentence. */
+export declare function summaryOutputIncomplete(raw: string): boolean;
+/** Python `_agent_summary_incomplete`: the provider stopped on its token limit, or the text looks cut off. */
+export declare function completionIncomplete(result: {
+    text: string;
+    finish_reason?: string | null;
+}): boolean;
+interface HandoffPayload {
+    session_id: string;
+    summary: string;
+    channel: unknown;
+    rounds: unknown;
+    fallback: boolean;
+}
+/** Python `_build_handoff_summary_tool_message`: an empty `tool_call_id` keeps the marker out of the model's history. */
+export declare function handoffMarker(sid: string, summary: string, channel: string | null, rounds: number, fallback: boolean, now: number): Message;
+/** A marker's card payload (Python `_extract_handoff_summary_payload` / `_is_matching_handoff_summary_content`). */
+export declare function handoffPayload(content: unknown): HandoffPayload | null;
+/** The tail dedupe: the same card regardless of when it was generated. */
+export declare function sameHandoff(a: HandoffPayload | null, b: HandoffPayload | null): boolean;
+/** A WebUI transcript row's card payload: only a `handoff_summary` tool row carries one. */
+export declare function messageHandoffPayload(m: unknown): HandoffPayload | null;
+export {};

package/dist/sessions/handoff.js

@@ -0,0 +1,114 @@
+/**
+ * TAL-258: the handoff dock's summary (Python `_handle_handoff_summary` and its persistence helpers). The prompt, the
+ * deterministic English/Chinese fallback, the truncation guard, and the display-only `handoff_summary` tool marker.
+ */
+import { str } from '../util.js';
+import { isDict } from './merge.js';
+/** The summary prompt the session's main model answers. */
+export const HANDOFF_SYSTEM_PROMPT = [
+    'You are summarizing an external-channel conversation so a Web UI reader can quickly catch up after switching contexts.',
+    '',
+    'Only use the latest messages, and never copy raw transcript lines.',
+    'Do not output role labels (no “你:” / “assistant:” / “user:” / “assistant”).',
+    'Use direct 2–5 bullet points in the conversation language.',
+    'English: speak using “you”.',
+    '中文: 使用“你”。',
+    '',
+    'Focus on:',
+    '- Unfinished tasks or action items',
+    '- Pending questions that need replies',
+    '- Key decisions made',
+    '- Open disagreements or TBD items',
+    '',
+    'If the conversation is purely casual with no actionable items, say so in one sentence.',
+].join('\n');
+/** Python `_extract_handoff_text`: a content-part list joins its text parts. */
+export function handoffText(content) {
+    if (Array.isArray(content))
+        return content.filter(isDict).map((part) => str(part.text || part.content || '')).join(' ').trim();
+    return str(content ?? '').trim();
+}
+// Code points, as Python counts and slices them.
+const chars = (text) => Array.from(text);
+const isConversation = (m) => m.role === 'user' || m.role === 'assistant';
+const isChinese = (messages) => messages.some((m) => /[一-鿿]/.test(handoffText(m.content)));
+/** The transcript the model reads: each user/assistant message's text, capped at 1000 characters. */
+export function handoffTranscript(messages) {
+    return messages.flatMap((m) => {
+        const text = chars(handoffText(m.content)).slice(0, 1000).join('').trim();
+        return isConversation(m) && text ? [text] : [];
+    }).join('\n');
+}
+function snippet(raw, max = 82) {
+    const text = raw.split(/\s+/).filter(Boolean).join(' ');
+    const cps = chars(text);
+    return cps.length <= max ? text : `${cps.slice(0, max - 1).join('').trimEnd()}…`;
+}
+/** Python `_fallback_handoff_summary`: the last user and assistant point, in the conversation's language. */
+export function fallbackHandoffSummary(messages) {
+    const chinese = isChinese(messages);
+    const user = [];
+    const assistant = [];
+    for (const m of messages) {
+        const text = snippet(handoffText(m.content));
+        if (!isConversation(m) || !text)
+            continue;
+        (m.role === 'user' ? user : assistant).push(text);
+    }
+    if (!user.length && !assistant.length) {
+        return chinese ? '近期可读文本不足，无法生成更完整的交接摘要，请补充一条消息后重试。' : 'Not enough readable text to create a useful handoff summary; please send one more message and retry.';
+    }
+    const enough = user.length + assistant.length >= 2;
+    const bullets = chinese
+        ? [...(user.length ? [`- 你刚讨论了：${user.at(-1)}。`] : []), ...(assistant.length ? [`- 助手已回复：${assistant.at(-1)}。`] : []), enough ? '- 当前对话存在尚未确认的后续动作。' : '- 当前信息偏少，建议补充关键点后再切换。']
+        : [...(user.length ? [`- You asked: ${user.at(-1)}.`] : []), ...(assistant.length ? [`- The assistant responded: ${assistant.at(-1)}.`] : []), enough ? '- There is pending context to continue next.' : '- The conversation is still short; add one more turn before summarizing.'];
+    return bullets.join('\n');
+}
+/** Python `_summary_output_incomplete`: empty, ellipsized, or a last line that stops mid-sentence. */
+export function summaryOutputIncomplete(raw) {
+    const text = raw.trim();
+    if (!text || text.endsWith('...') || text.endsWith('…'))
+        return true;
+    const last = text.split('\n').map((line) => line.trim()).filter(Boolean).at(-1);
+    if (!last)
+        return true;
+    if (/[。！？；!?.；]$/.test(last))
+        return false;
+    if (chars(last).length >= 56 && !/\b(and|or|so|then|because|if|when|but|as)\b$/i.test(last))
+        return true;
+    return /\b(and|or|but|so|because|if|when)$/i.test(last);
+}
+/** Python `_agent_summary_incomplete`: the provider stopped on its token limit, or the text looks cut off. */
+export function completionIncomplete(result) {
+    const reason = str(result.finish_reason).trim().toLowerCase();
+    return reason === 'length' || reason === 'max_tokens' || summaryOutputIncomplete(result.text);
+}
+/** Python `_build_handoff_summary_tool_message`: an empty `tool_call_id` keeps the marker out of the model's history. */
+export function handoffMarker(sid, summary, channel, rounds, fallback, now) {
+    const content = JSON.stringify({ _handoff_summary_card: true, session_id: sid, summary: summary.trim(), channel: channel?.trim() || null, rounds, fallback, generated_at: now });
+    return { role: 'tool', tool_call_id: '', name: 'handoff_summary', timestamp: now, _ts: now, content };
+}
+/** A marker's card payload (Python `_extract_handoff_summary_payload` / `_is_matching_handoff_summary_content`). */
+export function handoffPayload(content) {
+    let payload = content;
+    if (typeof content === 'string') {
+        try {
+            payload = JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!isDict(payload) || payload._handoff_summary_card !== true || payload.session_id === null || payload.session_id === undefined)
+        return null;
+    return { session_id: str(payload.session_id), summary: str(payload.summary ?? ''), channel: payload.channel ?? null, rounds: payload.rounds ?? null, fallback: Boolean(payload.fallback) };
+}
+/** The tail dedupe: the same card regardless of when it was generated. */
+export function sameHandoff(a, b) {
+    return a !== null && b !== null && a.session_id === b.session_id && a.summary === b.summary && a.channel === b.channel && a.rounds === b.rounds && a.fallback === b.fallback;
+}
+/** A WebUI transcript row's card payload: only a `handoff_summary` tool row carries one. */
+export function messageHandoffPayload(m) {
+    return isDict(m) && m.role === 'tool' && m.name === 'handoff_summary' ? handoffPayload(m.content) : null;
+}
+//# sourceMappingURL=handoff.js.map

package/dist/sessions/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/sessions/handoff.ts"],"names":[],"mappings":"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"}

package/dist/sessions/list.d.ts

@@ -49,6 +49,10 @@ export interface ListParams {
     stateDbSources?: (ids: string[]) => Map<string, string> | null;
     /** TAL-482: background kinds whose state.db rows stopped at the per-kind cap, so more exist than `cliRows` holds. */
     truncatedSources?: ReadonlySet<string>;
+    /** TAL-590: removes the sidebar rows' orphaned imports (Python #3238) and answers their ids, which the list drops. */
+    pruneOrphanedImports?: (rows: Row[]) => Set<string>;
+    /** The sidebar's `allSessions` rows when the caller already read them for its state.db lookups (TAL-920). */
+    webuiRows?: Row[];
 }
 export interface GatewayIdentity {
     session_key: string;
@@ -72,6 +76,8 @@ export declare function isClaimableCliSource(meta: Row, stateDbSource: string):
  * unreadable state.db (null) locks every candidate, since an unknown owner is not a released one.
  */
 export declare function withOwnerLocks(rows: Row[], stateDbSources: (ids: string[]) => Map<string, string> | null): Row[];
+/** The ids `withOwnerLocks` asks `stateDbSources` about: rows not already read-only and not WebUI- or fork-born. */
+export declare function ownerLockCandidates(rows: Row[]): string[];
 /** Python `_session_is_subagent_view_only` on a row: a delegated child by any source marker. */
 export declare function isSubagentRow(row: Row): boolean;
 /**
@@ -125,7 +131,7 @@ export interface ListPayload {
     other_profile_count: number;
     settings: Record<string, boolean>;
 }
-/** Python `_build_session_list_cache_payload`; the orphaned-sidecar prune (#3238/#4985) is not applied. */
+/** Python `_build_session_list_cache_payload`; of its orphaned-sidecar prunes only the imported one (#3238) applies. */
 export declare function buildSessionListPayload(store: SessionStore, params: ListParams): ListPayload;
 export interface RuntimeOverlay {
     activeStreamIds: Set<string>;

package/dist/sessions/list.js

@@ -527,8 +527,7 @@ export function isClaimableCliSource(meta, stateDbSource) {
  * unreadable state.db (null) locks every candidate, since an unknown owner is not a released one.
  */
 export function withOwnerLocks(rows, stateDbSources) {
-    const webuiOwned = (r) => ['source_tag', 'raw_source', 'session_source'].some((k) => ['webui', 'fork'].includes(str(r[k]).trim().toLowerCase()));
-    const candidates = rows.filter((r) => !r.read_only && !webuiOwned(r)).map((r) => str(r.session_id));
+    const candidates = ownerLockCandidates(rows);
     if (!candidates.length)
         return rows;
     const owners = stateDbSources(candidates);
@@ -540,6 +539,11 @@ export function withOwnerLocks(rows, stateDbSources) {
     }));
     return locked.size ? rows.map((r) => (locked.has(str(r.session_id)) ? { ...r, read_only: true } : r)) : rows;
 }
+/** The ids `withOwnerLocks` asks `stateDbSources` about: rows not already read-only and not WebUI- or fork-born. */
+export function ownerLockCandidates(rows) {
+    const webuiOwned = (r) => ['source_tag', 'raw_source', 'session_source'].some((k) => ['webui', 'fork'].includes(str(r[k]).trim().toLowerCase()));
+    return rows.filter((r) => !r.read_only && !webuiOwned(r)).map((r) => str(r.session_id));
+}
 /** Python `_session_is_subagent_view_only` on a row: a delegated child by any source marker. */
 export function isSubagentRow(row) {
     return str(row.source_tag || row.raw_source || row.session_source || row.source).trim().toLowerCase() === 'subagent';
@@ -711,7 +715,8 @@ export function capRecentCliSessions(rows, cap = CLI_VISIBLE_SESSION_CAP) {
         return true; seen += 1; return seen <= cap; });
 }
 function sessionHasServerVisibleMessages(row) {
-    if (sidebarMessageCount(row) > 0)
+    // A worktree chat owns a directory on disk from creation; its row is where the user removes it (TAL-605).
+    if (sidebarMessageCount(row) > 0 || row.worktree_path)
         return true;
     const attention = row.attention;
     if (attention && typeof attention === 'object' && attention.kind && num(attention.count) > 0)
@@ -744,9 +749,12 @@ function hiddenArchivedReferences(visible, archived) {
     }
     return references;
 }
-/** Python `_build_session_list_cache_payload`; the orphaned-sidecar prune (#3238/#4985) is not applied. */
+/** Python `_build_session_list_cache_payload`; of its orphaned-sidecar prunes only the imported one (#3238) applies. */
 export function buildSessionListPayload(store, params) {
-    let webuiSessions = allSessions(store, { sidebarMetadataOnly: true }).map((r) => ({ ...r, is_cli_session: isCliSessionRow(r) }));
+    let webuiSessions = (params.webuiRows ?? allSessions(store, { sidebarMetadataOnly: true })).map((r) => ({ ...r, is_cli_session: isCliSessionRow(r) }));
+    const orphans = params.pruneOrphanedImports?.(webuiSessions);
+    if (orphans?.size)
+        webuiSessions = webuiSessions.filter((r) => !orphans.has(str(r.session_id)));
     // Before the state.db overlay below replaces the sidecar's own source fields, which the WebUI-born exception reads.
     if (params.stateDbSources)
         webuiSessions = withOwnerLocks(webuiSessions, params.stateDbSources);