@maudecode/talaria-web 0.0.0

package/dist/sessions/pending.js

@@ -0,0 +1,271 @@
+/**
+ * Pending approval and clarify prompts per session (Python
+ * `api/route_approvals.py`, `api/clarify.py`). The sidecar owns the parked
+ * Agent thread; these queues are what `/api/approval/pending`,
+ * `/api/clarify/pending`, and their SSE streams read.
+ */
+import { randomUUID } from 'node:crypto';
+import { str } from '../util.js';
+export const CLARIFY_DEFAULT_TIMEOUT_SECONDS = 3600;
+export const CLARIFY_MAX_QUESTIONS = 5;
+export const CLARIFY_MAX_CHOICES = 4;
+function choiceText(choice) {
+    if (typeof choice === 'string')
+        return choice.trim();
+    if (choice && typeof choice === 'object' && !Array.isArray(choice)) {
+        for (const key of ['label', 'description', 'text', 'title']) {
+            const value = choice[key];
+            if (typeof value === 'string' && value.trim())
+                return value.trim();
+        }
+        return '';
+    }
+    return str(choice).trim();
+}
+function normalizedChoices(raw) {
+    if (!Array.isArray(raw))
+        return null;
+    const choices = raw.map(choiceText).filter(Boolean).slice(0, CLARIFY_MAX_CHOICES);
+    return choices.length ? choices : null;
+}
+/** Python `clarify.normalize_questions`. */
+export function normalizeQuestions(questions) {
+    if (!Array.isArray(questions) || !questions.length || questions.length > CLARIFY_MAX_QUESTIONS)
+        return null;
+    return questions.map((raw, index) => {
+        let item;
+        if (typeof raw === 'string')
+            item = { question: raw };
+        else if (raw && typeof raw === 'object' && !Array.isArray(raw))
+            item = raw;
+        else
+            item = { question: JSON.stringify(raw) };
+        let text = str(item.question).trim();
+        if (!text)
+            text = JSON.stringify(item);
+        const offered = normalizedChoices(item.choices_offered);
+        const choices = normalizedChoices(item.choices) ?? offered;
+        return { qid: str(item.qid).trim() || `q${String(index)}`, id: str(item.id).trim() || null, question: text, choices, choices_offered: offered ?? choices, multi_select: Boolean(item.multi_select) && Boolean(choices) };
+    });
+}
+function withTimeoutMetadata(data, now) {
+    const item = { ...data };
+    const requestedAt = Number(item.requested_at) || now;
+    const timeoutRaw = item.timeout_seconds;
+    // The sidecar stamps the resolved Agent timeout; only a frame without one falls back to the Python default (3600).
+    const timeout = timeoutRaw === null || timeoutRaw === undefined ? CLARIFY_DEFAULT_TIMEOUT_SECONDS : Math.trunc(Number(timeoutRaw)) || 0;
+    item.requested_at = requestedAt;
+    item.timeout_seconds = timeout;
+    item.expires_at = timeout <= 0 ? 0 : Number(item.expires_at) || requestedAt + timeout;
+    return item;
+}
+function dedupeIdentity(data) {
+    const questions = data.questions;
+    if (Array.isArray(questions) && questions.length)
+        return JSON.stringify(questions.map((q) => { const item = q; return [str(item.qid), str(item.question), (item.choices ?? []).map(String), Boolean(item.multi_select)]; }));
+    return JSON.stringify([str(data.question), (data.choices_offered ?? []).map(String)]);
+}
+class Queue {
+    entries = [];
+    subscribers = new Set();
+}
+export class PendingPrompts {
+    events;
+    now;
+    approvals = new Map();
+    clarifies = new Map();
+    constructor(events, now = () => Date.now() / 1000) {
+        this.events = events;
+        this.now = now;
+    }
+    queue(map, sid) {
+        let q = map.get(sid);
+        if (!q) {
+            q = new Queue();
+            map.set(sid, q);
+        }
+        return q;
+    }
+    notify(q) {
+        const payload = { pending: q.entries[0] ? { ...q.entries[0] } : null, pending_count: q.entries.length };
+        for (const sub of q.subscribers) {
+            if (sub.queue.length >= 16)
+                sub.queue.shift();
+            sub.queue.push(payload);
+            sub.wake?.();
+        }
+    }
+    // ── approvals ──
+    submitApproval(sid, approval) {
+        const entry = { ...approval };
+        entry.approval_id ??= str(entry.request_id) || randomUUID().replace(/-/g, '');
+        const q = this.queue(this.approvals, sid);
+        if (q.entries.some((e) => e.approval_id === entry.approval_id))
+            return entry;
+        q.entries.push(entry);
+        this.notify(q);
+        this.events.publish('attention_pending');
+        return entry;
+    }
+    approvalPending(sid) {
+        const q = this.approvals.get(sid);
+        return { pending: q?.entries[0] ? { ...q.entries[0] } : null, pending_count: q?.entries.length ?? 0 };
+    }
+    /** The targeted (or oldest) approval without removing it; `found` is false only for a stale id. */
+    peekApproval(sid, approvalId) {
+        const entries = this.approvals.get(sid)?.entries ?? [];
+        if (!entries.length)
+            return { entry: null, found: !approvalId };
+        const entry = approvalId ? entries.find((e) => e.approval_id === approvalId) : entries[0];
+        return { entry: entry ?? null, found: Boolean(entry) };
+    }
+    peekClarify(sid, clarifyId) {
+        const entries = this.clarifies.get(sid)?.entries ?? [];
+        return (clarifyId ? entries.find((e) => e.clarify_id === clarifyId) : entries[0]) ?? null;
+    }
+    /** Pop the targeted (or oldest) approval; returns it or null when a stale id was given. */
+    resolveApproval(sid, approvalId) {
+        const q = this.approvals.get(sid);
+        if (!q?.entries.length)
+            return { entry: null, found: !approvalId };
+        let index = 0;
+        if (approvalId) {
+            index = q.entries.findIndex((e) => e.approval_id === approvalId);
+            if (index < 0)
+                return { entry: null, found: false };
+        }
+        const [entry] = q.entries.splice(index, 1);
+        if (!q.entries.length)
+            this.approvals.delete(sid);
+        this.notify(q);
+        this.events.publish('attention_resolved');
+        return { entry: entry ?? null, found: true };
+    }
+    clearApprovals(sid) {
+        const q = this.approvals.get(sid);
+        if (!q)
+            return [];
+        const entries = q.entries.splice(0);
+        this.approvals.delete(sid);
+        this.notify(q);
+        if (entries.length)
+            this.events.publish('attention_resolved');
+        return entries;
+    }
+    hasApprovalId(sid, approvalId) {
+        return (this.approvals.get(sid)?.entries ?? []).some((e) => e.approval_id === approvalId);
+    }
+    hasPendingApproval(sid) {
+        return (this.approvals.get(sid)?.entries.length ?? 0) > 0;
+    }
+    subscribeApprovals(sid) {
+        const q = this.queue(this.approvals, sid);
+        const sub = { queue: [], wake: null, closed: false };
+        q.subscribers.add(sub);
+        return [sub, this.approvalPending(sid)];
+    }
+    unsubscribeApprovals(sid, sub) {
+        sub.closed = true;
+        const q = this.approvals.get(sid);
+        q?.subscribers.delete(sub);
+        if (q && !q.entries.length && !q.subscribers.size)
+            this.approvals.delete(sid);
+    }
+    // ── clarify ──
+    submitClarify(sid, data) {
+        const item = withTimeoutMetadata(data, this.now());
+        const q = this.queue(this.clarifies, sid);
+        const last = q.entries[q.entries.length - 1];
+        let entry;
+        if (last && dedupeIdentity(last) === dedupeIdentity(item))
+            entry = last;
+        else {
+            entry = item;
+            entry.clarify_id = str(item.clarify_id) || randomUUID().replace(/-/g, '');
+            q.entries.push(entry);
+        }
+        this.notify(q);
+        this.events.publish('attention_pending');
+        return entry;
+    }
+    clarifyPending(sid) {
+        const q = this.clarifies.get(sid);
+        return { pending: q?.entries[0] ? { ...q.entries[0] } : null, pending_count: q?.entries.length ?? 0 };
+    }
+    /** Queue head plus depth: what the live chat stream carries on every head change (Python `_callback_head_payload_locked`). */
+    clarifyHeadFrame(sid) {
+        const { pending, pending_count } = this.clarifyPending(sid);
+        return pending ? { ...pending, pending_count } : null;
+    }
+    /**
+     * Pop a clarify by id (or the oldest). `head` is the new queue head frame when the
+     * resolved entry was the head and others remain — Python re-emits it on the chat stream.
+     */
+    resolveClarify(sid, clarifyId) {
+        const q = this.clarifies.get(sid);
+        if (!q?.entries.length)
+            return { entry: null, head: null };
+        const index = clarifyId ? q.entries.findIndex((e) => e.clarify_id === clarifyId) : 0;
+        if (index < 0)
+            return { entry: null, head: null };
+        const [entry] = q.entries.splice(index, 1);
+        if (!q.entries.length)
+            this.clarifies.delete(sid);
+        this.notify(q);
+        this.events.publish('attention_resolved');
+        return { entry: entry ?? null, head: index === 0 ? this.clarifyHeadFrame(sid) : null };
+    }
+    clearClarifies(sid) {
+        const q = this.clarifies.get(sid);
+        if (!q)
+            return 0;
+        const n = q.entries.length;
+        q.entries.length = 0;
+        this.clarifies.delete(sid);
+        this.notify(q);
+        if (n)
+            this.events.publish('attention_resolved');
+        return n;
+    }
+    hasPendingClarify(sid) {
+        return (this.clarifies.get(sid)?.entries.length ?? 0) > 0;
+    }
+    subscribeClarifies(sid) {
+        const q = this.queue(this.clarifies, sid);
+        const sub = { queue: [], wake: null, closed: false };
+        q.subscribers.add(sub);
+        return [sub, this.clarifyPending(sid)];
+    }
+    unsubscribeClarifies(sid, sub) {
+        sub.closed = true;
+        const q = this.clarifies.get(sid);
+        q?.subscribers.delete(sub);
+        if (q && !q.entries.length && !q.subscribers.size)
+            this.clarifies.delete(sid);
+    }
+    /** Session ids with any outstanding prompt (sidebar attention). */
+    pendingSessionKeys() {
+        const keys = new Set();
+        for (const [sid, q] of this.approvals)
+            if (q.entries.length)
+                keys.add(sid);
+        for (const [sid, q] of this.clarifies)
+            if (q.entries.length)
+                keys.add(sid);
+        return keys;
+    }
+}
+export function nextPendingItem(sub, timeoutMs) {
+    const ready = sub.queue.shift();
+    if (ready)
+        return Promise.resolve(ready);
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => { sub.wake = null; resolve(null); }, timeoutMs);
+        sub.wake = () => {
+            clearTimeout(timer);
+            sub.wake = null;
+            resolve(sub.queue.shift() ?? null);
+        };
+    });
+}
+//# sourceMappingURL=pending.js.map

