@stigmer/ink 0.5.1 → 1.0.1

package/app/SessionApp.d.ts

@@ -11,6 +11,16 @@ export interface SessionAppProps {
     readonly apiKey?: string;
     /** Dynamic token provider for authentication. */
     readonly getAccessToken?: TokenProvider;
+    /**
+     * Default interaction mode for follow-up executions.
+     *
+     * - `"agent"` (default): full tool access.
+     * - `"plan"`: read-only analysis, no file mutations.
+     *
+     * When set, all follow-up executions in this session use this mode
+     * unless overridden by the user.
+     */
+    readonly mode?: "agent" | "plan";
 }
 /**
  * Self-contained top-level Ink application for viewing and
@@ -38,5 +48,5 @@ export interface SessionAppProps {
  * );
  * ```
  */
-export declare function SessionApp({ sessionId, org, baseUrl, apiKey, getAccessToken, }: SessionAppProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionApp({ sessionId, org, baseUrl, apiKey, getAccessToken, mode, }: SessionAppProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SessionApp.d.ts.map

package/app/SessionApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionApp.d.ts","sourceRoot":"","sources":["../../src/app/SessionApp.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,GAAG,EACH,OAAO,EACP,MAAM,EACN,cAAc,GACf,EAAE,eAAe,2CAoBjB"}
+{"version":3,"file":"SessionApp.d.ts","sourceRoot":"","sources":["../../src/app/SessionApp.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,GAAG,EACH,OAAO,EACP,MAAM,EACN,cAAc,EACd,IAAI,GACL,EAAE,eAAe,2CAoBjB"}

package/app/SessionApp.js

@@ -30,9 +30,9 @@ import { SessionView } from "./SessionView.js";
  * );
  * ```
  */
-export function SessionApp({ sessionId, org, baseUrl, apiKey, getAccessToken, }) {
+export function SessionApp({ sessionId, org, baseUrl, apiKey, getAccessToken, mode, }) {
     const clientConfig = { baseUrl, apiKey, getAccessToken };
     const client = React.useMemo(() => createNodeClient(clientConfig), [baseUrl, apiKey, getAccessToken]);
-    return (_jsx(InkStigmerProvider, { client: client, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { paddingLeft: 1, paddingBottom: 1, children: _jsxs(Text, { dimColor: true, children: ["Session ", sessionId, " \u00B7 ", org] }) }), _jsx(SessionView, { sessionId: sessionId, org: org })] }) }));
+    return (_jsx(InkStigmerProvider, { client: client, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { paddingLeft: 1, paddingBottom: 1, children: _jsxs(Text, { dimColor: true, children: ["Session ", sessionId, " \u00B7 ", org] }) }), _jsx(SessionView, { sessionId: sessionId, org: org, mode: mode })] }) }));
 }
 //# sourceMappingURL=SessionApp.js.map

package/app/SessionApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionApp.js","sourceRoot":"","sources":["../../src/app/SessionApp.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAyB,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgB/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,SAAS,EACT,GAAG,EACH,OAAO,EACP,MAAM,EACN,cAAc,GACE;IAChB,MAAM,YAAY,GAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAE3E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAC1B,GAAG,EAAE,CAAC,gBAAgB,CAAC,YAAY,CAAC,EACpC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAClC,CAAC;IAEF,OAAO,CACL,KAAC,kBAAkB,IAAC,MAAM,EAAE,MAAM,YAChC,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,YACnC,MAAC,IAAI,IAAC,QAAQ,+BACH,SAAS,cAAK,GAAG,IACrB,GACH,EACN,KAAC,WAAW,IAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,GAAI,IAC3C,GACa,CACtB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"SessionApp.js","sourceRoot":"","sources":["../../src/app/SessionApp.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAyB,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA0B/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,SAAS,EACT,GAAG,EACH,OAAO,EACP,MAAM,EACN,cAAc,EACd,IAAI,GACY;IAChB,MAAM,YAAY,GAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAE3E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAC1B,GAAG,EAAE,CAAC,gBAAgB,CAAC,YAAY,CAAC,EACpC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAClC,CAAC;IAEF,OAAO,CACL,KAAC,kBAAkB,IAAC,MAAM,EAAE,MAAM,YAChC,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,YACnC,MAAC,IAAI,IAAC,QAAQ,+BACH,SAAS,cAAK,GAAG,IACrB,GACH,EACN,KAAC,WAAW,IAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAI,IACvD,GACa,CACtB,CAAC;AACJ,CAAC"}

package/app/SessionView.d.ts

@@ -1,9 +1,22 @@
+/** Interaction mode type used for follow-up executions. */
+export type InteractionMode = "agent" | "plan";
 /** Props for {@link SessionView}. */
 export interface SessionViewProps {
     /** Session ID to display and converse in. */
     readonly sessionId: string;
     /** Organization slug for creating follow-up executions. */
     readonly org: string;
+    /**
+     * Initial interaction mode for follow-up executions.
+     *
+     * - `"agent"` (default): full tool access.
+     * - `"plan"`: read-only analysis, no file mutations.
+     *
+     * The user can toggle between modes with Ctrl+T during the session.
+     * This prop sets the initial value; subsequent toggles are managed
+     * as local state.
+     */
+    readonly mode?: InteractionMode;
 }
 /**
  * Full-featured session conversation view for the terminal.
@@ -28,5 +41,5 @@ export interface SessionViewProps {
  * );
  * ```
  */
-export declare function SessionView({ sessionId, org }: SessionViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionView({ sessionId, org, mode }: SessionViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SessionView.d.ts.map

package/app/SessionView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionView.d.ts","sourceRoot":"","sources":["../../src/app/SessionView.tsx"],"names":[],"mappings":"AAUA,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,gBAAgB,2CA0H/D"}
+{"version":3,"file":"SessionView.d.ts","sourceRoot":"","sources":["../../src/app/SessionView.tsx"],"names":[],"mappings":"AAWA,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,gBAAgB,2CAuIrE"}

package/app/SessionView.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useState, useEffect } from "react";
 import { Box, Text, useInput } from "ink";
 import Spinner from "ink-spinner";
 import { useSessionConversation, resolvedSubject, PENDING_SUBJECT } from "@stigmer/react";
@@ -7,6 +7,7 @@ import { MessageThread } from "../components/MessageThread.js";
 import { TodoList } from "../components/TodoList.js";
 import { FollowUpInput } from "../components/FollowUpInput.js";
 import { UsageWidget } from "../components/UsageWidget.js";
+import { ContextGauge } from "../components/ContextGauge.js";
 import { ExecutionProgress } from "../components/ExecutionProgress.js";
 /**
  * Full-featured session conversation view for the terminal.
@@ -31,13 +32,21 @@ import { ExecutionProgress } from "../components/ExecutionProgress.js";
  * );
  * ```
  */
-export function SessionView({ sessionId, org }) {
+export function SessionView({ sessionId, org, mode }) {
     const conv = useSessionConversation(sessionId, org);
     const [expandTools, setExpandTools] = useState(false);
+    const [activeMode, setActiveMode] = useState(mode ?? "agent");
+    useEffect(() => {
+        if (mode)
+            setActiveMode(mode);
+    }, [mode]);
     useInput((input, key) => {
         if (key.ctrl && input === "o") {
             setExpandTools((e) => !e);
         }
+        if (key.ctrl && input === "t") {
+            setActiveMode((m) => (m === "plan" ? "agent" : "plan"));
+        }
     });
     if (conv.isLoading) {
         return (_jsxs(Box, { gap: 1, paddingLeft: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: "Loading session..." })] }));
@@ -50,9 +59,9 @@ export function SessionView({ sessionId, org }) {
         ...(conv.activeStreamExecution ? [conv.activeStreamExecution] : []),
     ];
     const activeTodos = conv.activeStreamExecution?.status?.todos;
-    const contextInfo = conv.activeStreamExecution?.status?.contextInfo;
-    const summarizationCount = contextInfo?.summarizationEvents?.length ?? 0;
     const subject = resolvedSubject(conv.session?.spec?.subject);
-    return (_jsxs(Box, { flexDirection: "column", children: [subject && subject !== PENDING_SUBJECT && (_jsx(Box, { paddingLeft: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, bold: true, children: subject }) })), conv.isConnecting && (_jsxs(Box, { gap: 1, paddingLeft: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: "Connecting to stream..." })] })), conv.streamError && (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "yellow", bold: true, children: "Stream disconnected" }), _jsx(Text, { dimColor: true, children: "\u2014 reconnecting..." })] }), _jsx(Text, { color: "red", dimColor: true, children: conv.streamError.message })] })), conv.activePhase != null && conv.activePhase !== 0 && (_jsx(ExecutionProgress, { phase: conv.activePhase })), _jsx(MessageThread, { executions: conv.completedExecutions, activeStreamExecution: conv.activeStreamExecution, pendingUserMessage: conv.pendingUserMessage, onApprovalSubmit: conv.submitApproval, submittingApprovalIds: conv.submittingApprovalIds, expandToolCalls: expandTools }), summarizationCount > 0 && (_jsx(Box, { paddingLeft: 1, marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["Context compacted (", summarizationCount, " ", summarizationCount === 1 ? "event" : "events", ", ", Math.round(contextInfo.utilizationPercent), "% utilization)"] }) })), activeTodos && Object.keys(activeTodos).length > 0 && (_jsx(Box, { marginTop: 1, paddingLeft: 1, children: _jsx(TodoList, { todos: activeTodos }) })), conv.approvalError && (_jsx(Box, { paddingLeft: 1, children: _jsxs(Text, { color: "red", children: ["Approval error: ", conv.approvalError.message] }) })), conv.sendError && (_jsx(Box, { paddingLeft: 1, children: _jsxs(Text, { color: "red", children: ["Send error: ", conv.sendError.message] }) })), _jsx(UsageWidget, { executions: allExecutions }), _jsx(FollowUpInput, { onSubmit: (message) => conv.sendFollowUp(message), isSubmitting: conv.isSending, disabled: !conv.canSendFollowUp })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [subject && subject !== PENDING_SUBJECT && (_jsx(Box, { paddingLeft: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, bold: true, children: subject }) })), conv.isConnecting && (_jsxs(Box, { gap: 1, paddingLeft: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: "Connecting to stream..." })] })), conv.streamError && (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "yellow", bold: true, children: "Stream disconnected" }), _jsx(Text, { dimColor: true, children: "\u2014 reconnecting..." })] }), _jsx(Text, { color: "red", dimColor: true, children: conv.streamError.message })] })), conv.activePhase != null && conv.activePhase !== 0 && (_jsx(ExecutionProgress, { phase: conv.activePhase })), _jsx(MessageThread, { executions: conv.completedExecutions, activeStreamExecution: conv.activeStreamExecution, pendingUserMessage: conv.pendingUserMessage, onApprovalSubmit: conv.submitApproval, submittingApprovalIds: conv.submittingApprovalIds, expandToolCalls: expandTools }), activeTodos && Object.keys(activeTodos).length > 0 && (_jsx(Box, { marginTop: 1, paddingLeft: 1, children: _jsx(TodoList, { todos: activeTodos }) })), conv.approvalError && (_jsx(Box, { paddingLeft: 1, children: _jsxs(Text, { color: "red", children: ["Approval error: ", conv.approvalError.message] }) })), conv.sendError && (_jsx(Box, { paddingLeft: 1, children: _jsxs(Text, { color: "red", children: ["Send error: ", conv.sendError.message] }) })), _jsx(UsageWidget, { executions: allExecutions }), _jsx(ContextGauge, { execution: conv.activeStreamExecution ?? null }), conv.canSendFollowUp && (_jsx(Box, { paddingLeft: 1, children: _jsx(Text, { color: activeMode === "plan" ? "yellow" : "cyan", dimColor: true, children: activeMode === "plan"
+                        ? "Plan mode — read-only analysis, no file mutations"
+                        : "Agent mode — full tool access" }) })), _jsx(FollowUpInput, { onSubmit: (message) => conv.sendFollowUp(message, { interactionMode: activeMode }), isSubmitting: conv.isSending, disabled: !conv.canSendFollowUp, mode: activeMode })] }));
 }
 //# sourceMappingURL=SessionView.js.map

