opencode-lark 0.1.1

package/dist/streaming/session-observer.js

@@ -0,0 +1,140 @@
+// ═══════════════════════════════════════════
+// Session Observer
+// Observes opencode sessions and forwards TUI-initiated
+// messages to Feishu chats.
+// ═══════════════════════════════════════════
+import { buildQuestionCard, buildPermissionCard } from "../handler/streaming-integration.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractMessageId(rawEvent) {
+    if (rawEvent === null || typeof rawEvent !== "object")
+        return undefined;
+    const props = rawEvent.properties;
+    if (!props || typeof props !== "object")
+        return undefined;
+    const p = props;
+    // message.part.updated  → properties.part.messageID
+    // message.part.delta    → properties.messageID
+    const part = p.part;
+    if (part && typeof part === "object") {
+        const mid = part.messageID;
+        if (typeof mid === "string")
+            return mid;
+    }
+    const mid = p.messageID;
+    if (typeof mid === "string")
+        return mid;
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createSessionObserver(deps) {
+    const { feishuClient, eventProcessor, addListener, removeListener, logger, seenInteractiveIds } = deps;
+    // Feishu-initiated message IDs — skip these in forwarding
+    const knownMessageIds = new Set();
+    // Per-messageId text accumulation
+    const textBuffers = new Map();
+    // Active observation state per session
+    const observedSessions = new Map();
+    function flushBuffers(chatId) {
+        for (const [messageId, text] of textBuffers) {
+            if (text.trim().length === 0)
+                continue;
+            feishuClient
+                .sendMessage(chatId, {
+                msg_type: "text",
+                content: JSON.stringify({ text }),
+            })
+                .catch((err) => {
+                logger.error(`Failed to send TUI message for ${messageId}: ${err}`);
+            });
+        }
+        textBuffers.clear();
+    }
+    return {
+        observe(sessionId, chatId) {
+            if (observedSessions.has(sessionId))
+                return;
+            const listener = (rawEvent) => {
+                const action = eventProcessor.processEvent(rawEvent);
+                if (!action)
+                    return;
+                const messageId = extractMessageId(rawEvent);
+                // Skip events belonging to Feishu-initiated messages
+                if (messageId && knownMessageIds.has(messageId))
+                    return;
+                switch (action.type) {
+                    case "TextDelta": {
+                        if (!messageId)
+                            break;
+                        const current = textBuffers.get(messageId) ?? "";
+                        textBuffers.set(messageId, current + action.text);
+                        break;
+                    }
+                    case "SessionIdle": {
+                        flushBuffers(chatId);
+                        break;
+                    }
+                    case "QuestionAsked": {
+                        if (seenInteractiveIds.has(action.requestId))
+                            break;
+                        seenInteractiveIds.add(action.requestId);
+                        logger.info(`Question event received in observer for chat ${chatId}, requestId=${action.requestId}`);
+                        const questionCard = buildQuestionCard(action);
+                        feishuClient
+                            .sendMessage(chatId, {
+                            msg_type: "interactive",
+                            content: JSON.stringify(questionCard),
+                        })
+                            .catch((err) => {
+                            logger.warn(`Question card send failed (observer): ${err}`);
+                        });
+                        break;
+                    }
+                    case "PermissionRequested": {
+                        if (seenInteractiveIds.has(action.requestId))
+                            break;
+                        seenInteractiveIds.add(action.requestId);
+                        logger.info(`Permission event received in observer for chat ${chatId}, requestId=${action.requestId}`);
+                        const permissionCard = buildPermissionCard(action);
+                        feishuClient
+                            .sendMessage(chatId, {
+                            msg_type: "interactive",
+                            content: JSON.stringify(permissionCard),
+                        })
+                            .catch((err) => {
+                            logger.warn(`Permission card send failed (observer): ${err}`);
+                        });
+                        break;
+                    }
+                    default:
+                        // ToolStateChange, SubtaskDiscovered — ignored
+                        break;
+                }
+            };
+            addListener(sessionId, listener);
+            observedSessions.set(sessionId, { chatId, listener });
+            logger.info(`Observing session ${sessionId} for chat ${chatId}`);
+        },
+        markOwned(messageId) {
+            knownMessageIds.add(messageId);
+            // Drop any buffered text for this message
+            textBuffers.delete(messageId);
+        },
+        getChatForSession(sessionId) {
+            return observedSessions.get(sessionId)?.chatId;
+        },
+        stop() {
+            for (const [sessionId, { listener }] of observedSessions) {
+                removeListener(sessionId, listener);
+            }
+            observedSessions.clear();
+            textBuffers.clear();
+            knownMessageIds.clear();
+            logger.info("Session observer stopped");
+        },
+    };
+}
+//# sourceMappingURL=session-observer.js.map