package/dist/sessions/pending.js.map

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

package/dist/sessions/reasoning-titles.d.ts

@@ -0,0 +1,31 @@
+/** Python `normalize_reasoning_titles`: an ordered title snapshot without guessing from partial prose. */
+export declare function normalizeReasoningTitles(text: unknown, opts?: {
+    explicitTitles?: unknown;
+    stable?: boolean;
+}): string[];
+/** Python `reasoning_event_payload`. */
+export declare function reasoningEventPayload(delta: unknown, cumulative: unknown, opts?: {
+    explicitTitles?: unknown;
+    stable?: boolean;
+}): {
+    text: string;
+    titles?: string[];
+};
+/**
+ * Per-stream title bookkeeping (Python `_prepare_reasoning_titles` / `_remember_reasoning_titles` /
+ * `_reset_reasoning_title_segment`): a new reasoning segment after titles were shown must clear them once.
+ */
+export declare class ReasoningTitleTracker {
+    private lastSent;
+    private needClear;
+    prepare(payload: {
+        text: string;
+        titles?: string[];
+    }): {
+        text: string;
+        titles?: string[];
+    };
+    /** A content/tool boundary closed the reasoning segment: a stable snapshot (or a clear) may be due. */
+    stableSnapshot(cumulative: string): string[] | null;
+    resetSegment(): void;
+}

