@maudecode/talaria-web 1.17.2 → 1.19.0

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

@@ -11,14 +11,23 @@ export declare function reasoningConfigFromConfig(config: Config, provider: stri
     enabled: boolean;
     effort?: string;
 } | null;
-/** Python `workspace_system_msg` (#6672): the frozen session-creation workspace and the per-message tag contract. */
+/** The config-decided `AIAgent` budgets a turn builds its agent with; `/refine` builds the same agent (TAL-902). */
+export declare function agentBuildParams(config: Config, source: string, provider: string | null, env: Record<string, string | undefined>): {
+    max_iterations: number | null;
+    max_tokens: number | null;
+    reasoning_config: {
+        enabled: boolean;
+        effort?: string;
+    } | null;
+};
+/** The frozen session-creation workspace, and where the current one lives: the per-turn WebUI session context (TAL-710). */
 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;
+    personalityPrompt: string | null;
     sessionId: string;
     profile: string | null;
     workspace: string;

package/dist/sessions/turn-context.js

@@ -5,7 +5,7 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { coerceReasoningEffort, dict, isDict, personalityPrompt } from '../config/agent-config.js';
+import { coerceReasoningEffort, dict, isDict } from '../config/agent-config.js';
 import { BACKGROUND_TURN_PROMPT } from './background-updates.js';
 import { VALID_REASONING_EFFORTS } from '../providers/tables.js';
 import { str } from '../util.js';
