@xenosystem/agent-interface-ui 0.1.35 → 0.1.37

package/dist/stores/agentChatStore.d.ts

@@ -1,693 +0,0 @@
-import type { ConversationEditorDiff, ConversationEditorState } from '../types/agentEditor.js';
-import type { WorkbenchPanelTab } from '../components/agent/AgentWorkbenchPanel.js';
-import type { HubConversationRunSnapshot, HubConversationRuntimeBinding } from '../types/agentRuntimeProvider.js';
-import type { AgentSessionTabState } from '../sessionTabs.js';
-import type { AgentSessionHostBindingV1, ProviderLaneProjectionV1, WebContextToolResultV1, WebJobProgressV1, AcpAvailableCommand, AcpMcpStatus, AcpNotification } from '@xenosystem/agent-interface-contract';
-export interface ChatAttachment {
-    id: string;
-    name: string;
-    type: string;
-    dataUrl: string;
-}
-export interface PermissionRequestInfo {
-    permissionId: string;
-    toolName: string;
-    path: string;
-    directory: string;
-    browserOrigin?: string;
-    reason?: string;
-    /**
-     * The option id meaning "allow always", when the agent offered one (ACP).
-     * Its presence is what lets a surface offer a persist choice for a permission
-     * that names no directory — an ACP `execute` has no path, and gating the
-     * affordance on `directory` alone made policy rules uncreatable by a user.
-     */
-    allowAlwaysOptionId?: string;
-    /** The option id meaning "always refuse", when the agent offered one (ACP). */
-    rejectAlwaysOptionId?: string;
-    status: 'pending' | 'granted' | 'denied' | 'cancelled';
-}
-export interface AskUserRequestInfo {
-    askUserId: string;
-    question: string;
-    options?: string[];
-    context?: string;
-    answer?: string;
-    selectedOption?: string;
-    status: 'pending' | 'answered' | 'cancelled';
-}
-export interface AgentRunCapabilities {
-    terminal?: boolean;
-    browser?: boolean;
-    fileRead?: boolean;
-    fileWrite?: boolean;
-    appLaunch?: boolean;
-    webSearch?: boolean;
-    codeExecution?: boolean;
-    imageGeneration?: boolean;
-    dataAnalysis?: boolean;
-}
-export type AgentPermissionProfileName = 'standard' | 'read-only' | 'edit-with-approval' | 'trusted-workspace' | 'plan';
-export interface AgentApprovalRule {
-    id?: string;
-    surface: 'terminal' | 'browser';
-    action: 'TerminalWriteInput' | 'BrowserGoto' | 'BrowserClick' | 'BrowserType' | 'BrowserKey';
-    matcher: string;
-    command?: string;
-    browserOrigin?: string;
-    urlPattern?: string;
-    selector?: string;
-    key?: string;
-    label?: string;
-    createdAt?: number;
-}
-export type ToolCallCategory = 'file' | 'terminal' | 'search' | 'app' | 'workspace' | 'other';
-export type ToolRiskLevel = 'none' | 'low' | 'medium' | 'high';
-export type ToolCallOutcome = 'succeeded' | 'cancelled' | 'failed';
-export interface ToolArtifact {
-    type: 'file' | 'directory' | 'command' | 'query' | 'app';
-    label: string;
-    value: string;
-    openInEditor?: boolean;
-}
-export interface ToolCallInfo {
-    id: string;
-    toolName: string;
-    params?: Record<string, unknown>;
-    result?: string;
-    success?: boolean;
-    status: 'running' | 'done';
-    outcome?: ToolCallOutcome;
-    permissionRequest?: PermissionRequestInfo;
-    askUserRequest?: AskUserRequestInfo;
-    startedAt?: number;
-    endedAt?: number;
-    durationMs?: number;
-    category?: ToolCallCategory;
-    riskLevel?: ToolRiskLevel;
-    summary?: string;
-    cwd?: string;
-    artifacts?: ToolArtifact[];
-    diff?: ConversationEditorDiff;
-    webContext?: WebContextToolResultV1;
-    /**
-     * Latest accepted observation of the durable web job this tool call is driving.
-     *
-     * Separate from `webContext`, which is terminal EVIDENCE and only ever arrives
-     * once. Progress is a live projection that changes while the tool runs, and a
-     * tool call may carry either, both, or — for every agent that reports no
-     * progress at all — neither. Absent is the pre-existing final-only behaviour
-     * and must stay indistinguishable from it.
-     */
-    webJobProgress?: WebJobProgressV1;
-}
-export interface AssistantTextTurnSegment {
-    id: string;
-    kind: 'text';
-    createdAt: number;
-    text: string;
-}
-export interface AssistantToolTurnSegment {
-    id: string;
-    kind: 'tool_call';
-    createdAt: number;
-    toolCallId: string;
-}
-export type AssistantTurnSegment = AssistantTextTurnSegment | AssistantToolTurnSegment;
-export type AssistantTurnStatus = 'cancelled' | 'interrupted';
-export interface ChatMessage {
-    id: string;
-    role: 'user' | 'assistant';
-    content: string;
-    model?: string;
-    attachments?: ChatAttachment[];
-    showThinking?: boolean;
-    command?: string;
-    isCommandResult?: boolean;
-    thinking?: string;
-    timestamp: number;
-    isStreaming?: boolean;
-    isThinking?: boolean;
-    error?: string;
-    toolCalls?: ToolCallInfo[];
-    segments?: AssistantTurnSegment[];
-    hideToolbar?: boolean;
-    runtimeKind?: 'acp' | 'agent' | 'llm';
-    runtime?: HubConversationRuntimeBinding;
-    run?: HubConversationRunSnapshot;
-    deliveryState?: 'queued';
-    queuedTurnId?: string;
-    turnStatus?: AssistantTurnStatus;
-}
-export interface DeterministicFileCreateRequest {
-    path: string;
-    content: string;
-    selectedDirectory: string;
-    overwrite?: boolean;
-}
-export interface ConversationBranchRuntimeState {
-    events: AgentRuntimeEvent[];
-    runtimeTextProjectedRequestIds?: string[];
-    backgroundTasks?: AgentBackgroundTask[];
-    tokenUsage?: {
-        input: number;
-        output: number;
-        total: number;
-    };
-}
-export interface ConversationBranch {
-    messages: ChatMessage[];
-    timestamp: number;
-    source?: 'edit' | 'navigation' | 'legacy';
-    inactiveReason?: string;
-    tasks?: PlanTask[];
-    runtime?: ConversationBranchRuntimeState;
-}
-export interface ConversationCheckpointSnapshot {
-    schemaVersion?: number;
-    model?: string;
-    runtime?: HubConversationRuntimeBinding;
-    workspaceId?: string;
-    teamId?: string;
-    workspaceMode?: ConversationWorkspaceMode;
-    rootDirectory?: string;
-    grantedDirectories?: string[];
-    editorState?: ConversationEditorState;
-    sessionUi?: ConversationSessionUiState;
-    messages: ChatMessage[];
-    branches?: Record<string, ConversationBranch[]>;
-    activeBranch?: Record<string, number>;
-    materializedBranches?: Record<string, boolean>;
-    tasks?: PlanTask[];
-}
-export interface ConversationCheckpoint {
-    id: string;
-    name: string;
-    createdAt: number;
-    source: 'manual' | 'restore';
-    messageCount: number;
-    queuedCount: number;
-    editorTabCount: number;
-    snapshot: ConversationCheckpointSnapshot;
-}
-export interface ConversationTerminalEntry {
-    id: string;
-    command: string;
-    cwd: string;
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    error?: string | null;
-    startedAt: number;
-    endedAt: number;
-    durationMs: number;
-    success: boolean;
-}
-export interface AgentBackgroundTask {
-    taskId: string;
-    toolName: string;
-    command?: string;
-    status: 'running' | 'stopped' | 'completed' | 'failed' | 'unknown';
-    startedAt: number;
-    updatedAt: number;
-    lastOutput?: string;
-    outputOffset?: number;
-    totalSize?: number;
-    exitCode?: number | null;
-}
-export interface AgentRuntimeEvent {
-    id?: string;
-    sequence?: number;
-    requestId?: string;
-    conversationId?: string;
-    source?: string;
-    type: string;
-    timestamp?: string;
-    [key: string]: unknown;
-}
-export interface ConversationSessionUiState {
-    sessionTab?: AgentSessionTabState;
-    panelOpen?: boolean;
-    panelTab?: WorkbenchPanelTab;
-    selectedTraceMessageId?: string;
-    tasksCollapsed?: boolean;
-    terminalInput?: string;
-    terminalCwd?: string;
-    terminalHistory?: ConversationTerminalEntry[];
-    attachedCodeContextPacks?: Array<{
-        id: string;
-        name: string;
-        tokenEstimate: number;
-        attachedAt: number;
-    }>;
-    attachedCodeContextPrompt?: string;
-    sdkSessionId?: string;
-    sdkSessionDir?: string;
-    sdkSessionHistoryPath?: string;
-    coordinationSessionId?: string;
-    acpSessionId?: string;
-    acpAgentConfigId?: string;
-    acpAgentConfigFingerprint?: string;
-    acpWorkspaceFingerprint?: string;
-    hostBinding?: AgentSessionHostBindingV1;
-    activeLane?: ProviderLaneProjectionV1;
-    lanes?: ProviderLaneProjectionV1[];
-    acpLastCompletedRequestId?: string;
-    acpBindingUpdatedAt?: number;
-    subagentRunId?: string;
-    parentConversationId?: string;
-    parentAgentId?: string;
-    childAgentId?: string;
-    backgroundTasks?: AgentBackgroundTask[];
-    runtimeEvents?: AgentRuntimeEvent[];
-    runtimeTextProjectedRequestIds?: string[];
-    runtimeTokenUsage?: {
-        input: number;
-        output: number;
-        total: number;
-    };
-    lastRuntimeEventType?: string;
-    lastRuntimeEventAt?: number;
-}
-/**
- * Which capability profile a conversation is — the SAME WORDS as `launchMode`, deliberately.
- *
- * 🔴 These were `'workspace' | 'chat-only'` against a launch mode of `'chat' | 'agent'`, and one
- * concept in two vocabularies cost a real defect: the scoped-backup projection builds an untyped
- * record and wrote `workspaceMode: 'chat'` — a value in NEITHER union — so a RESTORED chat
- * conversation failed `assertResumeLaunchScope` and refused to resume. With one vocabulary the
- * guard is `scope.workspaceMode !== launchMode` and that class of mistake cannot be written.
- *
- * - `chat`  — a private managed workspace, no local tool calls (the claude.ai / ChatGPT shape)
- * - `agent` — an explicit local folder, the full development harness (the Claude Code shape)
- *
- * ⚠️ Persisted records predating 2026-09-07 still carry the old words. Read them through
- * `normalizeWorkspaceMode`, never by comparing literals.
- */
-export type ConversationWorkspaceMode = 'unselected' | 'chat' | 'agent';
-export interface ConversationWorkspaceBindingInput {
-    workspaceMode?: ConversationWorkspaceMode;
-    rootDirectory?: string;
-    grantedDirectories?: string[];
-    inheritedDirectories?: string[];
-    hasMessages?: boolean;
-}
-export interface ResolvedConversationWorkspaceBinding {
-    mode: ConversationWorkspaceMode;
-    rootDirectory?: string;
-    allowedDirectories: string[];
-    legacyInferred: boolean;
-}
-export declare function resolveConversationWorkspaceBinding(input: ConversationWorkspaceBindingInput): ResolvedConversationWorkspaceBinding;
-export declare function resetAcpContinuationForWorkspaceChange(sessionUi: ConversationSessionUiState | undefined): ConversationSessionUiState;
-export type PlanTaskStatus = 'pending' | 'in_progress' | 'done' | 'blocked';
-export type PlanTaskSource = 'assistant_message' | 'structured_tool' | 'acp_plan';
-export interface PlanTask {
-    id: string;
-    sourceMessageId?: string;
-    sourceRequestId?: string;
-    text: string;
-    detail?: string;
-    status: PlanTaskStatus;
-    createdAt: number;
-    updatedAt: number;
-    completedAt?: number;
-    order?: number;
-    source?: PlanTaskSource;
-}
-interface AgentTaskEventPayload {
-    action: 'create' | 'update' | 'clear';
-    timestamp?: string | number;
-    task?: {
-        id: string;
-        text: string;
-        detail?: string;
-        status?: PlanTaskStatus;
-        order?: number;
-    };
-    taskId?: string;
-    patch?: {
-        text?: string;
-        detail?: string;
-        status?: PlanTaskStatus;
-        order?: number;
-    };
-}
-interface QueuedConversationTurnBase {
-    id: string;
-    agentId: string;
-    model: string;
-    content: string;
-    queuedAt: number;
-    userMessageId?: string;
-    runtime?: HubConversationRuntimeBinding;
-}
-export interface QueuedAgentConversationTurn extends QueuedConversationTurnBase {
-    kind?: 'agent';
-    systemPrompt?: string;
-    attachments: ChatAttachment[];
-    appendUserMessage: boolean;
-    enableThinking: boolean;
-    initialToolCalls?: ToolCallInfo[];
-    capabilities?: AgentRunCapabilities;
-    permissionProfile?: AgentPermissionProfileName;
-    allowedDirectories?: string[];
-    approvalRules?: AgentApprovalRule[];
-    acpAgentConfigId?: string;
-    acpProviderModel?: string;
-}
-export interface QueuedDeterministicFileCreateTurn extends QueuedConversationTurnBase {
-    kind: 'deterministic_file_create';
-    appendUserMessage: boolean;
-    allowedDirectories?: string[];
-    fileCreate: DeterministicFileCreateRequest;
-}
-export type QueuedConversationTurn = QueuedAgentConversationTurn | QueuedDeterministicFileCreateTurn;
-export interface Conversation {
-    schemaVersion?: number;
-    id: string;
-    agentId: string;
-    model?: string;
-    runtime?: HubConversationRuntimeBinding;
-    workspaceId?: string;
-    teamId?: string;
-    workspaceMode?: ConversationWorkspaceMode;
-    rootDirectory?: string;
-    grantedDirectories?: string[];
-    editorState?: ConversationEditorState;
-    messages: ChatMessage[];
-    title: string;
-    createdAt: number;
-    lastMessageAt: number;
-    pendingTurns?: QueuedConversationTurn[];
-    checkpoints?: ConversationCheckpoint[];
-    tasks?: PlanTask[];
-    sessionUi?: ConversationSessionUiState;
-    branches?: Record<string, ConversationBranch[]>;
-    activeBranch?: Record<string, number>;
-    materializedBranches?: Record<string, boolean>;
-    activeNotifications?: Record<string, AcpNotification>;
-    availableCommands?: AcpAvailableCommand[];
-    mcpStatuses?: Record<string, AcpMcpStatus>;
-    dismissedNotificationKeys?: string[];
-    capabilitySnapshot?: unknown;
-}
-export interface ConversationRuntimeProjection {
-    conversationId?: string;
-    messages: ChatMessage[];
-    tasks: PlanTask[];
-    backgroundTasks: AgentBackgroundTask[];
-    runtimeEvents: AgentRuntimeEvent[];
-    checkpointEvents: AgentRuntimeEvent[];
-    permissionProfileEvents: AgentRuntimeEvent[];
-    eventCount: number;
-    source: 'runtime-events' | 'stored';
-    latestHubSession?: AgentRuntimeEvent;
-    latestSessionError?: AgentRuntimeEvent;
-    latestPermissionProfile?: AgentRuntimeEvent;
-    lastRuntimeEventType?: string;
-    lastRuntimeEventAt?: number;
-}
-export interface PreparedSubagentMainRun {
-    requestId: string;
-    userMessageId?: string;
-    messages: Array<{
-        role: 'user' | 'assistant';
-        content: string;
-    }>;
-    systemPrompt?: string;
-    allowedDirectories: string[];
-}
-export interface CloudRunStatusInfo {
-    requestId: string;
-    runId: string;
-    status?: string;
-    statusReason?: string | null;
-    creditsHeld?: number | null;
-    creditsSettled?: number | null;
-    url?: string;
-}
-interface AgentChatState {
-    conversations: Record<string, Conversation>;
-    /**
-     * 🔴 THE AUTHORITY for "is a turn running, and which one" — conversationId -> requestId.
-     *
-     * `activeRequestId` below is a single global slot and CANNOT represent two live turns:
-     * a second turn overwrites it, so completing the second frees the lock while the first is
-     * still streaming, and the first completing later matches nothing and frees nothing.
-     * That is measured, not assumed — `agentChatStore.concurrentTurns.test.ts`.
-     *
-     * So this map owns admission AND completion matching. `activeRequestId`/`activeConversationId`
-     * are retained as the FOREGROUND turn for the ~80 existing readers that mean "the turn the
-     * user is looking at"; they are no longer consulted to decide whether a new turn may start.
-     */
-    activeTurnsByConversation: Record<string, string>;
-    activeRequestId: string | null;
-    activeConversationId: string | null;
-    persistenceNotice?: {
-        action: 'save' | 'load' | 'delete' | 'runtime-load' | 'recovery';
-        conversationId?: string;
-        message: string;
-        timestamp: number;
-    };
-    /** "Run in cloud" toggle; when true the next turn dispatches a HOSTED run. */
-    cloudRunEnabled: boolean;
-    /** Live hosted-run status/credit indicator, keyed by hub requestId. */
-    cloudRuns: Record<string, CloudRunStatusInfo>;
-    setCloudRunEnabled: (enabled: boolean) => void;
-    /** Active structured notifications (rate-limits, MCP auth warnings, etc.) keyed by conversationId -> notificationId */
-    activeNotifications: Record<string, Record<string, AcpNotification>>;
-    dismissNotification: (conversationId: string, notificationId: string) => void;
-    clearNotifications: (conversationId: string) => void;
-    /** Available slash commands and skills reported by the active agent/CLI, keyed by conversationId */
-    availableCommands: Record<string, AcpAvailableCommand[]>;
-    setAvailableCommands: (conversationId: string, commands: AcpAvailableCommand[]) => void;
-    /** MCP server status records keyed by conversationId -> serverName */
-    mcpStatuses: Record<string, Record<string, AcpMcpStatus>>;
-    getConversation: (conversationId: string) => Conversation | undefined;
-    getConversationRuntimeProjection: (conversationId: string) => ConversationRuntimeProjection | null;
-    createConversation: (agentId: string, conversationId?: string) => string;
-    prepareSubagentMainRun: (params: {
-        conversationId: string;
-        agentId: string;
-        model: string;
-        content: string;
-        requestId: string;
-        systemPrompt?: string;
-        appendUserMessage?: boolean;
-        attachments?: ChatAttachment[];
-        enableThinking?: boolean;
-        initialToolCalls?: ToolCallInfo[];
-        allowedDirectories?: string[];
-    }) => PreparedSubagentMainRun | null;
-    appendMessage: (conversationId: string, message: {
-        id?: string;
-        role: 'user' | 'assistant';
-        content: string;
-        model?: string;
-        attachments?: ChatAttachment[];
-        error?: string;
-        thinking?: string;
-        showThinking?: boolean;
-        isThinking?: boolean;
-        isStreaming?: boolean;
-        command?: string;
-        isCommandResult?: boolean;
-        hideToolbar?: boolean;
-        toolCalls?: ToolCallInfo[];
-        runtime?: HubConversationRuntimeBinding;
-        run?: HubConversationRunSnapshot;
-    }) => void;
-    renameConversation: (conversationId: string, title: string) => void;
-    setConversationModel: (conversationId: string, modelId: string) => void;
-    truncateToMessage: (conversationId: string, messageId: string) => Promise<boolean>;
-    switchBranch: (conversationId: string, messageId: string, direction: 'prev' | 'next') => void;
-    getBranchInfo: (conversationId: string, messageId: string) => {
-        current: number;
-        total: number;
-    } | null;
-    deleteConversation: (conversationId: string) => void;
-    sendMessage: (conversationId: string, agentId: string, model: string, content: string, systemPrompt?: string, options?: {
-        appendUserMessage?: boolean;
-        attachments?: ChatAttachment[];
-        enableThinking?: boolean;
-        initialToolCalls?: ToolCallInfo[];
-        capabilities?: AgentRunCapabilities;
-        permissionProfile?: AgentPermissionProfileName;
-        allowedDirectories?: string[];
-        approvalRules?: AgentApprovalRule[];
-        existingUserMessageId?: string;
-        queuedTurnId?: string;
-        acpAgentConfigId?: string;
-        acpProviderModel?: string;
-        runtime?: HubConversationRuntimeBinding;
-    }) => void;
-    sendAcpMessage: (conversationId: string, agentId: string, acpAgentConfigId: string, model: string, content: string, systemPrompt?: string, options?: {
-        appendUserMessage?: boolean;
-        attachments?: ChatAttachment[];
-        enableThinking?: boolean;
-        initialToolCalls?: ToolCallInfo[];
-        capabilities?: AgentRunCapabilities;
-        permissionProfile?: AgentPermissionProfileName;
-        allowedDirectories?: string[];
-        approvalRules?: AgentApprovalRule[];
-        existingUserMessageId?: string;
-        queuedTurnId?: string;
-        acpProviderModel?: string;
-        runtime?: HubConversationRuntimeBinding;
-    }) => void;
-    sendDeterministicFileCreate: (conversationId: string, agentId: string, model: string, content: string, fileCreate: DeterministicFileCreateRequest, options?: {
-        appendUserMessage?: boolean;
-        allowedDirectories?: string[];
-        existingUserMessageId?: string;
-        queuedTurnId?: string;
-    }) => void;
-    appendChunk: (requestId: string, content: string, thinking: string) => void;
-    addToolCall: (requestId: string, toolCall: ToolCallInfo) => void;
-    updateToolCall: (requestId: string, toolCallId: string, update: Partial<ToolCallInfo>) => void;
-    appendRuntimeEvent: (requestId: string, event: AgentRuntimeEvent) => void;
-    setPermissionRequest: (requestId: string, toolName: string, permissionRequest: PermissionRequestInfo) => void;
-    resolvePermission: (requestId: string, permissionId: string, granted: boolean) => void;
-    setAskUserRequest: (requestId: string, askUserRequest: AskUserRequestInfo) => void;
-    resolveAskUser: (requestId: string, askUserId: string, answer: string, selectedOption?: string) => void;
-    cancelAskUser: (requestId: string, askUserId: string) => void;
-    grantConversationDirectory: (conversationOrRequestId: string, directory: string) => void;
-    updateConversation: (conversationId: string, updates: Partial<Conversation>) => void;
-    createCheckpoint: (conversationId: string, options?: {
-        name?: string;
-        source?: 'manual' | 'restore';
-    }) => {
-        success: boolean;
-        checkpointId?: string;
-        error?: string;
-    };
-    restoreCheckpoint: (conversationId: string, checkpointId: string) => {
-        success: boolean;
-        error?: string;
-    };
-    deleteCheckpoint: (conversationId: string, checkpointId: string) => void;
-    setTaskStatus: (conversationId: string, taskId: string, status: PlanTaskStatus) => void;
-    applyTaskEvent: (requestId: string, event: AgentTaskEventPayload) => void;
-    removeQueuedTurn: (conversationId: string, queuedTurnId: string) => void;
-    finalizeStream: (requestId: string) => void;
-    setStreamError: (requestId: string, error: string) => void;
-    resumeQueuedTurns: () => void;
-    /**
-     * Cancel the turn running IN `conversationId`.
-     *
-     * 🔴 The argument is not optional in spirit, only in signature. With concurrent turns the
-     * global `activeRequestId` names the FOREGROUND turn, so an argument-less abort pressed
-     * while viewing one conversation could cancel a different conversation's turn. Callers that
-     * know which conversation the Stop button belongs to must say so; the fallback exists only
-     * for legacy call sites and keeps the old single-turn behaviour.
-     */
-    abort: (conversationId?: string) => void;
-}
-/** Resolve a live runtime event without requiring a renderer-created message. */
-export declare function resolveConversationIdForRuntimeEvent(conversations: Record<string, Conversation>, requestId: string, eventConversationId?: string, preferredConversationId?: string | null): string | null;
-/**
- * The next queued turn to run: OLDEST first, across every conversation.
- *
- * 🔴 Exported for the same reason `projectConversationRuntimeEvents` is —
- * it is a pure rule with a consequence, and it had no test. A queue of
- * corrections run newest-first would apply a person's second thought before
- * their first, which is worse than not queueing at all.
- */
-export declare function findOldestQueuedTurn(conversations: Record<string, Conversation>): {
-    conversationId: string;
-    turn: QueuedConversationTurn;
-} | null;
-/**
- * 🔴 THE CONCURRENCY CEILING, and it is not optional.
- *
- * The global turn lock this file used to hold was accidentally also a RESOURCE ceiling:
- * exactly one provider process could run at a time. Making turns per-conversation without
- * replacing that ceiling would let a user with fifteen conversations spawn fifteen agent
- * child processes, each with a real model bill — a worse bug than the one being fixed, and
- * one a two-conversation test would never show.
- *
- * So the model is: **one turn per conversation, N turns overall.** Anything beyond N queues
- * exactly as it does today, which is why the queue machinery is preserved rather than
- * deleted — it becomes the ceiling's overflow path.
- *
- * N is a resource decision, not a correctness one. Three is chosen to be plainly more than
- * one (the reported bug) and plainly less than "unbounded"; raise it deliberately, with the
- * cost of a concurrent provider process in mind.
- */
-export declare const MAX_CONCURRENT_TURNS = 3;
-/** The requestId currently running IN this conversation, or null. */
-export declare function conversationActiveRequestId(activeTurnsByConversation: Record<string, string>, conversationId: string): string | null;
-export declare function activeTurnCount(activeTurnsByConversation: Record<string, string>): number;
-/**
- * The admission decision for a new turn, and the ONLY place it is made.
- *
- * 🔴 All three reasons are conversation-aware or global-by-design; none of them is the old
- * "is anything running anywhere" test:
- *
- * - `conversation_busy`  — this conversation already has a live turn. One at a time per
- *   conversation is the actual invariant a user expects.
- * - `conversation_queued` — this conversation already has queued work, so a new send must
- *   go behind it or messages would arrive out of order.
- * - `ceiling`            — N turns are already running elsewhere. Overflow queues.
- *
- * ⚠️ `conversation_queued` reads THIS conversation's `pendingTurns`, never
- * `findOldestQueuedTurn`, which scans every conversation. That scan is what made a queued
- * turn in A block a send in B, and fixing only the active-turn half would have left the
- * symptom alive in a narrower form.
- */
-export type TurnAdmission = {
-    admit: true;
-} | {
-    admit: false;
-    reason: 'conversation_busy' | 'conversation_queued' | 'ceiling';
-};
-export declare function decideTurnAdmission(conversations: Record<string, Conversation>, activeTurnsByConversation: Record<string, string>, conversationId: string, maxConcurrentTurns?: number): TurnAdmission;
-/**
- * The oldest queued turn in a conversation that could actually run right now.
- *
- * The old drain took the globally oldest queued turn and ran it only when NOTHING was
- * active. With per-conversation turns that starves every other conversation behind one
- * long-running turn, so the candidate set is filtered by the same admission rule.
- */
-/**
- * 🔴 COMPLETION MATCHING, and this is the function the whole design rests on.
- *
- * It releases the slot held BY THIS requestId, wherever it is — never "the current slot".
- * That distinction is the entire bug the global field had: with one scalar, completing the
- * SECOND turn freed the lock while the FIRST was still streaming, and the first completing
- * later matched nothing and freed nothing. Keyed by requestId, a late or out-of-order
- * terminal event can only ever free its own turn, and a stale one frees nothing.
- *
- * Returns the SAME object when there is nothing to release, so an unrelated terminal event
- * cannot invalidate referential equality and churn every subscriber.
- */
-export declare function releaseTurnSlot(activeTurnsByConversation: Record<string, string>, requestId: string): Record<string, string>;
-/**
- * Release whatever slot a conversation holds, because the conversation itself is going away.
- *
- * ⚠️ Without this, deleting a conversation mid-turn leaks its slot FOREVER: the map entry
- * survives, no terminal event can ever arrive for a conversation that no longer exists, and
- * the ceiling silently tightens by one every time it happens until nothing may start at all.
- * The old global lock had no equivalent failure because it was cleared by conversation
- * identity on the same path.
- */
-export declare function releaseConversationSlot(activeTurnsByConversation: Record<string, string>, conversationId: string): Record<string, string>;
-export declare function findOldestAdmissibleQueuedTurn(conversations: Record<string, Conversation>, activeTurnsByConversation: Record<string, string>, maxConcurrentTurns?: number): {
-    conversationId: string;
-    turn: QueuedConversationTurn;
-} | null;
-interface RuntimeProjectionOptions {
-    textAuthority?: 'compatibility' | 'runtime';
-    activeRequestId?: string | null;
-}
-export declare function projectConversationRuntimeEvents(messages: ChatMessage[], runtimeEvents: AgentRuntimeEvent[], backgroundTasks?: AgentBackgroundTask[], tasks?: PlanTask[], options?: RuntimeProjectionOptions): {
-    messages: ChatMessage[];
-    backgroundTasks?: AgentBackgroundTask[];
-    tasks?: PlanTask[];
-};
-export declare function projectConversationRuntimeState(conversation?: Conversation | null): ConversationRuntimeProjection;
-export declare const useAgentChatStore: import("zustand").UseBoundStore<import("zustand").StoreApi<AgentChatState>>;
-export declare function setupAgentChatListeners(): () => void;
-export declare function loadLocalAgentConversations(): Promise<void>;
-export {};
-//# sourceMappingURL=agentChatStore.d.ts.map