@fonz/tgcc 0.6.18 → 0.6.19

package/dist/streaming.d.ts

@@ -56,91 +56,78 @@ export declare class StreamAccumulator {
     private splitThreshold;
     private logger?;
     private onError?;
+    private segments;
     private tgMessageId;
-    private buffer;
-    private thinkingBuffer;
-    private imageBase64Buffer;
-    private currentBlockType;
-    private lastEditTime;
-    private editTimer;
-    private thinkingIndicatorShown;
-    private thinkingMessageId;
     private messageIds;
-    private finished;
+    sealed: boolean;
     private sendQueue;
     private turnUsage;
-    /** Usage from the most recent message_start event — represents a single API call's context (not cumulative). */
     private _lastMsgStartCtx;
-    private toolMessages;
+    private currentBlockType;
+    private currentBlockId;
+    private currentSegmentIdx;
     private toolInputBuffers;
-    private currentToolBlockId;
-    private consolidatedToolMsgId;
+    private imageBase64Buffer;
+    private lastEditTime;
+    private flushTimer;
+    private dirty;
+    private turnStartTime;
+    private firstSendReady;
+    private firstSendTimer;
+    private toolHideTimers;
     constructor(options: StreamAccumulatorOptions);
     get allMessageIds(): number[];
     /** Set usage stats for the current turn (called from bridge on result event) */
     setTurnUsage(usage: TurnUsage): void;
+    /** Append a supervisor message segment. Renders in stream order with everything else. */
+    addSupervisorMessage(text: string): void;
     handleEvent(event: StreamInnerEvent): Promise<void>;
     private onContentBlockStart;
     private onContentBlockDelta;
-    /** Send or edit a message. If rawHtml is true, text is already HTML-safe. */
-    private sendOrEdit;
-    private _doSendOrEdit;
-    private sendImage;
-    /** Send or update the consolidated tool indicator message. */
-    private sendToolIndicator;
-    /** Build HTML for the consolidated tool indicator message. */
-    private buildConsolidatedToolHtml;
-    /** Resolved tool result stats, keyed by blockId */
-    private toolResolvedStats;
-    /** Edit the consolidated tool message with current state of all tools. */
-    private updateConsolidatedToolMessage;
-    /** Update a tool indicator message with input preview once the JSON value is complete. */
-    private toolIndicatorLastSummary;
-    private updateToolIndicatorWithInput;
-    /** MCP media tools — on success, delete indicator (the media was sent directly). On failure, keep + react ❌. */
+    private onContentBlockStop;
+    /** Resolve a tool indicator with success/failure status. Called by bridge on tool_result. */
+    resolveToolMessage(blockId: string, isError: boolean, errorMessage?: string, resultContent?: string, toolUseResult?: Record<string, unknown>): void;
+    /** Update a sub-agent segment status (called by bridge on task_started/progress/completed). */
+    updateSubAgentSegment(blockId: string, status: 'running' | 'dispatched' | 'completed', label?: string): void;
+    /** Append a high-signal progress line to a sub-agent segment (called by bridge on task_progress). */
+    appendSubAgentProgress(blockId: string, description: string, lastToolName?: string): void;
     private static MCP_MEDIA_TOOLS;
-    /** Resolve a tool indicator with success/failure status. Updates the consolidated message. */
-    resolveToolMessage(blockId: string, isError: boolean, errorMessage?: string, resultContent?: string, toolUseResult?: Record<string, unknown>): Promise<void>;
-    /** Edit a specific tool indicator message by block ID (updates the consolidated message). */
-    editToolMessage(blockId: string, _html: string): Promise<void>;
-    /** Delete a specific tool from the consolidated indicator. */
-    deleteToolMessage(blockId: string): Promise<void>;
-    /** Delete the consolidated tool indicator message. */
-    deleteAllToolMessages(): Promise<void>;
-    private throttledEdit;
-    /** Build the full message text including thinking blockquote prefix and usage footer.
-     *  Returns { text, hasHtmlSuffix } — caller must pass rawHtml=true when hasHtmlSuffix is set
-     *  because the footer contains pre-formatted HTML (<i> tags).
-     */
-    private buildFullText;
-    private doEdit;
+    /** Render all segments to one HTML string. */
+    renderHtml(): string;
+    /** Force any pending timer to fire immediately and await the send queue.
+     *  Bypasses the first-send gate (like finalize). Useful in tests. */
+    flush(): Promise<void>;
+    /** Mark dirty and schedule a throttled flush. The single entry point for all renders.
+     *  Data in → dirty flag → throttled flush → TG edit. One path, no re-entrant loops. */
+    private flushInFlight;
+    private requestRender;
+    /** Timer callback: consumes dirty flag and chains one _doSendOrEdit onto sendQueue. */
+    private flushRender;
+    /** Split oversized message — called from within the sendQueue chain, uses _doSendOrEdit directly. */
     private splitMessage;
-    /** Emergency split/truncation when buffer exceeds 50KB absolute limit */
-    private forceSplitOrTruncate;
+    private checkFirstSendReady;
+    private clearFirstSendTimer;
+    /** Force-split when a text segment exceeds 50KB */
+    private forceSplitText;
     finalize(): Promise<void>;
-    private clearEditTimer;
-    /** Soft reset: clear buffer/state but keep tgMessageId so next turn edits the same message.
-     *  toolMessages persists across resets — they are independent of the text accumulator. */
+    private sendOrEdit;
+    private _doSendOrEdit;
+    private sendImage;
+    /** Soft reset: clear per-API-call transient state. Segments and tgMessageId persist across
+     *  tool-use loop iterations within the same turn. */
     softReset(): void;
-    /** Full reset: also clears tgMessageId (next send creates a new message).
-     *  Chains on the existing sendQueue so any pending finalize() edits complete first.
-     *  Consolidated tool message resets so next turn starts a fresh batch. */
+    /** Full reset: clear everything for a new turn. */
     reset(): void;
+    private clearFlushTimer;
 }
