@maudecode/talaria-web 1.17.2 → 1.19.0

package/dist/sessions/wakeup-pause.d.ts

@@ -0,0 +1,54 @@
+import type { DocumentBackend } from './storage/backend.js';
+import type { Session } from './session.js';
+/**
+ * Python `process_wakeup_credential_state_fingerprint`: auth.json by content shape, the authoritative config file
+ * (`AgentConfig.path`, which honours `HERMES_CONFIG_PATH`) and `.env` by stat. Throws when any of them cannot be read:
+ * unknown credential state is never a change.
+ */
+export declare function credentialStateFingerprint(profileHome: string, configPath?: string): string;
+/**
+ * `provider` is the session's own (a switch lifts the pause); `pool_provider` is whose pool ran dry: the provider the
+ * Agent resolved for the turn, which a session on the config's implicit provider does not name. Unreadable credential
+ * state records no fingerprint, so the first readable one lifts the pause.
+ */
+export declare function recordWakeupPause(s: Session, profileHome: string, now: number, runtimeProvider: string, configPath?: string): void;
+/** The pool's state for a paused session: `true` once an entry is usable, else the earliest retry deadline (epoch s), else null. */
+export declare function poolRecovery(entries: readonly {
+    status: string;
+    retry_after: string | null;
+}[], now: number): true | number | null;
+/**
+ * A wakeup held while its session is paused. `process_id` is its delivery identity: the process for a completion or an
+ * async delegation, and a per-event key for a watch event (TAL-724), so every reader, an older one too, keeps both a
+ * watch match and the exit of one process.
+ */
+export interface HeldWakeup {
+    process_id: string;
+    wakeup_prompt: string;
+    event?: Record<string, unknown>;
+}
+/** A completion (an event with no type is one) or an async delegation is delivered once per process; each watch event is its own (TAL-724). */
+export declare const deliveredPerProcess: (evt: Record<string, unknown> | undefined) => boolean;
+/** A watch event held before TAL-724 carries its bare process id; its prompt keys it, so the exit held after it is kept. */
+export declare const heldKey: (e: HeldWakeup) => string;
+/** Adds entries not held yet, so held and in-memory copies of one wakeup merge into one. */
+export declare function mergeWakeups(into: HeldWakeup[], entries: readonly HeldWakeup[]): HeldWakeup[];
+/**
+ * Held wakeups by session in one atomically written file: holding one is a single durable write, it leaves only once a
+ * turn admits it, and a restarted server finds every one.
+ */
+export declare class HeldWakeups {
+    private readonly documents;
+    constructor(documents: DocumentBackend);
+    private validate;
+    private read;
+    sessions(): Promise<string[]>;
+    get(sid: string): Promise<HeldWakeup[]>;
+    hold(sid: string, entries: readonly HeldWakeup[]): Promise<void>;
+    release(sid: string, entries?: readonly HeldWakeup[]): Promise<void>;
+}
+/**
+ * Whether the session's wakeups stay paused; a pause whose provider or credential state changed is cleared (the caller
+ * saves). Credential state that cannot be read keeps the pause.
+ */
+export declare function wakeupPaused(s: Session, profileHome: string, configPath?: string): boolean;

package/dist/sessions/wakeup-pause.js

