@agentuity/coder 1.0.37

package/dist/footer.js

@@ -0,0 +1,249 @@
+/**
+ * Coder footer for the Pi TUI.
+ *
+ * Uses transparent backgrounds with foreground-only ANSI true-color text.
+ * Includes a braille spinner animation when an agent is actively working.
+ *
+ * Layout:
+ *   [brand] [branch] > [model/agent]        [hub] | [N] label  token-stats
+ *
+ * Observer awareness (ASCII only):
+ *   [3] SwiftRaven — 3 observers watching, session label "SwiftRaven"
+ */
+const RESET = '\x1b[0m';
+const SEP = '>';
+function fg(color, text) {
+    return `\x1b[38;2;${color[0]};${color[1]};${color[2]}m${text}`;
+}
+// ──────────────────────────────────────────────
+// Color palette (foreground only, no backgrounds)
+// ──────────────────────────────────────────────
+const FG_BRAND = [100, 200, 255];
+const FG_MODEL = [215, 135, 175];
+const FG_AGENT = [130, 200, 130];
+const FG_BRANCH = [150, 180, 150];
+const FG_HUB_OK = [80, 200, 120];
+const FG_HUB_WARN = [245, 179, 66];
+const FG_HUB_ERR = [220, 80, 80];
+const FG_DIM = [100, 110, 120];
+const FG_OBSERVER = [140, 180, 220];
+// ──────────────────────────────────────────────
+// Braille spinner
+// ──────────────────────────────────────────────
+const SPINNER_FRAMES = [
+    '\u280B',
+    '\u2819',
+    '\u2839',
+    '\u2838',
+    '\u283C',
+    '\u2834',
+    '\u2826',
+    '\u2827',
+    '\u2807',
+    '\u280F',
+];
+// ──────────────────────────────────────────────
+// Footer builder (transparent bg, foreground only)
+// ──────────────────────────────────────────────
+/** Strip ANSI escape sequences to get visible character count. */
+function visibleLength(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, '').length;
+}
+/** Truncate an ANSI-colored string to a maximum visible width. */
+function truncateAnsi(str, maxWidth) {
+    let visible = 0;
+    let i = 0;
+    while (i < str.length && visible < maxWidth) {
+        if (str[i] === '\x1b') {
+            // Skip entire ANSI escape sequence
+            const end = str.indexOf('m', i);
+            if (end !== -1) {
+                i = end + 1;
+            }
+            else {
+                i++;
+            }
+        }
+        else {
+            visible++;
+            i++;
+        }
+    }
+    return str.slice(0, i) + RESET;
+}
+function buildFooter(left, rightText, width) {
+    // Safety margin for Unicode characters that may be double-width
+    const safeWidth = width - 4;
+    const leftLen = visibleLength(left);
+    const rightLen = visibleLength(rightText);
+    const total = leftLen + 1 + rightLen;
+    if (total > safeWidth) {
+        const maxLeft = safeWidth - rightLen - 1;
+        if (maxLeft > 0) {
+            return truncateAnsi(left, maxLeft) + ' ' + rightText;
+        }
+        return truncateAnsi(left + ' ' + rightText, safeWidth);
+    }
+    const gap = safeWidth - leftLen - rightLen;
+    return left + ' '.repeat(gap) + rightText;
+}
+// ──────────────────────────────────────────────
+// Minimal component
+// ──────────────────────────────────────────────
+class FooterComponent {
+    getText;
+    _unsubscribeBranch;
+    constructor(getText, footerData, cleanupSpinner) {
+        this.getText = getText;
+        this._cleanupSpinner = cleanupSpinner;
+        this._unsubscribeBranch = footerData.onBranchChange(() => {
+            // Triggers TUI refresh
+        });
+    }
+    _cleanupSpinner;
+    render(width) {
+        const text = this.getText(width);
+        // Final safety: ensure line never exceeds terminal width
+        if (visibleLength(text) > width) {
+            return [truncateAnsi(text, width)];
+        }
+        return [text];
+    }
+    invalidate() {
+        // no-op
+    }
+    dispose() {
+        this._unsubscribeBranch?.();
+        this._cleanupSpinner();
+    }
+}
+// ──────────────────────────────────────────────
+// Token stat formatters
+// ──────────────────────────────────────────────
+function formatTokens(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return String(n);
+}
+function formatCost(n) {
+    if (n === 0)
+        return '$0.00';
+    if (n < 0.01)
+        return `$${n.toFixed(4)}`;
+    return `$${n.toFixed(2)}`;
+}
+// ──────────────────────────────────────────────
+// Public API
+// ──────────────────────────────────────────────
+/**
+ * Set up the Coder footer (transparent bg, foreground-colored text).
+ * Call this once with the extension context to replace Pi's default footer.
+ *
+ * Includes a braille spinner animation when an agent is actively working.
+ *
+ * @param ctx  Extension context with UI access
+ * @param getHubStatus  Callback that returns current Hub connection status
+ * @param getObserverState  Optional callback that returns observer count + session label
+ */
+export function setupCoderFooter(ctx, getHubStatus, getObserverState) {
+    if (!ctx.hasUI)
+        return;
+    ctx.ui.setFooter((tui, _theme, footerData) => {
+        // Spinner state
+        let spinnerTimer = null;
+        let spinnerFrame = 0;
+        const getText = (width) => {
+            // Detect active agent
+            const activeAgent = footerData.getExtensionStatuses().get('active_agent');
+            // Start/stop spinner based on agent activity
+            if (activeAgent && !spinnerTimer) {
+                spinnerTimer = setInterval(() => {
+                    spinnerFrame = (spinnerFrame + 1) % SPINNER_FRAMES.length;
+                    tui.requestRender();
+                }, 80);
+            }
+            else if (!activeAgent && spinnerTimer) {
+                clearInterval(spinnerTimer);
+                spinnerTimer = null;
+                spinnerFrame = 0;
+            }
+            // Token stats from session messages
+            let inputTokens = 0;
+            let outputTokens = 0;
+            let totalCost = 0;
+            for (const entry of ctx.sessionManager.getBranch()) {
+                if (entry.type === 'message') {
+                    const msg = entry.message;
+                    if (msg.role === 'assistant' && msg.usage) {
+                        inputTokens += msg.usage.input;
+                        outputTokens += msg.usage.output;
+                        totalCost += msg.usage.cost.total;
+                    }
+                }
+            }
+            const tokenStr = `\u2191${formatTokens(inputTokens)} \u2193${formatTokens(outputTokens)} ${formatCost(totalCost)}`;
+            // LEFT side: brand > branch > model/agent
+            const leftParts = [];
+            // Brand (with spinner)
+            const brandChar = spinnerTimer ? SPINNER_FRAMES[spinnerFrame] : '\u2A3A';
+            leftParts.push(fg(FG_BRAND, ` ${brandChar}`));
+            // Branch
+            const branch = footerData.getGitBranch();
+            if (branch) {
+                leftParts.push('  ');
+                leftParts.push(fg(FG_BRANCH, branch));
+            }
+            // Model or active agent
+            leftParts.push(fg(FG_DIM, ` ${SEP} `));
+            if (activeAgent) {
+                leftParts.push(fg(FG_AGENT, activeAgent));
+            }
+            else {
+                const modelId = ctx.model ? String(ctx.model.id ?? '?') : '?';
+                leftParts.push(fg(FG_MODEL, modelId));
+            }
+            const left = leftParts.join('');
+            // RIGHT side: hub status + observer info + token stats
+            const rightParts = [];
+            const hubStatus = getHubStatus();
+            if (hubStatus === 'connected') {
+                rightParts.push(fg(FG_HUB_OK, 'Hub'));
+            }
+            else if (hubStatus === 'reconnecting') {
+                rightParts.push(fg(FG_HUB_WARN, 'Hub...'));
+            }
+            else {
+                rightParts.push(fg(FG_HUB_ERR, 'Hub Off'));
+            }
+            // Observer awareness (ASCII only, no emojis)
+            if (getObserverState && hubStatus === 'connected') {
+                const obs = getObserverState();
+                if (obs.count > 0 || obs.label) {
+                    rightParts.push(fg(FG_DIM, ' | '));
+                    if (obs.count > 0) {
+                        rightParts.push(fg(FG_OBSERVER, `[${obs.count}]`));
+                        if (obs.label)
+                            rightParts.push(' ');
+                    }
+                    if (obs.label) {
+                        rightParts.push(fg(FG_OBSERVER, obs.label));
+                    }
+                }
+            }
+            rightParts.push(fg(FG_DIM, `  ${tokenStr}`) + RESET);
+            const rightText = rightParts.join('');
+            return buildFooter(left, rightText, width);
+        };
+        const cleanupSpinner = () => {
+            if (spinnerTimer) {
+                clearInterval(spinnerTimer);
+                spinnerTimer = null;
+            }
+        };
+        return new FooterComponent(getText, footerData, cleanupSpinner);
+    });
+}
+//# sourceMappingURL=footer.js.map

