actoviq-agent-sdk 0.4.21 → 0.4.22

package/dist/src/runtime/toolPolicyPipeline.d.ts

@@ -68,12 +68,43 @@ export declare class ToolPolicyPipeline implements ToolPolicyPort {
 }
 /** Contribution seam: resolves a per-run pipeline (same pattern as the conversation extensions). */
 export declare const toolPolicyFactoryKey: import("../contrib/contributionHost.js").ContributionServiceKey<(options: ExecuteConversationOptions) => ToolPolicyPort>;
+/**
+ * Registry seam for policy listeners contributed outside the built-in set
+ * (built-in extensions, plugins). The pipeline factory reads it live per run,
+ * so listeners added or removed later take effect on the next run.
+ */
+export interface ToolPolicyListenerRegistry {
+    addPre(listener: ToolPrePolicyListener): void;
+    removePre(listener: ToolPrePolicyListener): boolean;
+    addPost(listener: ToolPostPolicyListener): void;
+    removePost(listener: ToolPostPolicyListener): boolean;
+    pre(): readonly ToolPrePolicyListener[];
+    post(): readonly ToolPostPolicyListener[];
+}
+export declare class InMemoryToolPolicyListenerRegistry implements ToolPolicyListenerRegistry {
+    private readonly preListeners;
+    private readonly postListeners;
+    addPre(listener: ToolPrePolicyListener): void;
+    removePre(listener: ToolPrePolicyListener): boolean;
+    addPost(listener: ToolPostPolicyListener): void;
+    removePost(listener: ToolPostPolicyListener): boolean;
+    pre(): readonly ToolPrePolicyListener[];
+    post(): readonly ToolPostPolicyListener[];
+}
+/** Global listener registry the built-in pipeline factory composes into every per-run pipeline. */
+export declare const toolPolicyListenerRegistryKey: import("../contrib/contributionHost.js").ContributionServiceKey<ToolPolicyListenerRegistry>;
 /** Built-in contribution: registers the behavior-preserving pipeline factory. */
 export declare function createBuiltInToolPolicyContribution(): HadamardRuntimeContribution;
 /**
  * Default pipeline preserving the current executor behavior exactly:
  * PreToolUse hooks, then the permission decision (with PermissionDecision
  * hooks), then deny stops; post: spill shaping then PostToolUse hooks.
+ * Contributed listeners (`extra`) run before the built-in pre listeners
+ * (monotonic deny: they can only tighten) and after the built-in post
+ * listeners in the waterfall.
  */
-export declare function createBuiltInToolPolicyPipeline(options: ExecuteConversationOptions): ToolPolicyPipeline;
+export declare function createBuiltInToolPolicyPipeline(options: ExecuteConversationOptions, extra?: {
+    pre?: readonly ToolPrePolicyListener[];
+    post?: readonly ToolPostPolicyListener[];
+}): ToolPolicyPipeline;
 //# sourceMappingURL=toolPolicyPipeline.d.ts.map