package/app/SessionView.js.map

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

package/cli/stigmer-ink.js

@@ -24,6 +24,16 @@ function parseArgs(argv) {
             case "-k":
                 config.apiKey = args[++i];
                 break;
+            case "--mode":
+            case "-M": {
+                const value = args[++i];
+                if (value !== "agent" && value !== "plan") {
+                    console.error(`Invalid --mode value "${value}": must be "agent" or "plan"`);
+                    process.exit(1);
+                }
+                config.mode = value;
+                break;
+            }
             case "--help":
             case "-h":
                 printUsage();
@@ -80,6 +90,7 @@ Options:
   -o, --org <slug>      Organization slug (required)
   -u, --base-url <url>  Stigmer API URL (or STIGMER_BASE_URL env)
   -k, --api-key <key>   API key (or STIGMER_API_KEY env)
+  -M, --mode <mode>     Interaction mode for follow-ups: "agent" or "plan"
   -h, --help            Show this help message
 
 Environment:
@@ -101,7 +112,7 @@ async function main() {
     const stdin = isTTY
         ? process.stdin
         : new Readable({ read() { } });
-    const instance = render(_jsx(SessionApp, { sessionId: config.sessionId, org: config.org, baseUrl: config.baseUrl, apiKey: config.apiKey }), { stdin, exitOnCtrlC: isTTY, debug: !isTTY });
+    const instance = render(_jsx(SessionApp, { sessionId: config.sessionId, org: config.org, baseUrl: config.baseUrl, apiKey: config.apiKey, mode: config.mode }), { stdin, exitOnCtrlC: isTTY, debug: !isTTY });
     const cleanup = () => {
         instance.unmount();
         process.exit(0);

package/cli/stigmer-ink.js.map

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

package/components/ContextGauge.d.ts

@@ -0,0 +1,26 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/** Props for {@link ContextGauge}. */
+export interface ContextGaugeProps {
+    /**
+     * The execution snapshot from the active stream, or `null`.
+     * The gauge extracts `context_info` from the execution status.
+     */
+    readonly execution: AgentExecution | null;
+}
+/**
+ * Terminal-native context window utilization gauge.
+ *
+ * Renders an ASCII progress bar with health-based coloring, token counts,
+ * and summarization event details. Uses the headless
+ * {@link useContextWindow} hook from `@stigmer/react`.
+ *
+ * Returns `null` when `ContextInfo` is absent (e.g., Cursor harness
+ * where context is managed externally).
+ *
+ * @example
+ * ```tsx
+ * <ContextGauge execution={activeStreamExecution} />
+ * ```
+ */
+export declare function ContextGauge({ execution }: ContextGaugeProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=ContextGauge.d.ts.map

package/components/ContextGauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGauge.d.ts","sourceRoot":"","sources":["../../src/components/ContextGauge.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAOlG,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;CAC3C;AA0BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,iBAAiB,kDA4C5D"}

package/components/ContextGauge.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { useContextWindow, } from "@stigmer/react";
+const BAR_WIDTH = 20;
+const HEALTH_COLORS = {
+    healthy: "green",
+    warning: "yellow",
+    critical: "red",
+};
+const HEALTH_LABELS = {
+    warning: "Approaching limit",
+    critical: "Near limit",
+};
+function formatCompactTokens(count) {
+    if (count >= 1_000_000)
+        return `${(count / 1_000_000).toFixed(1)}M`;
+    if (count >= 1_000)
+        return `${Math.round(count / 1_000)}K`;
+    return String(count);
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/**
+ * Terminal-native context window utilization gauge.
+ *
+ * Renders an ASCII progress bar with health-based coloring, token counts,
+ * and summarization event details. Uses the headless
+ * {@link useContextWindow} hook from `@stigmer/react`.
+ *
+ * Returns `null` when `ContextInfo` is absent (e.g., Cursor harness
+ * where context is managed externally).
+ *
+ * @example
+ * ```tsx
+ * <ContextGauge execution={activeStreamExecution} />
+ * ```
+ */
+export function ContextGauge({ execution }) {
+    const ctx = useContextWindow(execution);
+    if (!ctx.hasContextInfo)
+        return null;
+    const filled = Math.round((Math.min(ctx.utilizationPercent, 100) / 100) * BAR_WIDTH);
+    const empty = BAR_WIDTH - filled;
+    const bar = "█".repeat(filled) + "░".repeat(empty);
+    const color = HEALTH_COLORS[ctx.health];
+    const healthLabel = HEALTH_LABELS[ctx.health];
+    const eventCount = ctx.summarizationEvents.length;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "Context" }), _jsx(Text, { color: color, children: bar }), _jsxs(Text, { color: color, children: [Math.round(ctx.utilizationPercent), "%"] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsxs(Text, { dimColor: true, children: [formatCompactTokens(ctx.currentTokenCount), " /", " ", formatCompactTokens(ctx.contextWindowLimit), " tokens"] }), healthLabel && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: color, children: healthLabel })] })), eventCount > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsxs(Text, { dimColor: true, children: [eventCount, " ", eventCount === 1 ? "compaction" : "compactions"] })] }))] }), eventCount > 0 && (_jsx(LatestEvent, { event: ctx.summarizationEvents[eventCount - 1] }))] }));
+}
+function LatestEvent({ event }) {
+    const reduction = Math.round(event.compressionRatio * 100);
+    return (_jsx(Box, { paddingLeft: 2, children: _jsxs(Text, { dimColor: true, children: [formatCompactTokens(event.tokensBefore), " \u2192", " ", formatCompactTokens(event.tokensAfter), " tokens (", reduction, "% reduction)", event.model ? ` · ${event.model}` : "", event.durationMs > 0 ? ` · ${formatDuration(event.durationMs)}` : "", event.costUsd > 0
+                    ? ` · $${event.costUsd < 0.01 ? event.costUsd.toFixed(4) : event.costUsd.toFixed(2)}`
+                    : ""] }) }));
+}
+//# sourceMappingURL=ContextGauge.js.map