@@ -0,0 +1,163 @@
+/**
+ * TAL-576 (Python `process_wakeup_pause`): a wakeup turn that fails with `credential_pool_empty` pauses automatic
+ * wakeups for its session until the profile's credential state or the session's provider changes, or a turn succeeds.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { updateDocument } from './storage/document.js';
+import { isDict } from './merge.js';
+import { str } from '../util.js';
+/** Fields the Agent rewrites on token refresh or per-request telemetry; they never mean a credential was added. */
+const ROTATION_KEYS = new Set(['expires_at', 'expires_at_ms', 'expires_in', 'last_status', 'last_status_at', 'last_error_code', 'last_error_reason', 'last_error_message', 'last_error_reset_at', 'request_count', 'updated_at']);
+/** Secrets enter the fingerprint only as presence, so a rotated token is no change and no secret is hashed. */
+const SECRET_KEYS = new Set(['access_token', 'refresh_token', 'id_token', 'api_key', 'secret', 'client_secret', 'runtime_api_key', 'token']);
+function authShape(value) {
+    if (Array.isArray(value))
+        return value.map(authShape);
+    if (!isDict(value))
+        return value;
+    const out = {};
+    for (const key of Object.keys(value).sort()) {
+        const norm = key.trim().toLowerCase();
+        if (ROTATION_KEYS.has(norm))
+            continue;
+        out[key] = SECRET_KEYS.has(norm) ? Boolean(str(value[key]).trim()) : authShape(value[key]);
+    }
+    return out;
+}
+const missing = (error) => ['ENOENT', 'ENOTDIR'].includes(str(error.code));
+/**
+ * Python `process_wakeup_credential_state_fingerprint`: auth.json by content shape, the authoritative config file
+ * (`AgentConfig.path`, which honours `HERMES_CONFIG_PATH`) and `.env` by stat. Throws when any of them cannot be read:
+ * unknown credential state is never a change.
+ */
+export function credentialStateFingerprint(profileHome, configPath = join(profileHome, 'config.yaml')) {
+    const stamp = (path) => { try {
+        const st = statSync(path, { bigint: true });
+        return `${String(st.mtimeNs)}:${String(st.size)}`;
+    }
+    catch (error) {
+        if (missing(error))
+            return 'missing';
+        throw error;
+    } };
+    let text = null;
+    try {
+        text = readFileSync(join(profileHome, 'auth.json'), 'utf8');
+    }
+    catch (error) {
+        if (!missing(error))
+            throw error;
+    }
+    const auth = text === null ? 'missing' : JSON.stringify(authShape(JSON.parse(text)));
+    return createHash('sha256').update(JSON.stringify([auth, stamp(configPath), stamp(join(profileHome, '.env'))])).digest('hex');
+}
+/**
+ * `provider` is the session's own (a switch lifts the pause); `pool_provider` is whose pool ran dry: the provider the
+ * Agent resolved for the turn, which a session on the config's implicit provider does not name. Unreadable credential
+ * state records no fingerprint, so the first readable one lifts the pause.
+ */
+export function recordWakeupPause(s, profileHome, now, runtimeProvider, configPath) {
+    const provider = s.model_provider ?? '';
+    let fingerprint = '';
+    try {
+        fingerprint = credentialStateFingerprint(profileHome, configPath);
+    }
+    catch { /* recorded as unknown */ }
+    s.process_wakeup_pause = { paused: true, source: 'process_wakeup', classification: 'credential_pool_empty', provider, pool_provider: runtimeProvider.trim() || provider, paused_at: now, credential_state_fingerprint: fingerprint };
+}
+/** The pool's state for a paused session: `true` once an entry is usable, else the earliest retry deadline (epoch s), else null. */
+export function poolRecovery(entries, now) {
+    let earliest = null;
+    for (const entry of entries) {
+        if (entry.status === 'available')
+            return true;
+        const at = entry.retry_after ? Date.parse(entry.retry_after) / 1000 : NaN;
+        if (Number.isFinite(at))
+            earliest = Math.min(earliest ?? at, at);
+    }
+    return earliest !== null && earliest <= now ? true : earliest;
+}
+/** A completion (an event with no type is one) or an async delegation is delivered once per process; each watch event is its own (TAL-724). */
+export const deliveredPerProcess = (evt) => ['completion', 'async_delegation'].includes(str(evt?.type ?? 'completion'));
+/** A watch event held before TAL-724 carries its bare process id; its prompt keys it, so the exit held after it is kept. */
+export const heldKey = (e) => (deliveredPerProcess(e.event) || e.process_id !== str(e.event?.process_id) ? e.process_id : '') || e.wakeup_prompt;
+const isHeld = (e) => isDict(e) && typeof e.wakeup_prompt === 'string' && typeof e.process_id === 'string';
+/** Adds entries not held yet, so held and in-memory copies of one wakeup merge into one. */
+export function mergeWakeups(into, entries) {
+    const keys = new Set(into.map(heldKey));
+    for (const entry of entries)
+        if (!keys.has(heldKey(entry))) {
+            keys.add(heldKey(entry));
+            into.push(entry);
+        }
+    return into;
+}
+/**
+ * Held wakeups by session in one atomically written file: holding one is a single durable write, it leaves only once a
+ * turn admits it, and a restarted server finds every one.
+ */
+export class HeldWakeups {
+    documents;
+    constructor(documents) {
+        this.documents = documents;
+    }
+    validate(raw) {
+        if (raw === undefined)
+            return {};
+        if (!isDict(raw))
+            throw new Error('Stored held wakeups are not a map');
+        for (const [sid, entries] of Object.entries(raw)) {
+            if (!Array.isArray(entries) || !entries.every(isHeld))
+                throw new Error(`Malformed held wakeup for session ${sid}`);
+        }
+        return raw;
+    }
+    async read() { return this.validate((await this.documents.get('held-wakeups', 'held'))?.value); }
+    async sessions() { return Object.keys(await this.read()); }
+    async get(sid) { return (await this.read())[sid] ?? []; }
+    async hold(sid, entries) {
+        await updateDocument(this.documents, 'held-wakeups', 'held', (raw) => {
+            const all = this.validate(raw);
+            const before = all[sid]?.length ?? 0;
+            all[sid] = mergeWakeups(all[sid] ?? [], entries);
+            return { value: all, result: undefined, skip: all[sid].length === before };
+        });
+    }
+    async release(sid, entries) {
+        await updateDocument(this.documents, 'held-wakeups', 'held', (raw) => {
+            const all = this.validate(raw);
+            const held = all[sid] ?? [];
+            const done = new Set((entries ?? held).map(heldKey));
+            all[sid] = held.filter((entry) => !done.has(heldKey(entry)));
+            for (const key of Object.keys(all))
+                if (!all[key].length)
+                    Reflect.deleteProperty(all, key);
+            return { value: all, result: undefined, skip: (all[sid]?.length ?? 0) === held.length };
+        });
+    }
+}
+/**
+ * Whether the session's wakeups stay paused; a pause whose provider or credential state changed is cleared (the caller
+ * saves). Credential state that cannot be read keeps the pause.
+ */
+export function wakeupPaused(s, profileHome, configPath) {
+    const pause = s.process_wakeup_pause;
+    if (!isDict(pause) || pause.paused !== true)
+        return false;
+    let changed = str(pause.provider) !== (s.model_provider ?? '');
+    if (!changed) {
+        try {
+            changed = str(pause.credential_state_fingerprint) !== credentialStateFingerprint(profileHome, configPath);
+        }
+        catch {
+            return true;
+        }
+    }
+    if (!changed)
+        return true;
+    s.process_wakeup_pause = null;
+    return false;
+}
+//# sourceMappingURL=wakeup-pause.js.map