package/dist/sessions/reasoning-titles.js

@@ -0,0 +1,143 @@
+/** Python `api/reasoning_titles.py`: a small, provider-neutral reasoning-title fallback for WebUI clients. */
+import { redactString } from '../redact.js';
+import { str } from '../util.js';
+const BOLD_LINE = /^\s*\*\*(.+?)\*\*\s*$/;
+const COMMAND_LINE = /^(?:[$>]\s*|(?:\.{0,2}\/)|(?:sudo|env|git|cd|ls|cat|python|node|curl|wget|rg|grep|npm|npx|pnpm|yarn|bun|deno|make|cmake|docker|podman|kubectl|helm|terraform|ansible|xcodebuild|xcrun|swift|go|cargo|rustc|pip|pip3|pytest|bash|sh|zsh|fish|rm|cp|mv|chmod|chown|sed|awk)\b)/i;
+const TOOL_ARGUMENT_LINE = /^(?:--[\w-]+(?:\s|=)|[A-Za-z_][A-Za-z0-9_]*\s*=\s*\S+|(?:args?|arguments?|input|params?)\s*[:=]\s*[[{])/i;
+const MARKDOWN_PREFIX = /^\s*(?:#{1,6}\s+|[-*+]\s+|\d+[.)]\s+)/;
+const SENSITIVE_TITLE = /\b(?:password|passwd|credentials?|secret|ssn)\b|authorization\s*:|private\s+tool\s+output|\b\d{3}-\d{2}-\d{4}\b/i;
+function cleanTitle(value, explicit = false) {
+    let title = str(value).split(/\s+/).filter(Boolean).join(' ').trim();
+    if (!title || title.length > 400)
+        return '';
+    title = title.replace(MARKDOWN_PREFIX, '').trim();
+    if (!title || ['```', '~~~', '<', '{', '['].some((p) => title.startsWith(p)))
+        return '';
+    if (SENSITIVE_TITLE.test(title) || redactString(title, true) !== title)
+        return '';
+    if (COMMAND_LINE.test(title) || TOOL_ARGUMENT_LINE.test(title))
+        return '';
+    if (!explicit) {
+        try {
+            const parsed = JSON.parse(title);
+            if (parsed && typeof parsed === 'object')
+                return '';
+        }
+        catch { /* prose */ }
+    }
+    if (title.length <= 80)
+        return title;
+    const head = title.slice(0, 80);
+    const cut = head.lastIndexOf(' ');
+    const shortened = (cut > 0 ? head.slice(0, cut) : head).replace(/[ ,.;:-]+$/, '');
+    return shortened.length >= 24 ? shortened : '';
+}
+function uniqueTitles(values, explicit = false) {
+    if (!Array.isArray(values))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (typeof value !== 'string')
+            continue;
+        const title = cleanTitle(value, explicit);
+        const key = title.toLowerCase();
+        if (!title || seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(title);
+        if (out.length === 8)
+            break;
+    }
+    return out;
+}
+function reasoningLines(raw) {
+    const lines = [];
+    let fence = null;
+    for (const line of raw.split(/(?<=\r\n|\n|\r)/)) {
+        if (!line)
+            continue;
+        const stripped = line.replace(/^\s+/, '');
+        const marker = stripped.startsWith('```') || stripped.startsWith('~~~') ? stripped.slice(0, 3) : '';
+        if (marker) {
+            if (fence === null)
+                fence = marker;
+            else if (marker === fence)
+                fence = null;
+            lines.push([line, false]);
+            continue;
+        }
+        lines.push([line, fence === null]);
+    }
+    return lines;
+}
+/** Python `normalize_reasoning_titles`: an ordered title snapshot without guessing from partial prose. */
+export function normalizeReasoningTitles(text, opts = {}) {
+    if (opts.explicitTitles !== undefined && opts.explicitTitles !== null)
+        return uniqueTitles(opts.explicitTitles, true);
+    const lines = reasoningLines(str(text));
+    const bold = [];
+    for (const [line, safe] of lines) {
+        if (!safe)
+            continue;
+        const m = BOLD_LINE.exec(line);
+        if (m?.[1])
+            bold.push(m[1]);
+    }
+    const titles = uniqueTitles(bold);
+    if (titles.length)
+        return titles;
+    for (let i = 0; i < lines.length; i += 1) {
+        const [line, safe] = lines[i];
+        if (!line.trim())
+            continue;
+        if (!safe)
+            return [];
+        const complete = line.endsWith('\n') || line.endsWith('\r') || Boolean(opts.stable) || i < lines.length - 1;
+        if (!complete)
+            return [];
+        const title = cleanTitle(line);
+        return title ? [title] : [];
+    }
+    return [];
+}
+/** Python `reasoning_event_payload`. */
+export function reasoningEventPayload(delta, cumulative, opts = {}) {
+    const payload = { text: str(delta) };
+    const titles = normalizeReasoningTitles(opts.stable ? cumulative : delta, opts);
+    if (titles.length || (opts.explicitTitles !== undefined && opts.explicitTitles !== null))
+        payload.titles = titles;
+    return payload;
+}
+/**
+ * Per-stream title bookkeeping (Python `_prepare_reasoning_titles` / `_remember_reasoning_titles` /
+ * `_reset_reasoning_title_segment`): a new reasoning segment after titles were shown must clear them once.
+ */
+export class ReasoningTitleTracker {
+    lastSent = [];
+    needClear = false;
+    prepare(payload) {
+        if (this.needClear && !('titles' in payload))
+            payload.titles = [];
+        if (payload.titles) {
+            this.lastSent = [...payload.titles];
+            this.needClear = false;
+        }
+        return payload;
+    }
+    /** A content/tool boundary closed the reasoning segment: a stable snapshot (or a clear) may be due. */
+    stableSnapshot(cumulative) {
+        const titles = normalizeReasoningTitles(cumulative, { stable: true });
+        if (JSON.stringify(titles) !== JSON.stringify(this.lastSent) && (titles.length || this.needClear)) {
+            this.lastSent = [...titles];
+            this.needClear = false;
+            return titles;
+        }
+        return null;
+    }
+    resetSegment() {
+        this.needClear = this.lastSent.length > 0;
+        this.lastSent = [];
+    }
+}
+//# sourceMappingURL=reasoning-titles.js.map

package/dist/sessions/reasoning-titles.js.map

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

package/dist/sessions/relay.d.ts

@@ -0,0 +1,131 @@
+import type { StreamRegistry } from './streams.js';
+import type { PendingPrompts } from './pending.js';
+import type { SessionStore } from './store.js';
+export declare const PRESENCE_LEASE_SECONDS = 90;
+export declare class RelayPairingError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export interface RelayProfile {
+    identity: string;
+    profile_id: string;
+}
+export interface RelayConfig {
+    url: string;
+    publisher_id: string;
+    key_id: string;
+    private_key_path: string;
+    profiles: Record<string, RelayProfile>;
+}
+/** Python `RelayConfig._validated_origin`: a bare origin with no path, query, credentials, or fragment. */
+export declare function validatedOrigin(raw: string, httpsOnly?: boolean): string;
+export declare function relayStatePath(stateDir: string): string;
+/** Python `RelayConfig.from_state`: null when absent or a v1 file (registration is required again); throws on corruption. */
+export declare function loadRelayConfig(stateDir: string): RelayConfig | null;
+export declare function saveRelayConfig(stateDir: string, config: RelayConfig): void;
+/** Python `_profile_identity`: a persistent `pfi_<32 hex>` per profile home, minted on first use (0600). */
+export declare function profileIdentity(profileHome: string): string;
+/** Profile-scoped browser activity leases; a fresh active lease mutes alerts for that profile. */
+export declare class PresenceLeases {
+    private readonly now;
+    private readonly leases;
+    constructor(now: () => number);
+    private prune;
+    private apply;
+    renew(profile: string, tabId: string, seq?: number): void;
+    revoke(profile: string, tabId: string, seq?: number): void;
+    has(profile: string): boolean;
+    /** Python `update_presence`. */
+    update(body: unknown, profile: string): {
+        ok: true;
+        lease_seconds: number;
+    };
+}
+export interface RelayPublisherDeps {
+    registry: StreamRegistry;
+    pending: PendingPrompts;
+    store: SessionStore;
+    presence: PresenceLeases;
+    profileHome: (profile: string) => string;
+    profilesMatch: (row: string | null | undefined, active: string | null | undefined) => boolean;
+    fetch: () => typeof fetch;
+    now: () => number;
+    log: (line: string) => void;
+}
+export interface RelayState {
+    sessionId: string;
+    streamId: string | null;
+    eventId: string;
+    revision: number;
+    title: string;
+    phase: string;
+    updatedAt: number;
+    deepLink: string;
+    alertEligible?: false;
+}
+/** Python `TalariaRelayPublisher`: coalesces changes into signed complete snapshots with capped backoff. */
+export declare class RelayPublisher {
+    readonly config: RelayConfig;
+    private readonly deps;
+    private readonly key;
+    private readonly revisionPath;
+    private lastRevision;
+    private terminal;
+    private readonly disabledProfiles;
+    private alertEligibilitySupported;
+    private stopped;
+    private loop;
+    private dirty;
+    private wake;
+    private timer;
+    private failures;
+    constructor(config: RelayConfig, deps: RelayPublisherDeps);
+    /** Carry unpublished terminal state and the revision floor from the publisher being replaced. */
+    inherit(previous: RelayPublisher): void;
+    start(publishInitial?: boolean): void;
+    stop(): void;
+    changed(): void;
+    noteTerminal(streamId: string, phase: string): void;
+    private nextRevision;
+    private sleep;
+    private run;
+    /** Python `build_states`: one row per session with a live or recently terminal run in this profile. */
+    buildStates(profile: string): RelayState[];
+    publishSnapshot(isolatePermanent?: boolean): Promise<void>;
+    /** Validation publish for one newly enrolled profile (Python `publish_profile`). */
+    publishProfile(profileId: string, expectedIdentity: string): Promise<void>;
+    private publishProfileSnapshot;
+    private putSnapshot;
+}
+export interface RelayServiceDeps extends RelayPublisherDeps {
+    stateDir: string;
+    env: Record<string, string | undefined>;
+    canonicalProfile: (profile: string) => string;
+    addListener: (listener: () => void) => () => void;
+}
+/** Owns the current publisher and the pairing state machine (Python module-level `_publisher` and friends). */
+export declare class RelayService {
+    private readonly deps;
+    readonly presence: PresenceLeases;
+    private publisher;
+    private candidate;
+    private unsubscribe;
+    private pairing;
+    constructor(deps: RelayServiceDeps);
+    current(): RelayPublisher | null;
+    /** Python `start_talaria_relay_publisher`: resume from saved state; invalid state disables the publisher. */
+    start(): boolean;
+    stop(): void;
+    private adopt;
+    /** Terminal turn events reach the relay even mid-swap (Python `note_talaria_terminal`). */
+    noteTerminal(streamId: string, phase: string): void;
+    /** Python `configure_talaria_relay_publisher`: validate with a real snapshot before swapping publishers. */
+    private configure;
+    /** Python `pair_talaria_relay`, serialised so concurrent enrollments preserve both mappings. */
+    pair(body: unknown, profile: string, operator: boolean): Promise<{
+        ok: true;
+        publisher_id: string;
+    }>;
+    private relayPost;
+    private pairUnlocked;
+}