package/components/ContextGauge.js.map

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

package/components/FollowUpInput.d.ts

@@ -8,6 +8,8 @@ export interface FollowUpInputProps {
     readonly disabled?: boolean;
     /** Placeholder text. Default: "Reply..." */
     readonly placeholder?: string;
+    /** Current interaction mode. Shown in the shortcut hint line. */
+    readonly mode?: "agent" | "plan";
 }
 /**
  * Terminal text input for sending follow-up messages in a session.
@@ -15,5 +17,5 @@ export interface FollowUpInputProps {
  * Renders a single-line text input with a submit hint. Press Enter
  * to submit, Ctrl+C to exit the application.
  */
-export declare function FollowUpInput({ onSubmit, isSubmitting, disabled, placeholder, }: FollowUpInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function FollowUpInput({ onSubmit, isSubmitting, disabled, placeholder, mode, }: FollowUpInputProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=FollowUpInput.d.ts.map

package/components/FollowUpInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FollowUpInput.d.ts","sourceRoot":"","sources":["../../src/components/FollowUpInput.tsx"],"names":[],"mappings":"AAIA,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAoB,EACpB,QAAgB,EAChB,WAAwB,GACzB,EAAE,kBAAkB,2CA0CpB"}
+{"version":3,"file":"FollowUpInput.d.ts","sourceRoot":"","sources":["../../src/components/FollowUpInput.tsx"],"names":[],"mappings":"AAIA,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAoB,EACpB,QAAgB,EAChB,WAAwB,EACxB,IAAI,GACL,EAAE,kBAAkB,2CA0CpB"}

package/components/FollowUpInput.js

@@ -8,7 +8,7 @@ import TextInput from "ink-text-input";
  * Renders a single-line text input with a submit hint. Press Enter
  * to submit, Ctrl+C to exit the application.
  */
-export function FollowUpInput({ onSubmit, isSubmitting = false, disabled = false, placeholder = "Reply...", }) {
+export function FollowUpInput({ onSubmit, isSubmitting = false, disabled = false, placeholder = "Reply...", mode, }) {
     const [value, setValue] = useState("");
     const { isRawModeSupported } = useStdin();
     const isDisabled = disabled || isSubmitting || !isRawModeSupported;
@@ -22,6 +22,6 @@ export function FollowUpInput({ onSubmit, isSubmitting = false, disabled = false
     if (isDisabled) {
         return (_jsx(Box, { paddingLeft: 1, paddingTop: 1, children: _jsx(Text, { dimColor: true, children: isSubmitting ? "Sending..." : placeholder }) }));
     }
-    return (_jsxs(Box, { paddingLeft: 1, paddingTop: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "\u276F" }), _jsx(TextInput, { value: value, onChange: setValue, onSubmit: handleSubmit, placeholder: placeholder })] }), _jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, children: "Enter to send \u00B7 Ctrl+C to exit" }) })] }));
+    return (_jsxs(Box, { paddingLeft: 1, paddingTop: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "\u276F" }), _jsx(TextInput, { value: value, onChange: setValue, onSubmit: handleSubmit, placeholder: placeholder })] }), _jsx(Box, { paddingLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["Enter to send \u00B7 Ctrl+T ", mode === "plan" ? "agent" : "plan", " mode \u00B7 Ctrl+C exit"] }) })] }));
 }
 //# sourceMappingURL=FollowUpInput.js.map