@@ -57,13 +57,21 @@ export function reasoningConfigFromConfig(config, provider, supported = []) {
         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. */
+/** The config-decided `AIAgent` budgets a turn builds its agent with; `/refine` builds the same agent (TAL-902). */
+export function agentBuildParams(config, source, provider, env) {
+    return { max_iterations: processWakeupMaxIterations(maxIterationsFromConfig(config), source, env), max_tokens: maxTokensFromConfig(config), reasoning_config: reasoningConfigFromConfig(config, provider) };
+}
+/** A context value on one line: one with a line break or other control character is JSON-quoted, so it cannot add prompt lines. */
+function contextValue(value) {
+    return /[\p{Cc}\u2028\u2029]/u.test(value) ? JSON.stringify(value).replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029') : value;
+}
+/** The frozen session-creation workspace, and where the current one lives: the per-turn WebUI session context (TAL-710). */
 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.';
+    return `Active workspace at session start: ${contextValue(frozenWorkspace)}\n` +
+        'The current workspace is the Workspace: line of the WebUI session context for this turn: the workspace the user has selected in the web UI for this message. ' +
+        'It overrides any earlier workspace mentioned in this system prompt, memory, or conversation history; [Workspace::v1: ...] tags on older messages in the history are past values. ' +
+        'Use it as your default working directory for ALL file and terminal operations: write_file, read_file, search_files, terminal workdir, and patch. ' +
+        'Never fall back to a hardcoded path.';
 }
 /** Python `_webui_surface_context_prompt`. */
 function surfaceContextPrompt(ctx) {
@@ -78,7 +86,7 @@ function surfaceContextPrompt(ctx) {
     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}`);
+            lines.push(`- ${label}: ${contextValue(value)}`);
     }
     return lines.join('\n');
 }
@@ -126,9 +134,8 @@ export function deliveryContextPrompt(config, hermesHome, homeDisplay) {
 /** 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());
+    if (opts.personalityPrompt)
+        parts.push(opts.personalityPrompt.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));

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

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

@@ -4,11 +4,12 @@ import type { SessionService } from './service.js';
 import { HttpFailure } from './service.js';
 import type { SessionEventBus } from './events.js';
 import { StreamRegistry, SessionChannels } from './streams.js';
-import { type ClarifyAnswers, type PendingSteer, type SteerWithdrawn, type SteerWithdrawRequest } from '@maudecode/talaria-web-contracts';
+import { type RunStatus, type ClarifyAnswers, type PendingSteer, type SessionGoal, type SessionNotice, type SteerWithdrawn, type SteerWithdrawRequest, type SteerSendNowResponse } from '@maudecode/talaria-web-contracts';
 import { PendingPrompts } from './pending.js';
-import { RunJournal, type RunJournalWriter } from './journal.js';
+import type { RunJournal } from './journal.js';
 import { Session } from './session.js';
-import { type Config } from '../config/agent-config.js';
+import { type Config, type PersonalityRow } from '../config/agent-config.js';
+import { type BackgroundUpdate } from './background-updates.js';
 import type { WorkspaceRegistry } from '../workspace/workspaces.js';
 export declare const CHAT_LOCK_WAIT_SECONDS = 2;
 export interface TurnRunnerDeps {
@@ -41,17 +42,30 @@ export interface TurnRunnerDeps {
     updateInProgress?: () => boolean;
     /** Whether a Git mutation or worktree removal is changing this workspace; no run starts inside it meanwhile. */
     workspaceBusy?: (workspace: string) => boolean;
+    /** TAL-913: a checkpoint diff or restore holds the profile's checkpoint store, which a turn's capture would collide with. */
+    checkpointStoreBusy?: (profile: string | null) => boolean;
     /** Runs after the run is retired (Python teardown idle hook: deferred process wakeups). */
     onTurnEnd?: (sessionId: string) => void;
+    /** TAL-576: the profile's authoritative config file (`AgentConfig.path`); `<home>/config.yaml` when absent. */
+    configPath?: (profileHome: string) => string;
     /** The profile's config.yaml (turn budgets, reasoning effort, personality, delivery context); null when unavailable. */
     profileConfig?: (profile: string | null) => Promise<Config | null>;
+    /** TAL-901: the personalities the profile's Agent offers (`AgentConfig.agentPersonalities`); throws when it cannot list them. */
+    personalities?: (profile: string | null) => Promise<PersonalityRow[]>;
+    /** TAL-821: a provider's name as the profile's model catalog lists it (`ProviderCatalog.providerLabel`). */
+    providerLabel?: (profile: string | null, provider: string) => string;
+    /** `auto_title_refresh_every`: a generated title follows the latest exchange every N exchanges; 0 turns it off. */
+    titleRefreshEvery?: () => number;
     env?: Record<string, string | undefined>;
     hermesHome?: string;
     homeDisplay?: () => string;
 }
 export type SteerWithdrawReason = SteerWithdrawRequest['reason'];
 export interface StartTurnOptions {
+    /** The user's text: the transcript row, title, and `persist_user_message`. */
     msg: string;
+    /** What the model gets instead of `msg` (TAL-817: a prompt built-in's expansion); the Agent keeps it as the row's `api_content`. */
+    prompt?: string;
     attachments?: Record<string, unknown>[];
     workspace: string;
     model: string | null;
@@ -59,11 +73,32 @@ export interface StartTurnOptions {
     normalizedModel?: boolean;
     source?: string;
     goalRelated?: boolean;
+    /** Durable delegation identities acknowledged by this automatic turn. */
+    completionKeys?: string[];
+    backgroundUpdate?: BackgroundUpdate;
     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;
+    /** TAL-801: a spoken turn, which the Agent runs on the profile's `auxiliary.voice_chat` slot. */
+    voiceTurn?: boolean;
+    /** TAL-818: the starting client renders `connect_card`; other turns keep the Agent's plain connect links. */
+    connectCard?: boolean;
+    /** The starting client can answer the masked skill-secret variant. */
+    skillSecret?: boolean;
+    /** The settled turn's answer: its last non-error assistant reply, or `` when it produced none. */
+    onDone?: (answer: string) => void | Promise<void>;
+    /** Runs on every other end: an error, a cancel, or a writeback another stream took over (Python background runner: `complete_background(..., "(background task failed)")`). */
+    onFailed?: (failure: TurnFailure) => void | Promise<void>;
 }
+/** How a turn that did not complete ended: the `apperror` frame it sent, if any, and whether it was cancelled. */
+export interface TurnFailure {
+    apperror: Record<string, unknown> | null;
+    cancelled: boolean;
+}
+export type AdmissionResult = StartTurnResponse & {
+    _status?: number;
+    error?: string;
+    active_stream_id?: string | null;
+    held?: boolean;
+};
 export interface StartTurnResponse {
     stream_id?: string;
     session_id?: string;
@@ -103,7 +138,7 @@ 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>;
+    readonly writers: Map<string, import("./storage/backend.js").JournalWriter>;
     private readonly sessionPuts;
     /** Per-session chain for sidecar YOLO mutation + local commit, so opposing toggles cannot interleave. */
     private readonly yoloChains;
@@ -120,8 +155,14 @@ export declare class TurnRunner {
     private readonly liveUsage;
     /** TAL-397: each running turn's latest todo list, which an error or cancel keeps on the session. */
     private readonly liveTodos;
+    /** The current presentation, scoped to its owning stream and released on every terminal path. */
+    private readonly runStatuses;
+    /** TAL-1006: each live stream's open compression span, by its start (epoch seconds). */
+    private readonly compressionSpans;
     /** Streams whose run completed (`done` emitted) and only await title work; a late cancel is a no-op for these. */
     private readonly settledStreams;
+    /** The last adaptive title refresh per session; a successor turn's refresh runs after it (TAL-589). */
+    private readonly titleRefreshes;
     /**
      * TAL-364: what a Stop needs to write the turn's model context: its starting context, the prompt the Agent got, and
      * whether a settlement already used a canonical checkpoint (which marks the stop boundary; later work never replaces it).
@@ -131,14 +172,40 @@ export declare class TurnRunner {
     private readonly stopContexts;
     /** Each turn's worker, so a stopped background turn can be awaited before the user's turn takes the session. */
     private readonly workers;
+    /** TAL-899: sessions whose user pressed Stop; no automatic turn starts in them until the user's next turn is admitted. */
+    private readonly stopHeld;
+    private readonly notices;
+    private readonly goals;
     constructor(deps: TurnRunnerDeps);
     private get registry();
+    /** TAL-899: whether a Stop holds the session's automatic turns (session `automatic_turns_held`). */
+    automaticTurnsHeld(sessionId: string): Promise<boolean>;
+    /** TAL-803: the Agent's active notices for the session (session `notices`). */
+    sessionNotices(sessionId: string): SessionNotice[];
+    /** TAL-808: the session's standing goal (session `goal`). */
+    sessionGoal(sessionId: string): SessionGoal | null;
+    /**
+     * TAL-808: reads the session's goal from the Agent and, when its view changed, sends `session_goal` on `put` (else the
+     * session's live stream) and `sessions_changed`, which reloads the session for a client between turns.
+     */
+    refreshGoal(s: Pick<Session, 'session_id' | 'profile'>, put?: (event: string, data: Record<string, unknown>) => Promise<void>): Promise<void>;
+    /** TAL-808: a session's first detail after a restart reads its goal before answering, so it tells no one else. */
+    loadGoal(sessionId: string): Promise<void>;
+    /** The Agent's `goals.get` into the cache, and a re-read when a timed park ends; whether the view changed. A failed read keeps the last one. */
+    private readGoal;
+    /** Hygiene sweep: a deleted session's hold, notices and goal go with it (TAL-899, TAL-803, TAL-808). */
+    sweep(): Promise<void>;
+    /**
+     * Admit automatic turns through the same workspace recovery and model resolution as user turns. After the user's Stop
+     * none starts (TAL-899): the answer is a `held` 409, and the caller keeps its work for the user's next turn.
+     */
+    startServerTurn(session: Session, opts: Pick<StartTurnOptions, 'msg' | 'source' | 'goalRelated' | 'completionKeys' | 'backgroundUpdate'>): Promise<AdmissionResult>;
+    /** A user's turn; admitting it releases the hold a Stop put on automatic turns (TAL-899). */
+    start(session: Session, opts: StartTurnOptions): Promise<AdmissionResult>;
     /** 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;
-    };
+    private admit;
+    /** Resolves once the stream's worker has ended (settled, failed, or torn down); it never rejects. */
+    finished(streamId: string): Promise<void>;
     /** Python `_checkpoint_user_message_for_eager_session_save`. */
     private checkpointUserMessage;
     private run;
@@ -157,13 +224,27 @@ export declare class TurnRunner {
      * distinct identity.
      */
     private buildUserMessage;
+    /** The settled session as a terminal frame carries it: the display window, redacted. */
+    publicTerminalSession(s: Session): Promise<Record<string, unknown>>;
     /**
      * 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;
+    /** TAL-540, Python `_live_usage_snapshot`: a finished compression's frame, with the counters and the ring's post-compression figures, so clients update before `done`. */
+    private compressedFrame;
+    /** Release only the pending admission metadata; transcript settlement belongs to the caller. */
+    private clearPendingTurn;
     /** Python `_materialize_pending_user_turn_before_error` + error message append + save. */
+    /** `runtimeProvider`: the provider the Agent resolved for the turn, when it reported one. */
     private persistError;
+    /** Every terminal path carries the same starting read's id and generation into settlement. */
+    private settleStateDb;
+    /**
+     * TAL-921: the model context a turn that ends without its settled result leaves: the work its Agent reported, else the
+     * rows it committed past its starting read in `read`, the read its settlement uses.
+     */
+    private unsettledContext;
     private materializePendingUserTurn;
     private appendPartialSnapshot;
     /**
@@ -183,9 +264,20 @@ export declare class TurnRunner {
     private keepLiveState;
     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;
+    /**
+     * TAL-902: `/refine [focus]` starts the Agent's memory/skill review of the chat's model context on its agent
+     * (`chat.refine`, the agent a turn would build); no turn starts. Without a chat, while a turn runs, or before anything
+     * was said it answers with the Agent's wording instead.
+     */
+    refine(s: Session | null, focus: string): Promise<string>;
+    /**
+     * TAL-903: the workspace a session's agent is built at, and whether it is a host path (the profile's terminal runs
+     * locally). Only then does the Agent anchor AGENTS.md discovery and its memory provider there; `chat.start` and
+     * `chat.refine` send the same pair, so the agent `/refine` builds is the one the next turn reuses.
+     */
+    private agentWorkspace;
     /**
      * Python `generate_session_title_for_session`: on-demand title from the persisted transcript; never touches
      * `llm_title_generated`. An explicit regenerate runs even with `auxiliary.title_generation.enabled` off (TAL-531).
@@ -197,8 +289,19 @@ export declare class TurnRunner {
         status: string;
         rawPreview: string;
     }>;
+    /**
+     * TAL-591 (Python `_queue_generated_title_for_imported_session`): a CLI session a mutation claims while it still
+     * carries its default title gets the background title job at once instead of after its first WebUI turn.
+     */
+    titleClaimed(s: Session): Promise<void>;
     /** Python `_run_background_title_update` (spawned only when `_background_title_generation_inputs` is eligible). */
     private backgroundTitle;
+    /**
+     * Python `_maybe_schedule_title_refresh` + `_run_background_title_refresh`: every N exchanges a generated title is
+     * regenerated from the latest exchange; a manual title is never touched.
+     */
+    private refreshTitle;
+    private applyTitleRefresh;
     /**
      * Python `cancel_stream`: persist the partial, mark cancelled, interrupt the Agent, release admission. `withdrawn` is the
      * `steer_withdrawn` (stopped) this Stop emitted, for the cancel response (TAL-426).
@@ -207,6 +310,7 @@ export declare class TurnRunner {
         cancelled: boolean;
         withdrawn: SteerWithdrawn[];
     }>;
+    private stop;
     /**
      * TAL-460: a user's message never joins a background turn. That turn stops quietly (`finalizeCancelled`) and its worker
      * unwinds before the user's turn is admitted, so two Agent runs never share the session. True when one was stopped.
@@ -256,6 +360,9 @@ export declare class TurnRunner {
     private settleConsumedSteers;
     /** What every client shows for a pending steer; the server decides which actions it offers. */
     private pendingSteerView;
+    runStatus(streamId: string): RunStatus | null;
+    /** TAL-1006: the start (epoch seconds) of the stream's open compression span, else null. */
+    compressionStartedAt(streamId: string): number | null;
     /** TAL-424: the active stream's pending steers, oldest first (session detail `pending_steers`). */
     pendingSteers(streamId: string): PendingSteer[];
     private withSteerChain;
@@ -279,9 +386,7 @@ export declare class TurnRunner {
      * once); during tools it goes last on the Agent's queue and stays `sending_now` until taken; with nothing live it
      * stays pending.
      */
-    sendSteerNow(sessionId: string, steerId: string): Promise<{
-        redirected: boolean;
-    }>;
+    sendSteerNow(sessionId: string, steerId: string): Promise<SteerSendNowResponse>;
     respondApproval(sessionId: string, choice: string, approvalId: string, enableYolo: boolean): Promise<Record<string, unknown>>;
     /** The live chat frame after approvals were withdrawn: the new queue head, or `approval_cleared` once none is left. */
     private approvalHeadFrame;
@@ -298,7 +403,7 @@ export declare class TurnRunner {
      * prompt is queued; `invalid` when the answers do not fit its steps; `ok:false` without either when the sidecar
      * did not acknowledge (prompt retained).
      */
-    respondClarify(sessionId: string, clarifyId: string, reply: string | ClarifyAnswers): Promise<{
+    respondClarify(sessionId: string, clarifyId: string, reply: string | ClarifyAnswers | null): Promise<{
         ok: boolean;
         response?: string;
         stale?: boolean;