package/dist/streaming/session-observer.js.map

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

package/dist/streaming/streaming-card.d.ts

@@ -0,0 +1,37 @@
+/**
+ * High-level streaming card session manager.
+ * Wraps CardKitClient with throttling, tool status, sub-agent buttons,
+ * and full lifecycle management.
+ */
+import type { CardKitClient } from "../feishu/cardkit-client.js";
+import type { FeishuApiClient } from "../feishu/api-client.js";
+export interface StreamingCardOptions {
+    cardkitClient: CardKitClient;
+    feishuClient: FeishuApiClient;
+    chatId: string;
+}
+export declare class StreamingCardSession {
+    private readonly cardkitClient;
+    private readonly feishuClient;
+    private readonly chatId;
+    private state;
+    private closed;
+    private queue;
+    private lastUpdateTime;
+    private pendingText;
+    private lastSentContent;
+    private readonly updateThrottleMs;
+    private toolStatuses;
+    private subtaskButtons;
+    constructor(options: StreamingCardOptions);
+    get isActive(): boolean;
+    start(): Promise<void>;
+    setToolStatus(name: string, state: "running" | "completed" | "error", title?: string): Promise<void>;
+    addSubtaskButton(label: string, actionValue: string): Promise<void>;
+    close(finalText?: string): Promise<void>;
+    private enqueueUpdate;
+    private buildToolStatusText;
+    private buildButtonsText;
+    private buildFullContent;
+}
+//# sourceMappingURL=streaming-card.d.ts.map

package/dist/streaming/streaming-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-card.d.ts","sourceRoot":"","sources":["../../src/streaming/streaming-card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,6BAA6B,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,aAAa,CAAA;IAC5B,YAAY,EAAE,eAAe,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAoBD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IAEvC,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,cAAc,CAAsB;gBAEhC,OAAO,EAAE,oBAAoB;IAMzC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCtB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA8BhC,aAAa;IAiB3B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/streaming/streaming-card.js