package/dist/footer.js.map

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

package/dist/handlers.d.ts

@@ -0,0 +1,24 @@
+import type { HubAction } from './protocol.ts';
+export interface ActionResult {
+    block?: {
+        block: true;
+        reason: string;
+    };
+    returnValue?: unknown;
+    systemPrompt?: string;
+    systemPromptMode?: 'replace' | 'prefix' | 'suffix';
+}
+/** Minimal UI surface used by action handlers — avoids a hard dep on pi-coding-agent. */
+interface ActionContext {
+    ui?: {
+        notify(message: string, level?: 'info' | 'warning' | 'error'): void;
+        confirm(title: string, message: string): Promise<boolean>;
+        setStatus(key: string, text?: string): void;
+    };
+    sendUserMessage?: (message: string, options?: {
+        deliverAs?: 'followUp';
+    }) => void;
+}
+export declare function processActions(actions: HubAction[], ctx: ActionContext): Promise<ActionResult>;
+export {};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAEnD;AAED,yFAAyF;AACzF,UAAU,aAAa;IACtB,EAAE,CAAC,EAAE;QACJ,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;QACpE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5C,CAAC;IACF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,SAAS,EAAE,EACpB,GAAG,EAAE,aAAa,GAChB,OAAO,CAAC,YAAY,CAAC,CAyFvB"}