package/dist/src/runtime/toolPolicyPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolPolicyPipeline.d.ts","sourceRoot":"","sources":["../../../src/runtime/toolPolicyPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzF,OAAO,KAAK,EAA4B,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE5G,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACtE,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvG,MAAM,MAAM,sBAAsB,GAC9B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,2BAA2B,EACtC,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,KACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAErD,QAAQ,CAAC,GAAG,EAAE,SAAS,qBAAqB,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,sBAAsB,EAAE;gBADvC,GAAG,EAAE,SAAS,qBAAqB,EAAE,EACrC,IAAI,EAAE,SAAS,sBAAsB,EAAE;IAG5C,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWzD,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,sBAAsB,CAAC;CASnC;AAGD,oGAAoG;AACpG,eAAO,MAAM,oBAAoB,4EACrB,0BAA0B,KAAK,cAAc,CACjC,CAAC;AAEzB,iFAAiF;AACjF,wBAAgB,mCAAmC,IAAI,2BAA2B,CAQjF;AAGD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,0BAA0B,GAAG,kBAAkB,CAqGvG"}
+{"version":3,"file":"toolPolicyPipeline.d.ts","sourceRoot":"","sources":["../../../src/runtime/toolPolicyPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzF,OAAO,KAAK,EAA4B,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE5G,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACtE,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvG,MAAM,MAAM,sBAAsB,GAC9B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,2BAA2B,EACtC,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,KACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAErD,QAAQ,CAAC,GAAG,EAAE,SAAS,qBAAqB,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,sBAAsB,EAAE;gBADvC,GAAG,EAAE,SAAS,qBAAqB,EAAE,EACrC,IAAI,EAAE,SAAS,sBAAsB,EAAE;IAG5C,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWzD,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,sBAAsB,CAAC;CASnC;AAGD,oGAAoG;AACpG,eAAO,MAAM,oBAAoB,4EACrB,0BAA0B,KAAK,cAAc,CACjC,CAAC;AAEzB;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACpD,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC;IACtD,GAAG,IAAI,SAAS,qBAAqB,EAAE,CAAC;IACxC,IAAI,IAAI,SAAS,sBAAsB,EAAE,CAAC;CAC3C;AAED,qBAAa,kCAAmC,YAAW,0BAA0B;IACnF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAE9D,MAAM,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI7C,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;IAOnD,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI/C,UAAU,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO;IAOrD,GAAG,IAAI,SAAS,qBAAqB,EAAE;IAIvC,IAAI,IAAI,SAAS,sBAAsB,EAAE;CAG1C;AAED,mGAAmG;AACnG,eAAO,MAAM,6BAA6B,6FAEzC,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,mCAAmC,IAAI,2BAA2B,CAYjF;AAGD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,0BAA0B,EACnC,KAAK,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAE,GAC3F,kBAAkB,CAqGpB"}

package/dist/src/runtime/toolPolicyPipeline.js

@@ -37,12 +37,49 @@ export class ToolPolicyPipeline {
 }
 /** Contribution seam: resolves a per-run pipeline (same pattern as the conversation extensions). */
 export const toolPolicyFactoryKey = defineContributionServiceKey('hadamard.toolPolicy');
+export class InMemoryToolPolicyListenerRegistry {
+    preListeners = [];
+    postListeners = [];
+    addPre(listener) {
+        if (!this.preListeners.includes(listener))
+            this.preListeners.push(listener);
+    }
+    removePre(listener) {
+        const index = this.preListeners.indexOf(listener);
+        if (index < 0)
+            return false;
+        this.preListeners.splice(index, 1);
+        return true;
+    }
+    addPost(listener) {
+        if (!this.postListeners.includes(listener))
+            this.postListeners.push(listener);
+    }
+    removePost(listener) {
+        const index = this.postListeners.indexOf(listener);
+        if (index < 0)
+            return false;
+        this.postListeners.splice(index, 1);
+        return true;
+    }
+    pre() {
+        return [...this.preListeners];
+    }
+    post() {
+        return [...this.postListeners];
+    }
+}
+/** Global listener registry the built-in pipeline factory composes into every per-run pipeline. */
+export const toolPolicyListenerRegistryKey = defineContributionServiceKey('hadamard.toolPolicyListeners');
 /** Built-in contribution: registers the behavior-preserving pipeline factory. */
 export function createBuiltInToolPolicyContribution() {
     return {
         id: 'hadamard.tool-policy',
         async apply(ctx) {
-            ctx.services.register(toolPolicyFactoryKey, createBuiltInToolPolicyPipeline);
+            // Optional: tests may load this contribution without the registry.
+            const registry = ctx.services.get(toolPolicyListenerRegistryKey);
+            const factory = (options) => createBuiltInToolPolicyPipeline(options, { pre: registry?.pre(), post: registry?.post() });
+            ctx.services.register(toolPolicyFactoryKey, factory);
             return () => { ctx.services.unregister(toolPolicyFactoryKey); };
         },
     };
@@ -51,8 +88,11 @@ export function createBuiltInToolPolicyContribution() {
  * Default pipeline preserving the current executor behavior exactly:
  * PreToolUse hooks, then the permission decision (with PermissionDecision
  * hooks), then deny stops; post: spill shaping then PostToolUse hooks.
+ * Contributed listeners (`extra`) run before the built-in pre listeners
+ * (monotonic deny: they can only tighten) and after the built-in post
+ * listeners in the waterfall.
  */
-export function createBuiltInToolPolicyPipeline(options) {
+export function createBuiltInToolPolicyPipeline(options, extra) {
     const preToolUseListener = async (call, state) => {
         const outputs = await runTypedLifecycleHooks(options, 'PreToolUse', { iteration: call.iteration, input: call.input }, call.toolName);
         if (hasLifecycleBlock(outputs)) {
@@ -131,6 +171,6 @@ export function createBuiltInToolPolicyPipeline(options) {
         });
         return { kind: 'accept', content: shaped.content, additionalContexts: inner.additionalContexts };
     };
-    return new ToolPolicyPipeline([preToolUseListener, permissionListener], [spillListener, postToolUseListener]);
+    return new ToolPolicyPipeline([...(extra?.pre ?? []), preToolUseListener, permissionListener], [spillListener, postToolUseListener, ...(extra?.post ?? [])]);
 }
 //# sourceMappingURL=toolPolicyPipeline.js.map

package/dist/src/runtime/toolPolicyPipeline.js.map

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

package/dist/src/tui/hadamardTuiController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hadamardTuiController.d.ts","sourceRoot":"","sources":["../../../src/tui/hadamardTuiController.ts"],"names":[],"mappings":"AAuPA,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUxD,eAAO,MAAM,kBAAkB,wBAAgC,CAAC;AAQhE;;;;;GAKG;AAMH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAymJpF"}
+{"version":3,"file":"hadamardTuiController.d.ts","sourceRoot":"","sources":["../../../src/tui/hadamardTuiController.ts"],"names":[],"mappings":"AAiQA,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUxD,eAAO,MAAM,kBAAkB,wBAAgC,CAAC;AAQhE;;;;;GAKG;AAMH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAupJpF"}

package/dist/src/tui/hadamardTuiController.js

@@ -38,6 +38,9 @@ import { buildRouteModelApi } from '../router/modelRouter.js';
 import { addMcpServer, readMcpServerConfig, removeMcpServer } from '../mcp/mcpServerConfig.js';
 import { isReadOnlyBashCommand } from '../runtime/bashClassification.js';
 import { estimateCost } from '../team/pricing.js';
+import { SessionCostTracker } from '../extensions/sessionCostTracker.js';
+import { formatUsageBar, usageBarColorLevel } from '../extensions/usageBar.js';
+import { buildTerminalNotifySequence, formatTaskSettledNotification, resolveTaskNotificationOptions, } from '../extensions/taskNotifications.js';
 import { planFilePath, readPlanFile } from '../tools/planMode/PlanModeTools.js';
 import { loadProjectContext } from '../memory/projectContext.js';
 import { hashProjectInstructionContent, parseProjectInstructionState, } from '../memory/projectInstructionContext.js';
@@ -46,6 +49,9 @@ import { applyResolvedToolDescriptions } from '../runtime/agentClientRunHelpers.
 import { LegacySurfaceEventPipeline, } from '../surfaces/index.js';
 import { HADAMARD_INTERACTIVE_COMMANDS, SUBCOMMAND_DESCRIPTIONS, canRunInteractiveCommand, interactiveCommandRunPolicy, interactiveCommandUsage, selectInteractiveCommand, } from '../ui/commandSurface.js';
 import { createAgentExecutionProjectView, createAgentExecutionRootView, formatAgentExecutionTreeLines, } from '../ui/agentExecutionView.js';
+import { runExtensionsCommandView } from '../ui/extensionsCommandView.js';
+import { runLspCommandView } from '../ui/lspCommandView.js';
+import { TuiUsageRoutingRuntime } from './tuiUsageRoutingRuntime.js';
 import { A, truncateToWidth, wrapToWidth } from './ansi.js';
 import { InputEditor } from './editor.js';
 import { discoverHadamardPlugins } from './pluginCatalog.js';
@@ -218,6 +224,8 @@ export async function runHadamardTui(options = {}) {
                 model: options.model,
                 permissionMode,
             });
+    let activeKeywayRouteAlias = null;
+    const usageRoutingRuntime = new TuiUsageRoutingRuntime(sdk.config.homeDir, sdk.config.workDir, selection => { clearBridgeSelection(); activeRouter = null; routedModelLabel = null; activeBridgeModelApi = { model: selection.model, modelApi: selection.modelApi, maxTokens: 32000 }; bridgeModelLabel = selection.model; bridgeMode = true; activeKeywayRouteAlias = selection.routeAlias; });
     let deviceLinkService = null;
     async function getDeviceLinkService() {
         deviceLinkService ??= await DeviceLinkService.open({
@@ -233,6 +241,23 @@ export async function runHadamardTui(options = {}) {
     const screen = new TuiScreen(process.stdout);
     const editor = new InputEditor();
     const flusher = new StreamFlusher(() => screen.width);
+    // notifications extension: surface background-task completion inline in the
+    // transcript plus terminal bell/OSC. Enablement is read at fire time so
+    // toggling the extension applies to the next settled task.
+    let unsubscribeTaskNotifications = null;
+    function subscribeTaskNotifications() {
+        unsubscribeTaskNotifications?.();
+        unsubscribeTaskNotifications = sdk.onBackgroundTaskSettled(task => {
+            if (!sdk.builtInExtensions.isEnabled('notifications'))
+                return;
+            const notification = formatTaskSettledNotification(task);
+            appendStatic([...formatInfoLine(notification.body ? `${notification.title} — ${notification.body}` : notification.title), '']);
+            const sequence = buildTerminalNotifySequence(notification, resolveTaskNotificationOptions(sdk.builtInExtensions.getConfig('notifications')));
+            if (sequence)
+                process.stdout.write(sequence);
+        });
+    }
+    subscribeTaskNotifications();
     let running = false;
     let queuedConfirmActive = false;
     let commandBusy = false;
@@ -405,6 +430,7 @@ export async function runHadamardTui(options = {}) {
         bridgeMode = false;
         activeBridgeConfig = null;
         activeBridgeModelApi = null;
+        activeKeywayRouteAlias = null;
         bridgeModelLabel = null;
     }
     async function restoreSessionRuntimeSelection() {
@@ -593,14 +619,22 @@ export async function runHadamardTui(options = {}) {
     let totalInputTokens = 0;
     let totalOutputTokens = 0;
     let totalCostUsd = 0;
+    // costTracker extension: per-model accumulation + durable JSONL ledger at
+    // <homeDir>/usage/cost-ledger.jsonl. Token totals above always count; cost
+    // accumulation and ledger writes are gated on the extension at record time.
+    const costTracker = new SessionCostTracker(sdk.config.homeDir);
     const configUsage = new Map();
-    function recordUsage(model, usage) {
+    function recordUsage(model, usage, runId) {
         const inT = usage?.input_tokens ?? 0;
         const outT = usage?.output_tokens ?? 0;
         totalInputTokens += inT;
         totalOutputTokens += outT;
-        const cost = estimateCost(model, inT, outT);
-        totalCostUsd = cost === null ? null : (totalCostUsd === null ? cost : totalCostUsd + cost);
+        if (sdk.builtInExtensions.isEnabled('costTracker')) {
+            costTracker.record(model, usage ?? {}, { sessionId: session.id, runId,
+                configurationId: activeBridgeConfig?.name, source: bridgeMode ? 'bridge' : 'hadamard' });
+            const cost = estimateCost(model, inT, outT);
+            totalCostUsd = cost === null ? null : (totalCostUsd === null ? cost : totalCostUsd + cost);
+        }
         // Per-config tracking: attribute this turn to the active bridge config.
         if (bridgeMode && activeBridgeConfig) {
             const rec = configUsage.get(activeBridgeConfig.name) ?? { inputTokens: 0, outputTokens: 0, turns: 0 };
@@ -700,6 +734,7 @@ export async function runHadamardTui(options = {}) {
             sdk = nextSdk;
             session = nextSession;
             toolMetadata = nextToolMetadata;
+            subscribeTaskNotifications();
             await restoreSessionRuntimeSelection();
         }
         catch (error) {
@@ -986,7 +1021,7 @@ export async function runHadamardTui(options = {}) {
             ?? 200_000;
         const pct = window > 0 ? Math.min(100, Math.round((used / window) * 100)) : 0;
         const usedK = used >= 1000 ? `${(used / 1000).toFixed(used >= 100_000 ? 0 : 1)}k` : `${used}`;
-        const ctxColor = pct >= 90 ? A.red : pct >= 70 ? A.yellow : A.dim;
+        const ctxColor = usageBarColorLevel(pct) === 'critical' ? A.red : usageBarColorLevel(pct) === 'warn' ? A.yellow : A.dim;
         const modelLabel = activeRouter
             ? `router:${activeRouter.name}${routedModelLabel ? ` → ${routedModelLabel}` : ''}`
             : !bridgeMode && activeBridgeConfig?.runtime === 'hadamard' && bridgeModelLabel
@@ -999,7 +1034,20 @@ export async function runHadamardTui(options = {}) {
             ? `team:${activeTeamName}${teamPrefs.autoInvoke ? '' : ' (manual)'}`
             : 'team:none';
         const left = `${modelLabel} · ${permissionLabel()} · mode:${currentAgentMode()} · effort:${currentEffort() ?? 'auto'} · ${teamLabel}${bridgeTag}${goalContextLine()} · `;
-        return `${A.dim}  ${left}${A.reset}${ctxColor}ctx ${pct}% (${usedK})${A.reset}`;
+        // usageBar extension: swap the plain ctx segment for a bar + session
+        // cost/tokens. Read at render time so /extensions toggling is live.
+        const ctxSegment = sdk.builtInExtensions.isEnabled('usageBar')
+            ? formatUsageBar({
+                contextUsedTokens: used,
+                contextWindowTokens: window,
+                ...(sdk.builtInExtensions.isEnabled('costTracker') && totalCostUsd !== null
+                    ? { sessionCostUsd: totalCostUsd }
+                    : {}),
+                inputTokens: totalInputTokens,
+                outputTokens: totalOutputTokens,
+            })
+            : `ctx ${pct}% (${usedK})`;
+        return `${A.dim}  ${left}${A.reset}${ctxColor}${ctxSegment}${A.reset}`;
     }
     function buildStatusLine() {
         const modeLine = buildModeLine();
@@ -1455,7 +1503,7 @@ export async function runHadamardTui(options = {}) {
                 // pre-built {model, modelApi} into session.stream — the /model
                 // router's proven mechanism for cross-provider routing. Same
                 // session → context intact; switching bridge↔hadamard is seamless.
-                statusNote = `bridge:${activeBridgeConfig?.name ?? 'bridge'}`;
+                statusNote = activeKeywayRouteAlias ? `keyway:${activeKeywayRouteAlias}` : `bridge:${activeBridgeConfig?.name ?? 'bridge'}`;
                 const stream = session.stream(expandImageRefs(text), {
                     systemPrompt,
                     ...projectInstructionRunOptions(),
@@ -1504,7 +1552,7 @@ export async function runHadamardTui(options = {}) {
             collapseReasoning();
             // Accumulate token + USD usage for /cost and /usage. The model is the
             // routed model (if a router is active) or the session model. Bridge runs
-            recordUsage(routed?.model ?? activeBridgeModelApi?.model ?? bridgeModelLabel ?? session.model, result.usage);
+            recordUsage(routed?.model ?? activeBridgeModelApi?.model ?? bridgeModelLabel ?? session.model, result.usage, result.runId);
             const rest = flusher.drain();
             if (rest.length > 0)
                 appendStatic(rest);
@@ -2650,6 +2698,7 @@ export async function runHadamardTui(options = {}) {
     // session.stream (same session, context naturally survives switching).
     async function activateBridgeConfig(config) {
         try {
+            activeKeywayRouteAlias = null;
             if (config.execution === 'cli') {
                 if (!isManagedExternalCliRuntime(config.runtime)) {
                     throw new Error('External CLI mode requires an installed CLI runtime.');
@@ -3806,6 +3855,7 @@ export async function runHadamardTui(options = {}) {
                     bridgeName: bridgeMode ? activeBridgeConfig?.name : undefined,
                     planMode: session.permissionContext.mode === 'plan',
                 }),
+                ...usageRoutingRuntime.commandPorts(() => sdk.builtInExtensions.isEnabled('costTracker'), async (label) => promptText({ title: 'Write-only API key', label, secret: true })),
                 runGoal: async (args) => (await sdk.goals.command(session, args)).message,
                 appendStatic,
             });
@@ -4396,7 +4446,7 @@ export async function runHadamardTui(options = {}) {
                         effort: currentEffort() ?? 'auto',
                         team: activeTeamName ?? 'none',
                         router: activeRouter?.name ?? 'off',
-                        bridge: bridgeMode && activeBridgeConfig ? activeBridgeConfig.name : 'off',
+                        bridge: activeKeywayRouteAlias ? `keyway:${activeKeywayRouteAlias}` : bridgeMode && activeBridgeConfig ? activeBridgeConfig.name : 'off',
                     };
                 },
                 doctorSnapshot: async () => {
@@ -4491,6 +4541,8 @@ export async function runHadamardTui(options = {}) {
                     const { RuleCommandService } = await import('../context/ruleCommandService.js');
                     return new RuleCommandService(sdk.config.homeDir, sdk.config.workDir).execute(commandArgs);
                 },
+                extensionsCommand: commandArgs => runExtensionsCommandView(sdk.builtInExtensions, commandArgs),
+                lspCommand: () => runLspCommandView(sdk.codeIntelligence),
                 appendStatic,
             }))
                 return;
@@ -4645,6 +4697,7 @@ export async function runHadamardTui(options = {}) {
         if (shuttingDown)
             return;
         shuttingDown = true;
+        unsubscribeTaskNotifications?.();
         let exitCode = code;
         if (spinnerTimer)
             clearInterval(spinnerTimer);
@@ -4675,6 +4728,7 @@ export async function runHadamardTui(options = {}) {
             ...(globalAssistantSdk ? [globalAssistantSdk.close()] : []),
             externalCliRuntimeManager.close(),
             ...[...externalBridgeRuntimes.values()].map(runtime => runtime.client.close()),
+            usageRoutingRuntime.close(),
         ]);
         const cleanupFailures = cleanupResults
             .filter((result) => result.status === 'rejected');