@@ -0,0 +1,139 @@
+/**
+ * High-level streaming card session manager.
+ * Wraps CardKitClient with throttling, tool status, sub-agent buttons,
+ * and full lifecycle management.
+ */
+export class StreamingCardSession {
+    cardkitClient;
+    feishuClient;
+    chatId;
+    state = null;
+    closed = false;
+    queue = Promise.resolve();
+    lastUpdateTime = 0;
+    pendingText = null;
+    lastSentContent = "";
+    updateThrottleMs = 100;
+    toolStatuses = [];
+    subtaskButtons = [];
+    constructor(options) {
+        this.cardkitClient = options.cardkitClient;
+        this.feishuClient = options.feishuClient;
+        this.chatId = options.chatId;
+    }
+    get isActive() {
+        return this.state !== null && !this.closed;
+    }
+    async start() {
+        if (this.state) {
+            return;
+        }
+        const cardJson = {
+            schema: "2.0",
+            config: {
+                streaming_mode: true,
+                summary: { content: "[Generating...]" },
+                streaming_config: {
+                    print_frequency_ms: { default: 200 },
+                    print_step: { default: 10 },
+                },
+            },
+            body: {
+                elements: [
+                    { tag: "markdown", content: "🛠️ Processing...", element_id: "content" },
+                ],
+            },
+        };
+        const cardId = await this.cardkitClient.createCard(cardJson);
+        const result = await this.feishuClient.sendMessage(this.chatId, {
+            msg_type: "interactive",
+            content: JSON.stringify({ type: "card", data: { card_id: cardId } }),
+        });
+        const messageId = result.data?.["message_id"];
+        if (!messageId) {
+            throw new Error("sendMessage returned no message_id");
+        }
+        this.state = { cardId, messageId, sequence: 1, currentText: "" };
+    }
+    async setToolStatus(name, state, title) {
+        if (!this.state || this.closed) {
+            return;
+        }
+        const existing = this.toolStatuses.find((t) => t.name === name);
+        if (existing) {
+            existing.state = state;
+            if (title !== undefined)
+                existing.title = title;
+        }
+        else {
+            this.toolStatuses.push({ name, state, title });
+        }
+        // Build tool status text and update the content element
+        const fullContent = this.buildFullContent();
+        await this.enqueueUpdate(fullContent);
+    }
+    async addSubtaskButton(label, actionValue) {
+        if (!this.state || this.closed) {
+            return;
+        }
+        this.subtaskButtons.push({ label, actionValue });
+        // Rebuild full content with buttons section
+        const fullContent = this.buildFullContent();
+        await this.enqueueUpdate(fullContent);
+    }
+    async close(finalText) {
+        if (!this.state || this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.queue;
+        // Final content: use finalText override, tool status content, or "Done" fallback
+        const text = finalText ?? (this.toolStatuses.length > 0 ? this.buildFullContent() : "✅ Done");
+        // Only send final update if content differs from what was last sent
+        if (text && text !== this.lastSentContent) {
+            this.state.sequence += 1;
+            await this.cardkitClient.updateElement(this.state.cardId, "content", text, this.state.sequence);
+        }
+        // Close streaming mode with tool-focused summary
+        const completed = this.toolStatuses.filter(t => t.state === "completed").length;
+        const summary = completed > 0 ? `✅ ${completed} tool(s) used` : "Done";
+        this.state.sequence += 1;
+        await this.cardkitClient.closeStreaming(this.state.cardId, summary, this.state.sequence);
+    }
+    async enqueueUpdate(content) {
+        this.queue = this.queue.then(async () => {
+            if (!this.state || this.closed) {
+                return;
+            }
+            this.state.sequence += 1;
+            await this.cardkitClient.updateElement(this.state.cardId, "content", content, this.state.sequence);
+            this.lastSentContent = content;
+        });
+        await this.queue;
+    }
+    buildToolStatusText() {
+        if (this.toolStatuses.length === 0) {
+            return "";
+        }
+        const icons = {
+            running: "🔄",
+            completed: "✅",
+            error: "❌",
+        };
+        const lines = this.toolStatuses.map((t) => t.title ? `${icons[t.state]} ${t.name} · ${t.title}` : `${icons[t.state]} ${t.name}`);
+        return "\n\n---\n" + lines.join("\n");
+    }
+    buildButtonsText() {
+        if (this.subtaskButtons.length === 0) {
+            return "";
+        }
+        const lines = this.subtaskButtons.map((b) => `🔗 [${b.label}](${b.actionValue})`);
+        return "\n\n---\n" + lines.join("\n");
+    }
+    buildFullContent() {
+        const toolText = this.buildToolStatusText();
+        const buttonText = this.buildButtonsText();
+        return toolText + buttonText || "🛠️ Processing...";
+    }
+}
+//# sourceMappingURL=streaming-card.js.map

package/dist/streaming/streaming-card.js.map

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

package/dist/streaming/subagent-card.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Sub-agent card handler for Feishu.
+ * Handles button clicks to view sub-agent session conversations.
+ * Formats messages and sends as interactive cards.
+ */
+import type { Logger } from "../utils/logger.js";
+import type { FeishuApiClient } from "../feishu/api-client.js";
+import type { FeishuCardAction } from "../types.js";
+import type { SubAgentTracker, MessageSummary } from "./subagent-tracker.js";
+export interface SubAgentCardDeps {
+    subAgentTracker: SubAgentTracker;
+    feishuClient: FeishuApiClient;
+    logger: Logger;
+}
+/**
+ * Creates a handler for sub-agent card button clicks.
+ * Fetches child session messages and sends as Feishu card.
+ */
+export declare function createSubAgentCardHandler(deps: SubAgentCardDeps): (action: FeishuCardAction) => Promise<void>;
+/**
+ * Formats messages with role indicators and truncation.
+ * Role indicators: 👤 user / 🤖 assistant / 🛠 tool
+ * Truncates at 4000 chars with "...(内容过长，已截断)"
+ */
+export declare function formatSubAgentMessages(messages: MessageSummary[]): string;
+/**
+ * Builds a Feishu card for sub-agent messages.
+ * Header: "🔍 子任务详情" with blue template
+ * Body: div with lark_md content
+ */
+export declare function buildSubAgentCard(description: string, content: string): Record<string, unknown>;
+//# sourceMappingURL=subagent-card.d.ts.map

package/dist/streaming/subagent-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-card.d.ts","sourceRoot":"","sources":["../../src/streaming/subagent-card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAM5E,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,eAAe,CAAA;IAChC,YAAY,EAAE,eAAe,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,IAGhD,QAAQ,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAkCvD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAkCzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}

package/dist/streaming/subagent-card.js

