@fonz/tgcc 0.6.18 → 0.7.0

package/dist/plugin/src/tools/tgcc-status.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * tgcc_status tool — Get status of TGCC agents and sessions.
+ *
+ * Returns agent states, pending results, pending permissions,
+ * and recent observability events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTgccStatusTool = createTgccStatusTool;
+const events_js_1 = require("../events.js");
+const TgccStatusParams = {
+    type: "object",
+    properties: {
+        agentId: { type: "string", description: "Filter by specific agent ID" },
+        drain: {
+            type: "boolean",
+            description: "If true, drain pending results (remove after reading). Default: false.",
+        },
+        eventsSince: {
+            type: "number",
+            description: "Only return events after this Unix timestamp (ms)",
+        },
+    },
+};
+const json = (payload) => ({
+    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    details: payload,
+});
+function createTgccStatusTool(getClient) {
+    return {
+        name: "tgcc_status",
+        label: "TGCC Status",
+        description: "Get the status of TGCC agents and sessions. Shows agent states, " +
+            "pending results from completed CC sessions, pending permission requests, " +
+            "and recent observability events. Use drain=true to consume pending results.",
+        parameters: TgccStatusParams,
+        async execute(_toolCallId, params) {
+            const p = params;
+            const client = getClient();
+            const connected = client?.isConnected() ?? false;
+            // Get cached agent state
+            const cache = (0, events_js_1.getAgentCache)();
+            // Get pending data
+            const results = p.drain ? (0, events_js_1.drainPendingResults)() : (0, events_js_1.getPendingResults)();
+            const permissions = (0, events_js_1.getPendingPermissions)();
+            const events = (0, events_js_1.getRecentEvents)(p.eventsSince);
+            // Filter by agentId if specified
+            const filterAgent = (items) => p.agentId ? items.filter((i) => i.agentId === p.agentId) : items;
+            // Optionally fetch live status from TGCC
+            let liveStatus = null;
+            if (connected && client) {
+                try {
+                    liveStatus = await client.getStatus(p.agentId);
+                }
+                catch {
+                    // Fall back to cached data
+                }
+            }
+            return json({
+                connected,
+                agents: p.agentId
+                    ? cache[p.agentId]
+                        ? { [p.agentId]: cache[p.agentId] }
+                        : {}
+                    : cache,
+                liveStatus,
+                pendingResults: filterAgent(results),
+                pendingPermissions: filterAgent(permissions),
+                recentEvents: filterAgent(events),
+            });
+        },
+    };
+}
+//# sourceMappingURL=tgcc-status.js.map

package/dist/plugin/src/tools/tgcc-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tgcc-status.js","sourceRoot":"","sources":["../../../../plugin/src/tools/tgcc-status.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsCH,oDAoDC;AAtFD,4CAMsB;AAEtB,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;QACvE,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wEAAwE;SACtF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;SACjE;KACF;CACO,CAAC;AAQX,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5E,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,SAAgB,oBAAoB,CAClC,SAA4C;IAE5C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,kEAAkE;YAClE,2EAA2E;YAC3E,6EAA6E;QAC/E,UAAU,EAAE,gBAA2C;QACvD,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,CAAC,GAAG,MAAiC,CAAC;YAC5C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;YAEjD,yBAAyB;YACzB,MAAM,KAAK,GAAG,IAAA,yBAAa,GAAE,CAAC;YAE9B,mBAAmB;YACnB,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,+BAAmB,GAAE,CAAC,CAAC,CAAC,IAAA,6BAAiB,GAAE,CAAC;YACtE,MAAM,WAAW,GAAG,IAAA,iCAAqB,GAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAA,2BAAe,EAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAE9C,iCAAiC;YACjC,MAAM,WAAW,GAAG,CAAC,KAAkC,EAAE,EAAE,CACzD,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAEnE,yCAAyC;YACzC,IAAI,UAAU,GAAY,IAAI,CAAC;YAC/B,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACH,UAAU,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC;gBACV,SAAS;gBACT,MAAM,EAAE,CAAC,CAAC,OAAO;oBACf,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;wBAChB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;wBACnC,CAAC,CAAC,EAAE;oBACN,CAAC,CAAC,KAAK;gBACT,UAAU;gBACV,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC;gBACpC,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAAC;gBAC5C,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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;
 }