package/dist/handlers.js

@@ -0,0 +1,83 @@
+export async function processActions(actions, ctx) {
+    let result = {};
+    for (const action of actions) {
+        switch (action.action) {
+            case 'ACK':
+                // Terminal: proceed normally
+                result = {};
+                break;
+            case 'BLOCK':
+                // Terminal: block
+                result = { block: { block: true, reason: action.reason } };
+                break;
+            case 'RETURN':
+                // Terminal: return a specific result
+                result = { returnValue: action.result };
+                break;
+            case 'NOTIFY':
+                // Side effect: show notification, continue
+                if (ctx?.ui) {
+                    ctx.ui.notify(action.message, action.level ?? 'info');
+                }
+                break;
+            case 'STATUS':
+                // Side effect: set status, continue
+                if (ctx?.ui) {
+                    ctx.ui.setStatus(action.key, action.text);
+                }
+                break;
+            case 'CONFIRM': {
+                // Gate: if user denies, stop and block
+                if (ctx?.ui) {
+                    const confirmed = await ctx.ui.confirm(action.title, action.message);
+                    if (!confirmed) {
+                        return {
+                            block: {
+                                block: true,
+                                reason: action.deny_reason ?? 'Denied by user',
+                            },
+                        };
+                    }
+                }
+                else {
+                    // No UI available — block by default for safety
+                    result = {
+                        block: {
+                            block: true,
+                            reason: action.deny_reason ?? 'Confirmation required but no UI available',
+                        },
+                    };
+                }
+                break;
+            }
+            case 'SYSTEM_PROMPT':
+                // System prompt injection — store for before_agent_start handler
+                result = {
+                    ...result,
+                    systemPrompt: action.systemPrompt,
+                    systemPromptMode: action.mode,
+                };
+                break;
+            case 'INJECT_MESSAGE': {
+                const content = action.message?.content?.trim();
+                if (!content)
+                    break;
+                if (action.message?.role === 'user') {
+                    if (ctx.sendUserMessage) {
+                        ctx.sendUserMessage(content, { deliverAs: 'followUp' });
+                    }
+                    else if (ctx.ui) {
+                        ctx.ui.notify(content, 'info');
+                    }
+                    break;
+                }
+                if (ctx.ui) {
+                    ctx.ui.notify(content, 'info');
+                }
+                break;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

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

package/dist/hub-overlay.d.ts

@@ -0,0 +1,107 @@
+import { type Theme } from '@mariozechner/pi-coding-agent';
+interface Component {
+    render(width: number): string[];
+    handleInput?(data: string): void;
+    invalidate(): void;
+}
+interface Focusable {
+    focused: boolean;
+}
+interface TUIRef {
+    requestRender(): void;
+}
+interface HubOverlayOptions {
+    baseUrl: string;
+    currentSessionId?: string;
+    initialSessionId?: string;
+    startInDetail?: boolean;
+    done: (result: undefined) => void;
+}
+export declare class HubOverlay implements Component, Focusable {
+    focused: boolean;
+    private readonly tui;
+    private readonly theme;
+    private readonly done;
+    private readonly baseUrl;
+    private readonly currentSessionId?;
+    private screen;
+    private selectedIndex;
+    private detailSessionId;
+    private detailScrollOffset;
+    private detailMaxScroll;
+    private feedScrollOffset;
+    private feedMaxScroll;
+    private feedScope;
+    private feedViewMode;
+    private showFeedThinking;
+    private feedFollowing;
+    private taskScrollOffset;
+    private taskMaxScroll;
+    private selectedTaskIndex;
+    private showTaskThinking;
+    private taskFollowing;
+    private sessions;
+    private detail;
+    private cachedTodos;
+    private feed;
+    private sessionFeed;
+    private sessionBuffers;
+    private taskBuffers;
+    private hydratedSessions;
+    private previousDigests;
+    private loadingList;
+    private loadingDetail;
+    private listError;
+    private detailError;
+    private lastUpdatedAt;
+    private listInFlight;
+    private detailInFlight;
+    private sseControllers;
+    private disposed;
+    private pollTimer;
+    private mdRenderer;
+    constructor(tui: TUIRef, theme: Theme, options: HubOverlayOptions);
+    handleInput(data: string): void;
+    render(width: number): string[];
+    invalidate(): void;
+    dispose(): void;
+    private requestRender;
+    private close;
+    private handleListInput;
+    private isSessionContext;
+    private handleDetailInput;
+    private handleFeedInput;
+    private handleTaskInput;
+    private getDetailTasks;
+    private getSessionBuffer;
+    private getTaskBuffer;
+    private appendBufferText;
+    private renderMarkdownLines;
+    private renderStreamLines;
+    private buildTopTabs;
+    private fetchJson;
+    private refreshList;
+    private refreshDetail;
+    private updateFeedFromList;
+    private syncSseStreams;
+    private startSseStream;
+    private consumeSseBuffer;
+    private handleSseEvent;
+    private applyHydration;
+    private applyStreamProjection;
+    private captureStreamContent;
+    private formatEventFeedLine;
+    private getSessionLabel;
+    private getFeedEntries;
+    private pushFeed;
+    private pushSessionFeed;
+    private formatStreamLine;
+    private getTaskFeedKey;
+    private renderListScreen;
+    private renderDetailScreen;
+    private renderFeedScreen;
+    private renderTaskScreen;
+    private contentLine;
+}
+export {};
+//# sourceMappingURL=hub-overlay.d.ts.map

package/dist/hub-overlay.d.ts.map

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