@@ -0,0 +1,103 @@
+/**
+ * Sub-agent card handler for Feishu.
+ * Handles button clicks to view sub-agent session conversations.
+ * Formats messages and sends as interactive cards.
+ */
+// ─────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────
+/**
+ * Creates a handler for sub-agent card button clicks.
+ * Fetches child session messages and sends as Feishu card.
+ */
+export function createSubAgentCardHandler(deps) {
+    const { subAgentTracker, feishuClient, logger } = deps;
+    return async (action) => {
+        // Check action type early
+        const actionType = action.action?.value?.action;
+        if (actionType !== "view_subagent") {
+            return;
+        }
+        const childSessionId = action.action?.value?.childSessionId;
+        const messageId = action.open_message_id;
+        if (!childSessionId || !messageId) {
+            logger.warn("Missing childSessionId or messageId in subagent card action");
+            return;
+        }
+        try {
+            // Fetch child messages
+            const messages = await subAgentTracker.getChildMessages(childSessionId, 50);
+            // Format messages for display
+            const content = formatSubAgentMessages(messages);
+            // Build and send card
+            const card = buildSubAgentCard("子任务进展", content);
+            await feishuClient.replyMessage(messageId, {
+                msg_type: "interactive",
+                content: JSON.stringify(card),
+            });
+            logger.info(`Sent subagent card for session ${childSessionId}`);
+        }
+        catch (error) {
+            logger.error(`Failed to send subagent card: ${String(error)}`);
+        }
+    };
+}
+/**
+ * Formats messages with role indicators and truncation.
+ * Role indicators: 👤 user / 🤖 assistant / 🛠 tool
+ * Truncates at 4000 chars with "...(内容过长，已截断)"
+ */
+export function formatSubAgentMessages(messages) {
+    if (messages.length === 0) {
+        return "暂无对话内容";
+    }
+    const roleIcons = {
+        user: "👤",
+        assistant: "🤖",
+        tool: "🛠",
+    };
+    const lines = [];
+    for (const msg of messages) {
+        const icon = roleIcons[msg.role] ?? "❓";
+        const roleLabel = msg.role.charAt(0).toUpperCase() + msg.role.slice(1);
+        lines.push(`${icon} **${roleLabel}**`);
+        lines.push(msg.text);
+        if (msg.toolCalls && msg.toolCalls.length > 0) {
+            lines.push(`  _工具调用: ${msg.toolCalls.join(", ")}_`);
+        }
+        lines.push("");
+    }
+    let content = lines.join("\n");
+    // Truncate at 4000 chars
+    if (content.length > 4000) {
+        content = content.slice(0, 4000) + "\n\n...(内容过长，已截断)";
+    }
+    return content;
+}
+/**
+ * Builds a Feishu card for sub-agent messages.
+ * Header: "🔍 子任务详情" with blue template
+ * Body: div with lark_md content
+ */
+export function buildSubAgentCard(description, content) {
+    return {
+        config: { wide_screen_mode: true },
+        header: {
+            title: {
+                tag: "plain_text",
+                content: `🔍 ${description}`,
+            },
+            template: "blue",
+        },
+        elements: [
+            {
+                tag: "div",
+                text: {
+                    tag: "lark_md",
+                    content,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=subagent-card.js.map

package/dist/streaming/subagent-card.js.map

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

package/dist/streaming/subagent-tracker.d.ts

@@ -0,0 +1,45 @@
+import type { SubtaskDiscovered } from "./event-processor.js";
+export interface TrackedSubAgent {
+    parentSessionId: string;
+    childSessionId?: string;
+    prompt: string;
+    description: string;
+    agent: string;
+    status: "discovering" | "active" | "completed" | "failed";
+}
+export interface MessageSummary {
+    role: string;
+    text: string;
+    toolCalls?: string[];
+}
+export interface SubAgentTrackerOptions {
+    serverUrl: string;
+    maxDepth?: number;
+}
+export declare class SubAgentTracker {
+    private readonly serverUrl;
+    private readonly maxDepth;
+    private readonly tracked;
+    constructor(options: SubAgentTrackerOptions);
+    /**
+     * Register a newly-discovered sub-agent and start polling for its child session.
+     * Returns the TrackedSubAgent immediately; status updates asynchronously.
+     */
+    onSubtaskDiscovered(action: SubtaskDiscovered, depth?: number): Promise<TrackedSubAgent>;
+    /**
+     * Poll `GET /session/{parentSessionId}/children` to find the child session.
+     * Retries up to 5 times with exponential backoff: 500ms, 1s, 2s, 4s, 8s.
+     */
+    pollChildSession(parentSessionId: string, retries?: number): Promise<string | null>;
+    /**
+     * Fetch messages from a child session.
+     * GET /session/{childSessionId}/message?limit=N
+     */
+    getChildMessages(childSessionId: string, limit?: number): Promise<MessageSummary[]>;
+    /**
+     * Return all tracked sub-agents with current status.
+     */
+    getTrackedSubAgents(): TrackedSubAgent[];
+    private sleep;
+}
+//# sourceMappingURL=subagent-tracker.d.ts.map

package/dist/streaming/subagent-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-tracker.d.ts","sourceRoot":"","sources":["../../src/streaming/subagent-tracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAM7D,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAaD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,OAAO,EAAE,sBAAsB;IAK3C;;;OAGG;IACG,mBAAmB,CACvB,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,eAAe,CAAC;IAkC3B;;;OAGG;IACG,gBAAgB,CACpB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,MAAoB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8BzB;;;OAGG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC;IA4B5B;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAQxC,OAAO,CAAC,KAAK;CAGd"}

package/dist/streaming/subagent-tracker.js

@@ -0,0 +1,118 @@
+// ═══════════════════════════════════════════
+// Sub-Agent Tracker
+// Tracks sub-agent lifecycle and fetches child session details via REST API polling.
+// ═══════════════════════════════════════════
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_RETRIES = 5;
+const BACKOFF_BASE_MS = 500;
+// ---------------------------------------------------------------------------
+// SubAgentTracker
+// ---------------------------------------------------------------------------
+export class SubAgentTracker {
+    serverUrl;
+    maxDepth;
+    tracked = [];
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.maxDepth = Math.min(options.maxDepth ?? 1, 1);
+    }
+    /**
+     * Register a newly-discovered sub-agent and start polling for its child session.
+     * Returns the TrackedSubAgent immediately; status updates asynchronously.
+     */
+    async onSubtaskDiscovered(action, depth = 1) {
+        if (depth > this.maxDepth) {
+            throw new Error(`Max sub-agent depth is ${this.maxDepth}; requested depth ${depth}`);
+        }
+        const agent = {
+            parentSessionId: action.sessionId,
+            prompt: action.prompt,
+            description: action.description,
+            agent: action.agent,
+            status: "discovering",
+        };
+        this.tracked.push(agent);
+        // Fire-and-forget: poll for child session in background
+        this.pollChildSession(action.sessionId)
+            .then((childSessionId) => {
+            if (childSessionId) {
+                agent.childSessionId = childSessionId;
+                agent.status = "active";
+            }
+            else {
+                agent.status = "failed";
+            }
+        })
+            .catch(() => {
+            agent.status = "failed";
+        });
+        return agent;
+    }
+    /**
+     * Poll `GET /session/{parentSessionId}/children` to find the child session.
+     * Retries up to 5 times with exponential backoff: 500ms, 1s, 2s, 4s, 8s.
+     */
+    async pollChildSession(parentSessionId, retries = MAX_RETRIES) {
+        for (let attempt = 0; attempt < retries; attempt++) {
+            try {
+                const response = await fetch(`${this.serverUrl}/session/${parentSessionId}/children`);
+                if (response.ok) {
+                    const children = (await response.json());
+                    if (children.length > 0) {
+                        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                        return children[children.length - 1].id;
+                    }
+                }
+            }
+            catch {
+                // Network error — will retry
+            }
+            // Don't sleep after the last attempt
+            if (attempt < retries - 1) {
+                const delay = BACKOFF_BASE_MS * Math.pow(2, attempt);
+                await this.sleep(delay);
+            }
+        }
+        return null;
+    }
+    /**
+     * Fetch messages from a child session.
+     * GET /session/{childSessionId}/message?limit=N
+     */
+    async getChildMessages(childSessionId, limit = 20) {
+        try {
+            const response = await fetch(`${this.serverUrl}/session/${childSessionId}/message?limit=${limit}`);
+            if (!response.ok)
+                return [];
+            const messages = (await response.json());
+            return messages.map((msg) => {
+                const summary = {
+                    role: msg.role ?? "unknown",
+                    text: msg.text ?? "",
+                };
+                if (msg.toolCalls && msg.toolCalls.length > 0) {
+                    summary.toolCalls = msg.toolCalls.map((tc) => tc.name ?? "unknown");
+                }
+                return summary;
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Return all tracked sub-agents with current status.
+     */
+    getTrackedSubAgents() {
+        return [...this.tracked];
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=subagent-tracker.js.map