@crouton-kit/crouter 0.3.70 → 0.3.79

package/dist/pi-extensions/canvas-stophook.js

@@ -481,12 +481,35 @@ export function registerCanvasStophook(pi) {
         flushTelemetry(jobDirPath, totalIn, totalOut, model, contextTokens, lastActivity);
         touchBusy(nodeId); // wedge heartbeat: a turn ending is a sign of life
         clearFault(nodeId, { link: 'daemon→node' }); // reaching turn_end proves this turn wasn't wedged
+        clearFault(nodeId, { link: 'pi→provider' }); // a completed provider round-trip proves this episode is over
+        // Will the agent run CONTINUE past this turn? Deterministic at turn_end:
+        // the loop keeps going exactly when this assistant message carried tool
+        // calls and the run wasn't aborted/errored (those end unconditionally,
+        // before tools execute). A tool-calling turn ends with stopReason
+        // 'toolUse' — or 'length' when truncation failed the calls, which still
+        // continues the loop — NEVER 'stop', so gate on the abort/error reasons,
+        // not on an allowlist that excludes 'toolUse'.
+        // This handler runs BEFORE the loop drains the steering queue, so the read
+        // is race-free: zero tool calls ⇒ this is the run's FINAL message, and a
+        // steer sent now would not redirect at a boundary — it would EXTEND the run
+        // past the agent's closing reply, burying the summary the human comes back
+        // to read once the conversation goes quiet.
+        const turnContent = Array.isArray(event?.message?.content) ? event.message.content : [];
+        const turnStopReason = event?.message?.stopReason ?? '';
+        const runContinues = turnStopReason !== 'error' &&
+            turnStopReason !== 'aborted' &&
+            turnContent.some((c) => c?.type === 'toolCall');
         // Context-size steering: fire the current band once, with lifecycle-specific
         // guidance (lifecycle is read live — a terminal worker may have promoted to
         // resident since launch).
-        // Delivered as a STEER, not a followUp: guidance to become an orchestrator /
-        // delegate / yield must redirect the node at the turn boundary, not queue
-        // behind whatever it does next (where it rides along, easy to ignore).
+        // Delivery splits on runContinues:
+        //   • mid-run → STEER, not a followUp: guidance to become an orchestrator /
+        //     delegate / yield must redirect the node at the turn boundary, not queue
+        //     behind whatever it does next (where it rides along, easy to ignore).
+        //   • final message → HOLD via pi's 'nextTurn' queue: it injects alongside
+        //     the next user message without triggering a turn, so the nudge is read
+        //     at the start of the next engagement instead of spawning a phantom
+        //     continuation after the agent already said its piece.
         // Never the cumulative totalIn: under prompt caching that never grows (input
         // is a ~2-token uncached delta each turn), so the bands were unreachable and
         // the nudge never fired.
@@ -497,7 +520,13 @@ export function registerCanvasStophook(pi) {
             const at = contextTokens !== null ? steerBand(contextTokens) : null;
             if (at !== null && !firedBands.has(at)) {
                 firedBands.add(at);
-                pi.sendUserMessage(`[crtr] ${steerNote(at, lifecycle, mode)}`, { deliverAs: 'steer' });
+                const note = `[crtr] ${steerNote(at, lifecycle, mode)}`;
+                if (runContinues) {
+                    pi.sendUserMessage(note, { deliverAs: 'steer' });
+                }
+                else {
+                    pi.sendMessage({ customType: 'crtr-context-nudge', content: note, display: true }, { deliverAs: 'nextTurn' });
+                }
             }
         }
         catch {

package/dist/types.d.ts

@@ -20,6 +20,12 @@ export interface PluginManifest {
     source?: string;
     owner?: OwnerRef;
     kinds?: string[];
+    /** Plugin-root-relative path to one declarative command manifest
+     *  (`commands.json`). When present on an installed, enabled plugin, that
+     *  manifest contributes top-level command branches to the `crtr` tree —
+     *  crtr owns parse/help/render/errors and direct-spawns the plugin's one
+     *  executable per leaf invocation. See `src/core/command-plugins/`. */
+    commands?: string;
 }
 export interface MarketplacePluginEntry {
     name: string;
@@ -50,6 +56,8 @@ export interface AutoUpdateConfig {
     content: AutoUpdateMode;
     interval_hours: number;
 }
+export type KeybindingOverrides = Record<string, string[]>;
+/** Compile-time seam for runtime consumers migrating to semantic binding IDs. */
 export type CanvasAction = {
     kind?: 'crtr';
     run: string;
@@ -70,27 +78,6 @@ export interface CanvasMenuItem {
     action: CanvasAction;
     confirm?: boolean;
 }
-/** Legacy GRAPH bind shape; retained for graphBinds only. */
-export interface CanvasBind {
-    run: string;
-    confirm?: boolean;
-    desc?: string;
-}
-/** Canvas-nav config (`canvasNav` in config.json). `prefixBinds` are consumed
- *  at the tmux alt+c menu layer; `graphBinds` are consumed in-process by the
- *  canvas-nav pi extension while in GRAPH. Built-in GRAPH keys
- *  (j/k/h/l/g/G/enter/m/e/x/esc) are reserved — `graphBinds` is strictly
- *  additive. */
-export interface CanvasNavConfig {
-    /** Fallback pi shortcut for GRAPH toggle when NOT in tmux. Default 'alt+g'. */
-    prefixKey?: string;
-    /** chord key (after alt+c) → action; tmux-menu layer. */
-    prefixBinds: Record<string, CanvasAction & {
-        desc?: string;
-    }>;
-    /** extra raw key in GRAPH → action; pi-extension layer (additive only). */
-    graphBinds: Record<string, CanvasBind>;
-}
 export type ModelStrength = 'ultra' | 'strong' | 'medium' | 'light';
 export type ModelProvider = 'anthropic' | 'openai';
 export interface ModelLaddersConfig {
@@ -129,7 +116,7 @@ export interface ScopeConfig {
     plugins: Record<string, ConfigPluginEntry>;
     auto_update: AutoUpdateConfig;
     max_panes_per_window: number;
-    canvasNav: CanvasNavConfig;
+    keybindings: KeybindingOverrides;
     modelLadders: ModelLaddersConfig;
     /** The kind registry (spec §1.5): kind existence + launch knobs, keyed by
      *  full kind string (top-level e.g. `developer`, or sub-kind e.g.
@@ -264,9 +251,5 @@ export declare function defaultRemoteCanvasConfig(): RemoteCanvasConfig;
  *  ancestor) — `product/teardown` is included explicitly below for parity
  *  even though its value equals the default. */
 export declare function defaultKindsConfig(): Record<string, KindConfig>;
-/** Built-in canvas-nav binds so an absent config still gives the intended UX.
- *  prefixBinds restate the current menu defaults; graphBinds stay empty.
- */
-export declare function defaultCanvasNavConfig(): CanvasNavConfig;
 export declare function defaultModelLaddersConfig(): ModelLaddersConfig;
 export declare function defaultScopeState(): ScopeState;

package/dist/types.js

@@ -28,7 +28,7 @@ export function defaultScopeConfig() {
         plugins: {},
         auto_update: { crtr: 'notify', content: 'notify', interval_hours: 24 },
         max_panes_per_window: DEFAULT_MAX_PANES_PER_WINDOW,
-        canvasNav: defaultCanvasNavConfig(),
+        keybindings: {},
         modelLadders: defaultModelLaddersConfig(),
         kinds: defaultKindsConfig(),
         remoteCanvas: defaultRemoteCanvasConfig(),
@@ -119,33 +119,6 @@ export function defaultKindsConfig() {
         },
     };
 }
-/** Built-in canvas-nav binds so an absent config still gives the intended UX.
- *  prefixBinds restate the current menu defaults; graphBinds stay empty.
- */
-export function defaultCanvasNavConfig() {
-    return {
-        prefixKey: 'alt+g',
-        prefixBinds: {
-            o: { kind: 'keys', keys: '/promote', desc: 'promote to orchestrator' },
-            r: { kind: 'keys', keys: '/resume-node', desc: 'resume node' },
-            d: { kind: 'crtr', run: 'node lifecycle demote --pane {pane}', desc: 'demote to terminal' },
-            D: { kind: 'crtr', run: 'node lifecycle demote --pane {pane} --detach', desc: 'detach to background' },
-            x: { kind: 'crtr', run: 'node lifecycle close --pane {pane}', desc: 'close agent + subtree' },
-            c: { kind: 'keys', keys: '/context', desc: 'browse context dirs' },
-            g: { kind: 'keys', keys: '/graph', desc: 'graph view' },
-            m: { kind: 'crtr', run: 'node focus {manager}', desc: 'focus manager' },
-            i: {
-                kind: 'menu',
-                desc: 'new issue / todo',
-                items: [
-                    { key: 'i', desc: 'idea', action: { kind: 'popup', run: 'canvas issue new --type idea' } },
-                    { key: 'b', desc: 'bug', action: { kind: 'popup', run: 'canvas issue new --type bug' } },
-                ],
-            },
-        },
-        graphBinds: {},
-    };
-}
 export function defaultModelLaddersConfig() {
     return {
         anthropic: {