@maudecode/talaria-web 0.0.0

package/dist/sessions/todo.d.ts

@@ -0,0 +1,8 @@
+/** Todo snapshot derivation from settled transcripts (Python `api/todo_state.py`). */
+export declare const TODO_STATE_VERSION = 1;
+export declare const TODO_PAYLOAD_KEY = "todo_state";
+export declare function normalizeTodoSnapshot(data: unknown): Record<string, unknown> | null;
+export declare function parseTodoToolResult(result: unknown): Record<string, unknown> | null;
+/** Latest `todo` tool result, with a causal timestamp floor when the row lost its own. */
+export declare function deriveTodoState(messages: unknown[] | null | undefined): Record<string, unknown> | null;
+export declare function attachTodoState(payload: Record<string, unknown>, messages: unknown[] | null | undefined): boolean;

package/dist/sessions/todo.js

@@ -0,0 +1,72 @@
+/** Todo snapshot derivation from settled transcripts (Python `api/todo_state.py`). */
+export const TODO_STATE_VERSION = 1;
+export const TODO_PAYLOAD_KEY = 'todo_state';
+const isDict = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+export function normalizeTodoSnapshot(data) {
+    if (!isDict(data) || !Array.isArray(data.todos))
+        return null;
+    return { todos: data.todos, summary: isDict(data.summary) ? data.summary : {}, version: TODO_STATE_VERSION };
+}
+export function parseTodoToolResult(result) {
+    let data = result;
+    if (typeof result === 'string') {
+        try {
+            data = JSON.parse(result);
+        }
+        catch {
+            return null;
+        }
+    }
+    return normalizeTodoSnapshot(data);
+}
+const tsFloat = (raw) => { const n = Number(raw ?? 0); return Number.isFinite(n) && n > 0 ? n : 0; };
+/** Latest `todo` tool result, with a causal timestamp floor when the row lost its own. */
+export function deriveTodoState(messages) {
+    if (!messages?.length)
+        return null;
+    for (let idx = messages.length - 1; idx >= 0; idx -= 1) {
+        const msg = messages[idx];
+        if (!isDict(msg) || msg.role !== 'tool')
+            continue;
+        const content = msg.content;
+        if (typeof content !== 'string' || !content.includes('"todos"'))
+            continue;
+        let data;
+        try {
+            data = JSON.parse(content);
+        }
+        catch {
+            continue;
+        }
+        const snapshot = normalizeTodoSnapshot(data);
+        if (!snapshot)
+            continue;
+        let ts = tsFloat(msg.timestamp);
+        if (ts <= 0) {
+            for (let i = Math.min(idx, messages.length - 1); i >= 0; i -= 1) {
+                const m = messages[i];
+                if (isDict(m))
+                    ts = Math.max(ts, tsFloat(m.timestamp));
+            }
+        }
+        if (ts > 0)
+            snapshot.ts = ts;
+        return snapshot;
+    }
+    return null;
+}
+export function attachTodoState(payload, messages) {
+    if (!messages?.length)
+        return false;
+    try {
+        const snapshot = deriveTodoState(messages);
+        if (!snapshot)
+            return false;
+        payload[TODO_PAYLOAD_KEY] = snapshot;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=todo.js.map

package/dist/sessions/todo.js.map

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

package/dist/sessions/turn-context.d.ts

@@ -0,0 +1,27 @@
+import { type Config } from '../config/agent-config.js';
+export declare const WEBUI_PROGRESS_PROMPT = "WebUI progress guidance:\n- Match the normal Hermes messaging style, but do not let long tool-running WebUI turns appear silent.\n- For long multi-step work that uses tools, emit brief user-visible progress updates as normal assistant content, not only as hidden reasoning.\n- Before the first tool batch in a long task, say what you are about to inspect.\n- After each meaningful batch of tool calls, say what you just confirmed and what you will check next before continuing with more tools.\n- Do not run many independent tool batches back-to-back without visible assistant text between them when the task is still ongoing.\n- Do not keep progress only in reasoning, thinking, or tool-result channels; those are not a substitute for visible interim updates.\n- Each update should say what you are about to check, what you just confirmed, or why the next tool call is needed.\n- Keep updates concise, factual, and in the user's language. One or two short sentences are enough.\n- Do not reveal hidden reasoning, chain-of-thought, private scratchpads, secrets, raw logs, or long tool output.\n- Password, API-key, token, and secret fields are automatically redacted by the system. Treat masked values as intentional redaction, not placeholder text or user input errors, and do not tell the user a stored credential is wrong based on a masked value alone.\n- Final visible assistant replies must be clear, user-facing, and in the user's language, not private planning notes.\n- Do not include terse planning fragments or scratchpad shorthand in visible assistant text. Avoid fragments like \"Need script\", \"Need check logs\", \"Need inspect email\", or \"maybe invite\"; either omit them or rewrite them as clear user-facing progress.\n- For direct answers or very short tasks, skip progress updates and answer normally.";
+/** Python `_process_wakeup_max_iterations`: automatic wakeup turns get a separate bounded tool-call budget. */
+export declare function processWakeupMaxIterations(configured: number | null, source: string, env: Record<string, string | undefined>): number | null;
+/** Python: `agent.max_turns` (else root `max_turns`) → AIAgent `max_iterations`. */
+export declare function maxIterationsFromConfig(config: Config): number | null;
+/** Python: root `max_tokens`, else `agent.max_tokens`. */
+export declare function maxTokensFromConfig(config: Config): number | null;
+/** Python `parse_reasoning_effort` of the coerced `agent.reasoning_effort`. */
+export declare function reasoningConfigFromConfig(config: Config, provider: string | null, supported?: string[]): {
+    enabled: boolean;
+    effort?: string;
+} | null;
+/** Python `workspace_system_msg` (#6672): the frozen session-creation workspace and the per-message tag contract. */
+export declare function workspaceSystemMessage(frozenWorkspace: string): string;
+/** Python `_webui_delivery_context_prompt`: connected platforms, home channels, and scheduled-task delivery hints. */
+export declare function deliveryContextPrompt(config: Config, hermesHome: string, homeDisplay: string): string;
+/** Python `_webui_ephemeral_system_prompt`: personality, surface context, progress guidance, delivery context. */
+export declare function webuiEphemeralSystemPrompt(opts: {
+    config: Config;
+    personality: string | null;
+    sessionId: string;
+    profile: string | null;
+    workspace: string;
+    hermesHome: string;
+    homeDisplay: string;
+}): string;

package/dist/sessions/turn-context.js

@@ -0,0 +1,136 @@
+/**
+ * Per-turn Agent configuration the Python streaming worker derived from the profile's config.yaml: the tool-call and
+ * output budgets, the reasoning config, the frozen-workspace system message, and the WebUI-only ephemeral system
+ * prompt (personality, surface context, progress guidance, delivery hints).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { coerceReasoningEffort, dict, isDict, personalityPrompt } from '../config/agent-config.js';
+import { VALID_REASONING_EFFORTS } from '../providers/tables.js';
+import { str } from '../util.js';
+export const WEBUI_PROGRESS_PROMPT = `WebUI progress guidance:
+- Match the normal Hermes messaging style, but do not let long tool-running WebUI turns appear silent.
+- For long multi-step work that uses tools, emit brief user-visible progress updates as normal assistant content, not only as hidden reasoning.
+- Before the first tool batch in a long task, say what you are about to inspect.
+- After each meaningful batch of tool calls, say what you just confirmed and what you will check next before continuing with more tools.
+- Do not run many independent tool batches back-to-back without visible assistant text between them when the task is still ongoing.
+- Do not keep progress only in reasoning, thinking, or tool-result channels; those are not a substitute for visible interim updates.
+- Each update should say what you are about to check, what you just confirmed, or why the next tool call is needed.
+- Keep updates concise, factual, and in the user's language. One or two short sentences are enough.
+- Do not reveal hidden reasoning, chain-of-thought, private scratchpads, secrets, raw logs, or long tool output.
+- Password, API-key, token, and secret fields are automatically redacted by the system. Treat masked values as intentional redaction, not placeholder text or user input errors, and do not tell the user a stored credential is wrong based on a masked value alone.
+- Final visible assistant replies must be clear, user-facing, and in the user's language, not private planning notes.
+- Do not include terse planning fragments or scratchpad shorthand in visible assistant text. Avoid fragments like "Need script", "Need check logs", "Need inspect email", or "maybe invite"; either omit them or rewrite them as clear user-facing progress.
+- For direct answers or very short tasks, skip progress updates and answer normally.`;
+function positiveInt(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    const n = typeof raw === 'number' ? Math.trunc(raw) : Number.parseInt(str(raw), 10);
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+/** Python `_process_wakeup_max_iterations`: automatic wakeup turns get a separate bounded tool-call budget. */
+export function processWakeupMaxIterations(configured, source, env) {
+    if (source.trim() !== 'process_wakeup')
+        return configured;
+    let cap = Number.parseInt(env.HERMES_WEBUI_PROCESS_WAKEUP_MAX_TURNS ?? '32', 10);
+    if (!Number.isFinite(cap))
+        cap = 32;
+    cap = Math.max(1, Math.min(cap, 128));
+    return configured && configured > 0 ? Math.min(configured, cap) : cap;
+}
+/** Python: `agent.max_turns` (else root `max_turns`) → AIAgent `max_iterations`. */
+export function maxIterationsFromConfig(config) {
+    const agent = dict(config.agent);
+    return positiveInt(agent.max_turns ?? config.max_turns);
+}
+/** Python: root `max_tokens`, else `agent.max_tokens`. */
+export function maxTokensFromConfig(config) {
+    return positiveInt(config.max_tokens ?? dict(config.agent).max_tokens);
+}
+/** Python `parse_reasoning_effort` of the coerced `agent.reasoning_effort`. */
+export function reasoningConfigFromConfig(config, provider, supported = []) {
+    const effort = coerceReasoningEffort(str(dict(config.agent).reasoning_effort), supported, provider ?? '');
+    if (!effort)
+        return null;
+    if (effort === 'none')
+        return { enabled: false };
+    return VALID_REASONING_EFFORTS.includes(effort) ? { enabled: true, effort } : null;
+}
+/** Python `workspace_system_msg` (#6672): the frozen session-creation workspace and the per-message tag contract. */
+export function workspaceSystemMessage(frozenWorkspace) {
+    return `Active workspace at session start: ${frozenWorkspace}\n` +
+        'Every user message is prefixed with [Workspace::v1: /absolute/path] indicating the workspace the user has selected in the web UI at the time they sent that message. ' +
+        'This tag is the single authoritative source of the active workspace and updates with every message. It overrides any prior workspace mentioned in this system prompt, memory, or conversation history. ' +
+        'Always use the value from the most recent [Workspace::v1: ...] tag as your default working directory for ALL file operations: write_file, read_file, search_files, terminal workdir, and patch. ' +
+        'Never fall back to a hardcoded path when this tag is present.';
+}
+/** Python `_webui_surface_context_prompt`. */
+function surfaceContextPrompt(ctx) {
+    const lines = [
+        'WebUI session context:',
+        '- This browser session is not the same live transcript as Telegram, Discord, Slack, or other messaging surfaces.',
+        '- Use durable memory, saved sessions, and available tools for cross-surface recall instead of assuming those transcripts are in this browser chat.',
+        '- Do not copy or dump this browser transcript into external notes or durable memory by default.',
+        '- Write to external notes or durable memory only for explicit captures, durable user preferences, decisions, blockers/open issues, runbook-worthy workflows, or other clearly reusable signals; otherwise leave notes unchanged.',
+        '- When you do write or update a durable note, briefly tell the user what note/section changed so the write is reviewable.',
+    ];
+    for (const [key, label] of [['source', 'Source'], ['session_id', 'Session ID'], ['profile', 'Profile'], ['workspace', 'Workspace']]) {
+        const value = str(ctx[key]).trim();
+        if (value)
+            lines.push(`- ${label}: ${value}`);
+    }
+    return lines.join('\n');
+}
+/** Python `_webui_delivery_context_prompt`: connected platforms, home channels, and scheduled-task delivery hints. */
+export function deliveryContextPrompt(config, hermesHome, homeDisplay) {
+    const connected = ['local (files on this machine)'];
+    try {
+        const statePath = join(hermesHome, 'gateway_state.json');
+        if (existsSync(statePath)) {
+            const raw = JSON.parse(readFileSync(statePath, 'utf8'));
+            const platforms = isDict(raw) ? raw.platforms : null;
+            if (isDict(platforms))
+                for (const name of Object.keys(platforms).sort()) {
+                    const p = platforms[name];
+                    if (isDict(p) && p.state === 'connected' && name !== 'local')
+                        connected.push(`${name}: Connected ✓`);
+                }
+        }
+    }
+    catch { /* unreadable gateway state contributes nothing */ }
+    const lines = [`**Connected Platforms:** ${connected.join(', ')}`];
+    const homeChannels = {};
+    const platformsCfg = dict(config.platforms);
+    for (const [name, pdata] of Object.entries(platformsCfg)) {
+        if (!isDict(pdata) || pdata.enabled === false)
+            continue;
+        const home = pdata.home_channel;
+        if (isDict(home))
+            homeChannels[name] = str(home.name) || name;
+    }
+    const sorted = Object.entries(homeChannels).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    if (sorted.length) {
+        lines.push('', '**Home Channels (default destinations):**');
+        for (const [platform, label] of sorted)
+            lines.push(`  - ${platform}: ${label}`);
+    }
+    lines.push('', '**Delivery options for scheduled tasks:**');
+    lines.push('- `"origin"` → Back to this WebUI/browser session when the WebUI runtime supports origin delivery; otherwise prefer an explicit platform target.');
+    lines.push(`- \`"local"\` → Save to local files only (${homeDisplay}/cron/output/)`);
+    for (const [platform, label] of sorted)
+        lines.push(`- \`"${platform}"\` → Home channel (${label})`);
+    lines.push('', '*For explicit targeting, use `"platform:chat_id"` format if the user provides a specific chat ID. Do not invent private IDs.*');
+    return lines.join('\n');
+}
+/** Python `_webui_ephemeral_system_prompt`: personality, surface context, progress guidance, delivery context. */
+export function webuiEphemeralSystemPrompt(opts) {
+    const parts = [];
+    const prompt = opts.personality ? personalityPrompt(opts.config, opts.personality) : null;
+    if (prompt)
+        parts.push(prompt.trim());
+    parts.push(surfaceContextPrompt({ source: 'webui', session_id: opts.sessionId, profile: opts.profile, workspace: opts.workspace }));
+    parts.push(WEBUI_PROGRESS_PROMPT);
+    parts.push(deliveryContextPrompt(opts.config, opts.hermesHome, opts.homeDisplay));
+    return parts.filter(Boolean).join('\n\n');
+}
+//# sourceMappingURL=turn-context.js.map

package/dist/sessions/turn-context.js.map

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

package/dist/sessions/turn.d.ts

@@ -0,0 +1,178 @@
+import type { SidecarLike } from '../sidecar/client.js';
+import type { SessionStore } from './store.js';
+import type { SessionService } from './service.js';
+import { HttpFailure } from './service.js';
+import type { SessionEventBus } from './events.js';
+import { StreamRegistry, SessionChannels } from './streams.js';
+import { PendingPrompts } from './pending.js';
+import { RunJournal, type RunJournalWriter } from './journal.js';
+import { Session } from './session.js';
+import { type Config } from '../config/agent-config.js';
+import type { WorkspaceRegistry } from '../workspace/workspaces.js';
+export declare const CHAT_LOCK_WAIT_SECONDS = 2;
+export interface TurnRunnerDeps {
+    store: SessionStore;
+    service: () => SessionService;
+    events: SessionEventBus;
+    registry: StreamRegistry;
+    channels: SessionChannels;
+    pending: PendingPrompts;
+    journal: RunJournal;
+    sidecar: () => SidecarLike | null;
+    profileHome: (profile: string | null) => string;
+    workspaces: WorkspaceRegistry;
+    now: () => number;
+    log: (line: string) => void;
+    redactEnabled: () => boolean;
+    /** `webui.session_save_mode`: `deferred` (default) or `eager`. */
+    saveMode: () => 'deferred' | 'eager';
+    /** Per-session toolsets override or the profile's configured toolsets (null lets the Agent decide). */
+    toolsetsFor: (session: Session) => string[] | null;
+    attachmentDir: (sid: string) => string;
+    agentName: () => string;
+    titleGenerationEnabled: () => boolean;
+    /** Terminal relay phase per stream (`completed`/`cancelled`/`failed`); Python `note_talaria_terminal`. */
+    onTerminal?: (streamId: string, phase: string) => void;
+    /** Insights title sync (Python `sync_session_title`), gated on `sync_to_insights` by the runtime. */
+    syncTitle?: (session: Session) => Promise<void>;
+    /** Whether the profile's deletion RPC is in flight (its home must not be entered by a new turn). */
+    profileDeleting?: (profile: string | null) => boolean;
+    /** Runs after the run is retired (Python teardown idle hook: deferred process wakeups). */
+    onTurnEnd?: (sessionId: string) => void;
+    /** The profile's config.yaml (turn budgets, reasoning effort, personality, delivery context); null when unavailable. */
+    profileConfig?: (profile: string | null) => Promise<Config | null>;
+    env?: Record<string, string | undefined>;
+    hermesHome?: string;
+    homeDisplay?: () => string;
+}
+export interface StartTurnOptions {
+    msg: string;
+    attachments?: Record<string, unknown>[];
+    workspace: string;
+    model: string | null;
+    modelProvider: string | null;
+    normalizedModel?: boolean;
+    source?: string;
+    goalRelated?: boolean;
+    ephemeral?: boolean;
+    onDone?: (answer: string) => void;
+    /** Runs when the turn ends in an error or cancel (Python background runner: `complete_background(..., "(background task failed)")`). */
+    onFailed?: () => void;
+}
+export interface StartTurnResponse {
+    stream_id?: string;
+    session_id?: string;
+    pending_started_at?: number | null;
+    turn_id?: string | null;
+    title?: string;
+    effective_model?: string;
+    effective_model_provider?: string;
+}
+interface ErrorClassification {
+    label: string;
+    type: string;
+    hint: string;
+}
+export declare function classifyProviderError(errStr: string, opts?: {
+    silentFailure?: boolean | undefined;
+    condition?: string | undefined;
+}): ErrorClassification;
+export declare function cancelledTurnHint(agentName?: string): string;
+export declare function providerErrorPayload(message: string, errType: string, hint?: string, redact?: boolean): Record<string, unknown>;
+/** The image formats a provider accepts inline; the MIME comes from the bytes, never from the client. */
+/**
+ * Python `_IMAGE_MAGIC` / `_is_valid_image`: the declared MIME must match the file's signature; BMP joins the binary
+ * set, and SVG (text, no signature) is accepted on its declared type when the bytes read as an SVG document.
+ */
+export declare function sniffImageMime(bytes: Buffer, declared?: string): string | null;
+/** Python `build_compression_recovery_payload` + `stamp_compression_exhausted_recovery`. */
+export declare function stampCompressionExhaustedRecovery(s: Session, message: string, details: string): Record<string, unknown>;
+export declare function isGenericContinuationIntent(text: string): boolean;
+/** Python `_explicit_text_signal`: `agent.image_input_mode: text` or a configured `auxiliary.vision` backend. */
+export declare function explicitTextSignal(cfg: Config): boolean;
+export declare const GATEWAY_APPROVAL_RELAY_UNAVAILABLE = "Gateway approval could not be relayed because the active run is unavailable. Reopen the session or retry after it reconnects.";
+export declare class TurnRunner {
+    readonly deps: TurnRunnerDeps;
+    readonly writers: Map<string, RunJournalWriter>;
+    private readonly sessionPuts;
+    /** Per-session chain for sidecar YOLO mutation + local commit, so opposing toggles cannot interleave. */
+    private readonly yoloChains;
+    private readonly abortControllers;
+    private readonly steers;
+    /** Streams whose run completed (`done` emitted) and only await title work; a late cancel is a no-op for these. */
+    private readonly settledStreams;
+    constructor(deps: TurnRunnerDeps);
+    private get registry();
+    /** Python `_start_chat_stream_for_session`: persist pending state, register the channel, launch the worker. */
+    start(session: Session, opts: StartTurnOptions): StartTurnResponse & {
+        _status?: number;
+        error?: string;
+        active_stream_id?: string | null;
+    };
+    /** Python `_checkpoint_user_message_for_eager_session_save`. */
+    private checkpointUserMessage;
+    private run;
+    /**
+     * Python `_build_user_message`: image attachments are embedded as native `image_url` parts only when the Agent's
+     * resolved image mode for this model is `native` (text mode routes them through the Agent's vision tool path), and
+     * only after the bytes are read through an anchored descriptor and sniffed as a real image format.
+     */
+    private buildUserMessage;
+    /**
+     * Python `_session_payload_with_terminal_window`: the same visible-message window contract as `GET /api/session?
+     * msg_limit=` (renderable rows, limited payload shape, windowed tool calls, todo state) with the full count.
+     */
+    private terminalSessionPayload;
+    /** Python `_materialize_pending_user_turn_before_error` + error message append + save. */
+    private persistError;
+    private materializePendingUserTurn;
+    private appendPartialSnapshot;
+    private cancelPayload;
+    /** Python `_emit_cancel_event`: the terminal frame carries the settled session so tabs can render the partial without a reload. */
+    private cancelFrame;
+    /** Python `_finalize_cancelled_turn`/`_persist_cancelled_turn`: only while this stream still owns writeback. */
+    private finalizeCancelled;
+    /** Push a frame onto the session's live chat stream from outside the turn (Python gateway notify callbacks). */
+    private emitToSession;
+    private teardown;
+    /** Journal files with a live writer (retention must leave them alone). */
+    activeJournalPaths(): Set<string>;
+    /** Python `_generate_llm_session_title_via_aux`: aux-route statuses (`llm_aux`, `llm_aux_retry`, `llm_*_aux`). */
+    private llmTitle;
+    /** Python `generate_session_title_for_session`: on-demand title from the persisted transcript; never touches `llm_title_generated`. */
+    generateTitle(s: Session, opts?: {
+        preferLatest?: boolean;
+    }): Promise<{
+        title: string | null;
+        status: string;
+        rawPreview: string;
+    }>;
+    /** Python `_run_background_title_update` (spawned only when `_background_title_generation_inputs` is eligible). */
+    private backgroundTitle;
+    /** Python `cancel_stream`: persist the partial, mark cancelled, interrupt the Agent, release admission. */
+    cancel(streamId: string): Promise<boolean>;
+    steer(sessionId: string, text: string, displayText: string, steerId: string): Promise<Record<string, unknown>>;
+    /** Python `_webui_steer_events_before` for terminal frames: cancel/apperror flush consumed steers and leftovers first. */
+    private takeSteerEventsBefore;
+    /** Python `_pending_webui_steer_suffix_start`: the pending text is the newline-joined tail of the records; earlier ones are consumed. */
+    private static pendingSteerSuffixStart;
+    private consumedSteerPayload;
+    /**
+     * Python `_take_consumed_webui_steers` (live, `keepLeftovers`) and `_finalize_webui_steers` (terminal): records the
+     * Agent no longer holds pending are consumed; at the end the still-pending tail is reported as leftovers.
+     */
+    private takeConsumedSteers;
+    /** Terminal steer bookkeeping for cancel/error paths: consumed records first, then `pending_steer_leftover` for the rest. */
+    private finalizeSteerEvents;
+    respondApproval(sessionId: string, choice: string, approvalId: string, enableYolo: boolean): Promise<Record<string, unknown>>;
+    private withYoloLock;
+    /** Python `set_session_yolo_enabled(False)`: the sidecar must drop its per-session YOLO state before the local flag clears. */
+    disableYolo(sessionId: string): Promise<Record<string, unknown>>;
+    /** `stale` when no such prompt is queued; `ok:false` without `stale` when the sidecar did not acknowledge (prompt retained). */
+    respondClarify(sessionId: string, clarifyId: string, response: string): Promise<{
+        ok: boolean;
+        stale?: boolean;
+        error?: string;
+    }>;
+}
+export { HttpFailure };