package/components/FollowUpInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"FollowUpInput.js","sourceRoot":"","sources":["../../src/components/FollowUpInput.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAcvC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAY,GAAG,KAAK,EACpB,QAAQ,GAAG,KAAK,EAChB,WAAW,GAAG,UAAU,GACL;IACnB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,kBAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,IAAI,YAAY,IAAI,CAAC,kBAAkB,CAAC;IAEnE,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClB,QAAQ,CAAC,EAAE,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CACL,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,YAChC,KAAC,IAAI,IAAC,QAAQ,kBACX,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,GACrC,GACH,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,MAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACxD,MAAC,GAAG,IAAC,GAAG,EAAE,CAAC,aACT,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,6BAEhB,EACP,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,GACxB,IACE,EACN,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,YACjB,KAAC,IAAI,IAAC,QAAQ,0DAEP,GACH,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"FollowUpInput.js","sourceRoot":"","sources":["../../src/components/FollowUpInput.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAgBvC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAY,GAAG,KAAK,EACpB,QAAQ,GAAG,KAAK,EAChB,WAAW,GAAG,UAAU,EACxB,IAAI,GACe;IACnB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,kBAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,IAAI,YAAY,IAAI,CAAC,kBAAkB,CAAC;IAEnE,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClB,QAAQ,CAAC,EAAE,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CACL,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,YAChC,KAAC,IAAI,IAAC,QAAQ,kBACX,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,GACrC,GACH,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,MAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACxD,MAAC,GAAG,IAAC,GAAG,EAAE,CAAC,aACT,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,6BAEhB,EACP,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,GACxB,IACE,EACN,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,YACjB,MAAC,IAAI,IAAC,QAAQ,mDACY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,gCACrD,GACH,IACF,CACP,CAAC;AACJ,CAAC"}

package/index.d.ts

@@ -11,6 +11,7 @@ export { ApprovalPrompt, type ApprovalPromptProps } from "./components/ApprovalP
 export { ExecutionProgress, type ExecutionProgressProps } from "./components/ExecutionProgress.js";
 export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";
-export { SessionView, type SessionViewProps } from "./app/SessionView.js";
+export { ContextGauge, type ContextGaugeProps } from "./components/ContextGauge.js";
+export { SessionView, type SessionViewProps, type InteractionMode } from "./app/SessionView.js";
 export { SessionApp, type SessionAppProps } from "./app/SessionApp.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/index.js

@@ -15,6 +15,7 @@ export { ApprovalPrompt } from "./components/ApprovalPrompt.js";
 export { ExecutionProgress } from "./components/ExecutionProgress.js";
 export { FollowUpInput } from "./components/FollowUpInput.js";
 export { UsageWidget } from "./components/UsageWidget.js";
+export { ContextGauge } from "./components/ContextGauge.js";
 // Composed views
 export { SessionView } from "./app/SessionView.js";
 export { SessionApp } from "./app/SessionApp.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AAEjF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAyB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/ink",
-  "version": "0.5.1",
+  "version": "1.0.1",
   "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
   "license": "Apache-2.0",
   "type": "module",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@connectrpc/connect-node": "^2.1.1",
-    "@stigmer/react": "0.5.1",
+    "@stigmer/react": "1.0.1",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "marked": "^15.0.7",
@@ -40,8 +40,8 @@
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "0.5.1",
-    "@stigmer/sdk": "0.5.1",
+    "@stigmer/protos": "1.0.1",
+    "@stigmer/sdk": "1.0.1",
     "ink": "^7.0.0",
     "react": ">=19.0.0"
   }