package/dist/sessions/wakeup-pause.js.map

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

package/dist/sessions/window.js

@@ -14,7 +14,8 @@ export function parseMsgLimit(raw) {
 export function messageCountsAsRenderable(message) {
     if (!isDict(message))
         return false;
-    if (isEmptyPartialActivityMessage(message))
+    // A row classified hidden (the Agent's hidden and scaffold rows, TAL-815) takes no visible slot.
+    if (isEmptyPartialActivityMessage(message) || message.display_kind === 'hidden' || message._background_silent === true)
         return false;
     const role = str(message.role).trim().toLowerCase();
     return Boolean(role) && role !== 'tool';
@@ -54,13 +55,13 @@ function toolResultMatchesCallIds(message, callIds) {
 /** Visible-row-bounded window and its full-transcript offset. */
 export function messageWindowForDisplay(messages, msgLimit, msgBefore) {
     const beforeIdx = msgBefore === null ? messages.length : Math.max(0, Math.min(msgBefore, messages.length));
-    const source = messages.slice(0, beforeIdx);
-    if (!source.length)
+    const source = messages;
+    if (!beforeIdx)
         return [[], 0];
     if (!msgLimit)
-        return [source, 0];
+        return [source.slice(0, beforeIdx), 0];
     const limit = Math.max(1, msgLimit);
-    let endIdx = source.length;
+    let endIdx = beforeIdx;
     let lastRenderable = null;
     for (let idx = endIdx - 1; idx >= 0; idx -= 1) {
         if (messageCountsAsRenderable(source[idx])) {
@@ -73,13 +74,6 @@ export function messageWindowForDisplay(messages, msgLimit, msgBefore) {
         return [source.slice(start, endIdx), start];
     }
     endIdx = lastRenderable + 1;
-    const windowIds = toolCallIdsInMessages(source.slice(0, lastRenderable + 1));
-    while (endIdx < source.length && !messageCountsAsRenderable(source[endIdx])) {
-        if (toolResultMatchesCallIds(source[endIdx], windowIds))
-            endIdx += 1;
-        else
-            break;
-    }
     let startIdx = 0;
     let renderable = 0;
     for (let idx = lastRenderable; idx >= 0; idx -= 1) {
@@ -91,6 +85,13 @@ export function messageWindowForDisplay(messages, msgLimit, msgBefore) {
             break;
         }
     }
+    const windowIds = toolCallIdsInMessages(source.slice(startIdx, lastRenderable + 1));
+    while (endIdx < beforeIdx && !messageCountsAsRenderable(source[endIdx])) {
+        if (toolResultMatchesCallIds(source[endIdx], windowIds))
+            endIdx += 1;
+        else
+            break;
+    }
     return [source.slice(startIdx, endIdx), startIdx];
 }
 /** Rebase session-level tool calls into a window. */

package/dist/sessions/window.js.map

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

package/dist/settings.d.ts

@@ -1,3 +1,13 @@
+/**
+ * `settings.json` store: defaults, legacy-key migrations, allowlist and range
+ * validation on save, and the atomic writer (Python `api/config.py`
+ * `_SETTINGS_*`, `load_settings`, `save_settings`).
+ *
+ * `default_model` / `default_model_provider` come from the Agent config.yaml
+ * and are supplied by hooks the config domain wires in; the store itself never
+ * reads config.yaml.
+ */
+import { type DocumentBackend } from './sessions/storage/backend.js';
 import { type Env } from './config.js';
 export type Settings = Record<string, unknown>;
 export declare const SETTINGS_SPEECH_KEYS: Set<string>;
@@ -34,7 +44,7 @@ export interface SettingsHooks {
     defaultModelProvider?: () => string | undefined;
 }
 export interface SettingsStoreOptions {
-    file: string;
+    documents: DocumentBackend;
     env: Env;
     stateDir: string;
     defaultWorkspace: string;
@@ -43,7 +53,7 @@ export interface SettingsStoreOptions {
     log?: (line: string) => void;
 }
 export declare class SettingsStore {
-    readonly file: string;
+    private readonly documents;
     hooks: SettingsHooks;
     /** Incremented on every successful save so callers can detect changes cheaply. */
     writeVersion: number;
@@ -55,12 +65,14 @@ export declare class SettingsStore {
     constructor(opts: SettingsStoreOptions);
     defaults(): Settings;
     /** The profile's quota thresholds, defaults filled in. */
-    quotaThresholds(profile: string): QuotaThresholds;
-    /** Read settings.json; `strict` callers distinguish absence from an unreadable file. */
+    quotaThresholds(profile: string): Promise<QuotaThresholds>;
+    /** Sync policies use the last loaded server snapshot; request handlers and writes refresh through the async port. */
+    peek(): Settings;
     readRaw(opts?: {
         strict?: boolean;
-    }): Settings;
-    load(): Settings;
+    }): Promise<Settings>;
+    load(): Promise<Settings>;
+    private fromRaw;
     private persistedSpeechKeys;
     private payloadForWrite;
     private writeSettings;
@@ -73,5 +85,5 @@ export declare class SettingsStore {
      * `default_workspace` wins over discovery unless the env override is set, and
      * a stale stored value is rewritten once.
      */
-    applyStartupWorkspace(): void;
+    applyStartupWorkspace(): Promise<void>;
 }