+/** Format a task_progress event into a single HTML-safe progress line.
+ *  Returns null if the event has no useful display content. */
+export declare function formatProgressLine(description: string, lastToolName?: string): string | null;
 /** Format usage stats as an HTML italic footer line */
 export declare function formatUsageFooter(usage: TurnUsage, _model?: string): string;
 export declare function isSubAgentTool(toolName: string): boolean;
-/** Extract a human-readable summary from partial/complete JSON tool input.
- *  Looks for prompt, task, command, description fields — returns the first found, truncated.
- */
 export declare function extractSubAgentSummary(jsonInput: string, maxLen?: number): string;
-/** Priority index for a label source field. Lower = better. */
 export declare function labelFieldPriority(field: string | null): number;
-/**
- * Extract a human-readable label for a sub-agent from its JSON tool input.
- * Returns { label, field } so callers can track priority and upgrade labels
- * when higher-priority fields become available during streaming.
- */
 export declare function extractAgentLabel(jsonInput: string): {
     label: string;
     field: string | null;
@@ -155,7 +142,9 @@ export interface SubAgentInfo {
     labelField: string | null;
     agentName: string;
     inputPreview: string;
+    startTime: number;
     dispatchedAt: number | null;
+    progressLines: string[];
 }
 export interface SubAgentSender {
     sendMessage(chatId: number | string, text: string, parseMode?: string): Promise<number>;
@@ -166,7 +155,6 @@ export interface SubAgentTrackerOptions {
     chatId: number | string;
     sender: SubAgentSender;
 }
-/** A single mailbox message from a CC background sub-agent. */
 export interface MailboxMessage {
     from: string;
     text: string;
@@ -175,14 +163,13 @@ export interface MailboxMessage {
     color?: string;
     read: boolean;
 }
-/** Callback invoked when all tracked sub-agents have reported via mailbox. */
 export type AllAgentsReportedCallback = () => void;
 export declare class SubAgentTracker {
     private chatId;
     private sender;
     private agents;
     private blockToAgent;
-    private consolidatedAgentMsgId;
+    private standaloneMsgId;
     private sendQueue;
     private teamName;
     private mailboxPath;
@@ -190,58 +177,43 @@ export declare class SubAgentTracker {
     private lastMailboxCount;
     private onAllReported;
     hasPendingFollowUp: boolean;
+    /** When true, stream events update agent metadata but do NOT create TG messages.
+     *  Set to false after the main turn bubble is sealed to allow standalone status bubble. */
+    private inTurn;
     constructor(options: SubAgentTrackerOptions);
     get activeAgents(): SubAgentInfo[];
-    /** Returns true if any sub-agents were tracked in this turn (including completed ones) */
     get hadSubAgents(): boolean;
-    /** Returns true if any sub-agents are in dispatched state (spawned but no result yet) */
     get hasDispatchedAgents(): boolean;
-    /** Mark all dispatched agents as completed — used when CC reports results
-     *  in its main text response rather than via tool_result events.
-     */
+    /** Called after the main bubble is sealed. Creates standalone status bubble for any dispatched agents. */
+    startPostTurnTracking(): Promise<void>;
     markDispatchedAsReportedInMain(): void;
     handleEvent(event: StreamInnerEvent): Promise<void>;
-    /** Handle a tool_result event — marks the sub-agent as completed with collapsible result */
-    /** Set agent metadata from structured tool_use_result */
     setAgentMetadata(toolUseId: string, meta: {
         agentName?: string;
         agentType?: string;
         color?: string;
     }): void;
-    /** Mark an agent as completed externally (e.g. from bridge follow-up) */
     markCompleted(toolUseId: string, _reason: string): void;
     handleToolResult(toolUseId: string, result: string): Promise<void>;
     private onBlockStart;
-    /** Build and edit the shared sub-agent status message. */
-    private updateConsolidatedAgentMessage;
     private onInputDelta;
     private onBlockStop;
-    /** Start a periodic timer that edits the message with elapsed time */
-    /** Set callback invoked when ALL dispatched sub-agents have mailbox results. */
     setOnAllReported(cb: AllAgentsReportedCallback | null): void;
-    /** Set the CC team name (extracted from spawn confirmation tool_result). */
     setTeamName(name: string): void;
     get currentTeamName(): string | null;
     get isMailboxWatching(): boolean;
-    /** Start watching the mailbox file for sub-agent results. */
     startMailboxWatch(): void;
-    /** Stop watching the mailbox file. */
     stopMailboxWatch(): void;
-    /** Read and parse the mailbox file. Returns [] on any error. */
     private readMailboxMessages;
-    /** Process new mailbox messages and update sub-agent TG messages. */
     private processMailbox;
-    /** Find a tracked sub-agent whose label matches the mailbox message's `from` field. */
     private findAgentByFrom;
-    /** Handle a system task_started event — update the sub-agent status display. */
-    handleTaskStarted(toolUseId: string, description: string, taskType?: string): void;
-    /** Handle a system task_progress event — update the sub-agent status with current activity. */
+    handleTaskStarted(toolUseId: string, description: string, _taskType?: string): void;
     handleTaskProgress(toolUseId: string, description: string, lastToolName?: string): void;
-    /** Handle a system task_completed event. */
     handleTaskCompleted(toolUseId: string): void;
-    /** Build and edit the shared sub-agent status message with progress info. */
-    private updateConsolidatedAgentMessageWithProgress;
-    /** Find a tracked sub-agent by tool_use_id. */
+    /** Build the standalone status bubble HTML. */
+    private buildStandaloneHtml;
+    /** Edit the standalone status bubble with current state. */
+    private updateStandaloneMessage;
     getAgentByToolUseId(toolUseId: string): SubAgentInfo | undefined;
     reset(): void;
 }