package/src/__tests__/context-gauge.test.tsx

@@ -0,0 +1,176 @@
+import React from "react";
+import { describe, it, expect } from "vitest";
+import { render } from "ink-testing-library";
+import { create } from "@bufbuild/protobuf";
+import {
+  AgentExecutionSchema,
+  AgentExecutionStatusSchema,
+  type AgentExecution,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import {
+  ContextInfoSchema,
+  SummarizationEventSchema,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/context_pb";
+import { ContextGauge } from "../components/ContextGauge.js";
+
+function makeExecution(overrides?: {
+  currentTokenCount?: number;
+  contextWindowLimit?: number;
+  utilizationPercent?: number;
+}): AgentExecution {
+  const exec = create(AgentExecutionSchema);
+  const status = create(AgentExecutionStatusSchema);
+  const contextInfo = create(ContextInfoSchema);
+
+  contextInfo.currentTokenCount = overrides?.currentTokenCount ?? 10_000;
+  contextInfo.contextWindowLimit = overrides?.contextWindowLimit ?? 128_000;
+  contextInfo.summarizationTriggerThreshold = 115_200;
+  contextInfo.summarizationTargetTokens = 102_400;
+  contextInfo.summarizationEnabled = true;
+  contextInfo.utilizationPercent = overrides?.utilizationPercent ?? 5;
+
+  status.contextInfo = contextInfo;
+  exec.status = status;
+  return exec;
+}
+
+function addSummarizationEvent(
+  exec: AgentExecution,
+  overrides?: {
+    tokensBefore?: number;
+    tokensAfter?: number;
+    compressionRatio?: number;
+    durationMs?: number;
+    model?: string;
+    costUsd?: number;
+  },
+): void {
+  const event = create(SummarizationEventSchema);
+  event.timestamp = "2026-05-17T10:30:00.000Z";
+  event.tokensBefore = overrides?.tokensBefore ?? 120_000;
+  event.tokensAfter = overrides?.tokensAfter ?? 82_000;
+  event.compressionRatio = overrides?.compressionRatio ?? 0.32;
+  event.durationMs = overrides?.durationMs ?? 2100;
+  event.summarizationModel = overrides?.model ?? "claude-haiku-4";
+  event.messagesBefore = 30;
+  event.messagesAfter = 10;
+  event.summarizationCostUsd = overrides?.costUsd ?? 0.02;
+
+  exec.status!.contextInfo!.summarizationEvents.push(event);
+}
+
+describe("ContextGauge", () => {
+  it("renders nothing when execution is null", () => {
+    const { lastFrame } = render(<ContextGauge execution={null} />);
+    expect(lastFrame()).toBe("");
+  });
+
+  it("renders nothing when contextInfo is absent", () => {
+    const exec = create(AgentExecutionSchema);
+    exec.status = create(AgentExecutionStatusSchema);
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    expect(lastFrame()).toBe("");
+  });
+
+  it("renders healthy gauge with green bar and no health label", () => {
+    const exec = makeExecution({
+      currentTokenCount: 51_200,
+      contextWindowLimit: 128_000,
+      utilizationPercent: 40,
+    });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("Context");
+    expect(output).toContain("40%");
+    expect(output).toContain("51K / 128K tokens");
+    expect(output).not.toContain("Approaching limit");
+    expect(output).not.toContain("Near limit");
+  });
+
+  it("renders warning gauge with health label", () => {
+    const exec = makeExecution({
+      currentTokenCount: 96_000,
+      contextWindowLimit: 128_000,
+      utilizationPercent: 75,
+    });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("75%");
+    expect(output).toContain("96K / 128K tokens");
+    expect(output).toContain("Approaching limit");
+  });
+
+  it("renders critical gauge with health label", () => {
+    const exec = makeExecution({
+      currentTokenCount: 118_000,
+      contextWindowLimit: 128_000,
+      utilizationPercent: 92,
+    });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("92%");
+    expect(output).toContain("118K / 128K tokens");
+    expect(output).toContain("Near limit");
+  });
+
+  it("shows correct token formatting for large counts", () => {
+    const exec = makeExecution({
+      currentTokenCount: 1_500_000,
+      contextWindowLimit: 2_000_000,
+      utilizationPercent: 75,
+    });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("1.5M / 2.0M tokens");
+  });
+
+  it("shows summarization count and latest event details", () => {
+    const exec = makeExecution({
+      currentTokenCount: 82_000,
+      contextWindowLimit: 128_000,
+      utilizationPercent: 64,
+    });
+    addSummarizationEvent(exec, {
+      tokensBefore: 120_000,
+      tokensAfter: 82_000,
+      compressionRatio: 0.32,
+      durationMs: 2100,
+      model: "claude-haiku-4",
+      costUsd: 0.02,
+    });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("1 compaction");
+    expect(output).toContain("120K → 82K tokens (32% reduction)");
+    expect(output).toContain("claude-haiku-4");
+    expect(output).toContain("2.1s");
+    expect(output).toContain("$0.02");
+  });
+
+  it("shows plural compaction count for multiple events", () => {
+    const exec = makeExecution({
+      currentTokenCount: 60_000,
+      contextWindowLimit: 128_000,
+      utilizationPercent: 47,
+    });
+    addSummarizationEvent(exec, { tokensBefore: 120_000, tokensAfter: 90_000 });
+    addSummarizationEvent(exec, { tokensBefore: 110_000, tokensAfter: 70_000 });
+    addSummarizationEvent(exec, { tokensBefore: 100_000, tokensAfter: 60_000 });
+
+    const { lastFrame } = render(<ContextGauge execution={exec} />);
+    const output = lastFrame() ?? "";
+
+    expect(output).toContain("3 compactions");
+  });
+});

package/src/app/SessionApp.tsx

@@ -17,6 +17,16 @@ export interface SessionAppProps {
   readonly apiKey?: string;
   /** Dynamic token provider for authentication. */
   readonly getAccessToken?: TokenProvider;
+  /**
+   * Default interaction mode for follow-up executions.
+   *
+   * - `"agent"` (default): full tool access.
+   * - `"plan"`: read-only analysis, no file mutations.
+   *
+   * When set, all follow-up executions in this session use this mode
+   * unless overridden by the user.
+   */
+  readonly mode?: "agent" | "plan";
 }
 
 /**
@@ -51,6 +61,7 @@ export function SessionApp({
   baseUrl,
   apiKey,
   getAccessToken,
+  mode,
 }: SessionAppProps) {
   const clientConfig: NodeClientConfig = { baseUrl, apiKey, getAccessToken };
 
@@ -67,7 +78,7 @@ export function SessionApp({
             Session {sessionId} · {org}
           </Text>
         </Box>
-        <SessionView sessionId={sessionId} org={org} />
+        <SessionView sessionId={sessionId} org={org} mode={mode} />
       </Box>
     </InkStigmerProvider>
   );

package/src/app/SessionView.tsx

@@ -1,4 +1,4 @@
-import React, { useState } from "react";
+import React, { useState, useEffect } from "react";
 import { Box, Text, useInput } from "ink";
 import Spinner from "ink-spinner";
 import { useSessionConversation, resolvedSubject, PENDING_SUBJECT } from "@stigmer/react";
@@ -6,14 +6,29 @@ import { MessageThread } from "../components/MessageThread.js";
 import { TodoList } from "../components/TodoList.js";
 import { FollowUpInput } from "../components/FollowUpInput.js";
 import { UsageWidget } from "../components/UsageWidget.js";
+import { ContextGauge } from "../components/ContextGauge.js";
 import { ExecutionProgress } from "../components/ExecutionProgress.js";
 
+/** Interaction mode type used for follow-up executions. */
+export type InteractionMode = "agent" | "plan";
+
 /** Props for {@link SessionView}. */
 export interface SessionViewProps {
   /** Session ID to display and converse in. */
   readonly sessionId: string;
   /** Organization slug for creating follow-up executions. */
   readonly org: string;
+  /**
+   * Initial interaction mode for follow-up executions.
+   *
+   * - `"agent"` (default): full tool access.
+   * - `"plan"`: read-only analysis, no file mutations.
+   *
+   * The user can toggle between modes with Ctrl+T during the session.
+   * This prop sets the initial value; subsequent toggles are managed
+   * as local state.
+   */
+  readonly mode?: InteractionMode;
 }
 
 /**
@@ -39,14 +54,22 @@ export interface SessionViewProps {
  * );
  * ```
  */
-export function SessionView({ sessionId, org }: SessionViewProps) {
+export function SessionView({ sessionId, org, mode }: SessionViewProps) {
   const conv = useSessionConversation(sessionId, org);
   const [expandTools, setExpandTools] = useState(false);
+  const [activeMode, setActiveMode] = useState<InteractionMode>(mode ?? "agent");
+
+  useEffect(() => {
+    if (mode) setActiveMode(mode);
+  }, [mode]);
 
   useInput((input, key) => {
     if (key.ctrl && input === "o") {
       setExpandTools((e) => !e);
     }
+    if (key.ctrl && input === "t") {
+      setActiveMode((m) => (m === "plan" ? "agent" : "plan"));
+    }
   });
 
   if (conv.isLoading) {
@@ -77,8 +100,6 @@ export function SessionView({ sessionId, org }: SessionViewProps) {
   ];
 
   const activeTodos = conv.activeStreamExecution?.status?.todos;
-  const contextInfo = conv.activeStreamExecution?.status?.contextInfo;
-  const summarizationCount = contextInfo?.summarizationEvents?.length ?? 0;
 
   const subject = resolvedSubject(conv.session?.spec?.subject);
 
@@ -122,14 +143,6 @@ export function SessionView({ sessionId, org }: SessionViewProps) {
         expandToolCalls={expandTools}
       />
 
-      {summarizationCount > 0 && (
-        <Box paddingLeft={1} marginTop={1}>
-          <Text dimColor>
-            Context compacted ({summarizationCount} {summarizationCount === 1 ? "event" : "events"}, {Math.round(contextInfo!.utilizationPercent)}% utilization)
-          </Text>
-        </Box>
-      )}
-
       {activeTodos && Object.keys(activeTodos).length > 0 && (
         <Box marginTop={1} paddingLeft={1}>
           <TodoList todos={activeTodos} />
@@ -154,10 +167,25 @@ export function SessionView({ sessionId, org }: SessionViewProps) {
 
       <UsageWidget executions={allExecutions} />
 
+      <ContextGauge execution={conv.activeStreamExecution ?? null} />
+
+      {conv.canSendFollowUp && (
+        <Box paddingLeft={1}>
+          <Text color={activeMode === "plan" ? "yellow" : "cyan"} dimColor>
+            {activeMode === "plan"
+              ? "Plan mode — read-only analysis, no file mutations"
+              : "Agent mode — full tool access"}
+          </Text>
+        </Box>
+      )}
+
       <FollowUpInput
-        onSubmit={(message) => conv.sendFollowUp(message)}
+        onSubmit={(message) =>
+          conv.sendFollowUp(message, { interactionMode: activeMode })
+        }
         isSubmitting={conv.isSending}
         disabled={!conv.canSendFollowUp}
+        mode={activeMode}
       />
     </Box>
   );

package/src/cli/stigmer-ink.tsx

@@ -10,6 +10,7 @@ interface CliConfig {
   org: string;
   baseUrl: string;
   apiKey?: string;
+  mode?: "agent" | "plan";
 }
 
 function parseArgs(argv: string[]): CliConfig | null {
@@ -34,6 +35,16 @@ function parseArgs(argv: string[]): CliConfig | null {
       case "-k":
         config.apiKey = args[++i];
         break;
+      case "--mode":
+      case "-M": {
+        const value = args[++i];
+        if (value !== "agent" && value !== "plan") {
+          console.error(`Invalid --mode value "${value}": must be "agent" or "plan"`);
+          process.exit(1);
+        }
+        config.mode = value;
+        break;
+      }
       case "--help":
       case "-h":
         printUsage();
@@ -93,6 +104,7 @@ Options:
   -o, --org <slug>      Organization slug (required)
   -u, --base-url <url>  Stigmer API URL (or STIGMER_BASE_URL env)
   -k, --api-key <key>   API key (or STIGMER_API_KEY env)
+  -M, --mode <mode>     Interaction mode for follow-ups: "agent" or "plan"
   -h, --help            Show this help message
 
 Environment:
@@ -127,6 +139,7 @@ async function main() {
       org={config.org}
       baseUrl={config.baseUrl}
       apiKey={config.apiKey}
+      mode={config.mode}
     />,
     { stdin, exitOnCtrlC: isTTY, debug: !isTTY },
   );

package/src/components/ContextGauge.tsx

@@ -0,0 +1,120 @@
+import React from "react";
+import { Box, Text } from "ink";
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import {
+  useContextWindow,
+  type ContextHealth,
+  type SummarizationEventView,
+} from "@stigmer/react";
+
+/** Props for {@link ContextGauge}. */
+export interface ContextGaugeProps {
+  /**
+   * The execution snapshot from the active stream, or `null`.
+   * The gauge extracts `context_info` from the execution status.
+   */
+  readonly execution: AgentExecution | null;
+}
+
+const BAR_WIDTH = 20;
+
+const HEALTH_COLORS: Record<ContextHealth, string> = {
+  healthy: "green",
+  warning: "yellow",
+  critical: "red",
+};
+
+const HEALTH_LABELS: Partial<Record<ContextHealth, string>> = {
+  warning: "Approaching limit",
+  critical: "Near limit",
+};
+
+function formatCompactTokens(count: number): string {
+  if (count >= 1_000_000) return `${(count / 1_000_000).toFixed(1)}M`;
+  if (count >= 1_000) return `${Math.round(count / 1_000)}K`;
+  return String(count);
+}
+
+function formatDuration(ms: number): string {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+
+/**
+ * Terminal-native context window utilization gauge.
+ *
+ * Renders an ASCII progress bar with health-based coloring, token counts,
+ * and summarization event details. Uses the headless
+ * {@link useContextWindow} hook from `@stigmer/react`.
+ *
+ * Returns `null` when `ContextInfo` is absent (e.g., Cursor harness
+ * where context is managed externally).
+ *
+ * @example
+ * ```tsx
+ * <ContextGauge execution={activeStreamExecution} />
+ * ```
+ */
+export function ContextGauge({ execution }: ContextGaugeProps) {
+  const ctx = useContextWindow(execution);
+
+  if (!ctx.hasContextInfo) return null;
+
+  const filled = Math.round((Math.min(ctx.utilizationPercent, 100) / 100) * BAR_WIDTH);
+  const empty = BAR_WIDTH - filled;
+  const bar = "█".repeat(filled) + "░".repeat(empty);
+
+  const color = HEALTH_COLORS[ctx.health];
+  const healthLabel = HEALTH_LABELS[ctx.health];
+  const eventCount = ctx.summarizationEvents.length;
+
+  return (
+    <Box flexDirection="column" paddingLeft={1}>
+      <Box gap={1}>
+        <Text dimColor>Context</Text>
+        <Text color={color}>{bar}</Text>
+        <Text color={color}>{Math.round(ctx.utilizationPercent)}%</Text>
+        <Text dimColor>·</Text>
+        <Text dimColor>
+          {formatCompactTokens(ctx.currentTokenCount)} /{" "}
+          {formatCompactTokens(ctx.contextWindowLimit)} tokens
+        </Text>
+        {healthLabel && (
+          <>
+            <Text dimColor>·</Text>
+            <Text color={color}>{healthLabel}</Text>
+          </>
+        )}
+        {eventCount > 0 && (
+          <>
+            <Text dimColor>·</Text>
+            <Text dimColor>
+              {eventCount} {eventCount === 1 ? "compaction" : "compactions"}
+            </Text>
+          </>
+        )}
+      </Box>
+      {eventCount > 0 && (
+        <LatestEvent event={ctx.summarizationEvents[eventCount - 1]} />
+      )}
+    </Box>
+  );
+}
+
+function LatestEvent({ event }: { readonly event: SummarizationEventView }) {
+  const reduction = Math.round(event.compressionRatio * 100);
+
+  return (
+    <Box paddingLeft={2}>
+      <Text dimColor>
+        {formatCompactTokens(event.tokensBefore)} →{" "}
+        {formatCompactTokens(event.tokensAfter)} tokens ({reduction}% reduction)
+        {event.model ? ` · ${event.model}` : ""}
+        {event.durationMs > 0 ? ` · ${formatDuration(event.durationMs)}` : ""}
+        {event.costUsd > 0
+          ? ` · $${event.costUsd < 0.01 ? event.costUsd.toFixed(4) : event.costUsd.toFixed(2)}`
+          : ""}
+      </Text>
+    </Box>
+  );
+}

package/src/components/FollowUpInput.tsx

@@ -12,6 +12,8 @@ export interface FollowUpInputProps {
   readonly disabled?: boolean;
   /** Placeholder text. Default: "Reply..." */
   readonly placeholder?: string;
+  /** Current interaction mode. Shown in the shortcut hint line. */
+  readonly mode?: "agent" | "plan";
 }
 
 /**
@@ -25,6 +27,7 @@ export function FollowUpInput({
   isSubmitting = false,
   disabled = false,
   placeholder = "Reply...",
+  mode,
 }: FollowUpInputProps) {
   const [value, setValue] = useState("");
   const { isRawModeSupported } = useStdin();
@@ -62,7 +65,7 @@ export function FollowUpInput({
       </Box>
       <Box paddingLeft={2}>
         <Text dimColor>
-          Enter to send · Ctrl+C to exit
+          Enter to send · Ctrl+T {mode === "plan" ? "agent" : "plan"} mode · Ctrl+C exit
         </Text>
       </Box>
     </Box>

package/src/index.ts

@@ -22,7 +22,8 @@ export { ApprovalPrompt, type ApprovalPromptProps } from "./components/ApprovalP
 export { ExecutionProgress, type ExecutionProgressProps } from "./components/ExecutionProgress.js";
 export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";
+export { ContextGauge, type ContextGaugeProps } from "./components/ContextGauge.js";
 
 // Composed views
-export { SessionView, type SessionViewProps } from "./app/SessionView.js";
+export { SessionView, type SessionViewProps, type InteractionMode } from "./app/SessionView.js";
 export { SessionApp, type SessionAppProps } from "./app/SessionApp.js";