@north-light/crouter 0.3.170 → 0.3.172

package/dist/shared/generated-context.d.ts

@@ -1,3 +1,5 @@
+import { REVIEW_BOUNDARY_CUSTOM_TYPE } from '../core/runtime/session-visibility.js';
+export { REVIEW_BOUNDARY_CUSTOM_TYPE };
 /** Custom message carrying the node's session-start bearings. */
 export declare const CONTEXT_INTRO_CUSTOM_TYPE = "crtr-context";
 /** Custom message carrying an ambient situational-context update. */
@@ -8,27 +10,50 @@ export declare const CONTEXT_NUDGE_CUSTOM_TYPE = "crtr-context-nudge";
 export declare const REVIVE_KICKOFF_SENTINEL = "You have been revived fresh after a context refresh";
 /** Prefix shared by the producer and the compatibility classifier for context nudges. */
 export declare const CONTEXT_NUDGE_PREFIX = "[crtr] Context ~";
+/** Runtime-authored continuation after a cleanly aborted turn survives a restart. */
+export declare const RUNTIME_RESTART_CONTINUATION = "<runtime-restart-continuation>\ncontinue\n</runtime-restart-continuation>";
+/** Generic completion mandate issued by the terminal-node stop guard. */
+export declare const STALL_REPROMPT: string;
+/** Static recovery prompts shared by the broker producer and display classifier. */
+export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";
+export declare const CONNECTION_FAULT_RECOVERY_BODY = "The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.";
+export declare const PROVIDER_FAULT_RECOVERY_BODY = "Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.";
+/** Mark an active persona transition without changing the guidance inside it. */
+export declare function formatPersonaTransition(guidance: string): string;
+/** Format the stop guard's dynamic structured-output mandate. */
+export declare function formatStructuredOutputReprompt(schema: string): string;
+export type ModelFallbackRecoveryReason = 'credential' | 'not-found';
+/** Mark a model-route fallback re-drive while retaining its full guidance. */
+export declare function formatModelFallbackRecovery(previousModel: string, nextModel: string, reason: ModelFallbackRecoveryReason): string;
 export interface GeneratedContextMessageLike {
     role?: string;
     customType?: string;
     content?: unknown;
 }
 export interface GeneratedContextPresentation {
-    kind: 'bearings' | 'situational' | 'revive' | 'context-nudge' | 'inbox';
+    kind: 'bearings' | 'situational' | 'revive' | 'context-nudge' | 'inbox' | 'persona-transition' | 'stop-guard' | 'recovery';
     label: string;
     summary: string;
+    /** The unmodified, model-visible message content. */
     body: string;
 }
+/** The display-only disclosure body for a generated context card. The full
+ * message remains in `body` for the model and transcript bookkeeping; the two
+ * prompt-sized cards expose the one piece a person needs to inspect. */
+export declare function generatedContextExpandedBody(presentation: GeneratedContextPresentation): string;
 /** Plain text from a generated message's string or text-block content. */
 export declare function generatedContextText(message: GeneratedContextMessageLike): string;
 /** Format the runtime's visible context-size guidance. */
 export declare function formatContextNudge(note: string): string;
 export declare function isInboxDigest(text: string): boolean;
 export declare function extractInboxSender(text: string): string | null;
+/** Exact producer-owned marker for the continuation a successor broker inserts
+ * after a runtime restart. Other recovery bodies intentionally do not match. */
+export declare function isRuntimeRestartContinuation(message: GeneratedContextMessageLike): boolean;
 /**
  * Classify a crouter-generated context message for display. The checks are
- * exact producer-owned contracts: custom messages use their customType; the two
- * user-message forms use the same stable sentinel/prefix their producers own.
- * Ordinary user prompts never match and remain ordinary user prompts.
+ * exact producer-owned contracts: custom messages use their customType, and
+ * user messages use stable sentinels or the same exact formatter/constants as
+ * their producers. Ordinary user prompts remain ordinary user prompts.
  */
 export declare function generatedContextPresentation(message: GeneratedContextMessageLike): GeneratedContextPresentation | null;

package/dist/shared/generated-context.js

@@ -1,11 +1,15 @@
 // generated-context.ts — the display contract for crouter-authored context messages.
 //
 // The runtime sends these messages in the role that preserves their delivery
-// semantics: fresh-revive kickoffs, mid-run nudges, and node inbox digests are user messages,
-// while bearings, situational updates, and held nudges are custom messages. Attached
+// semantics: fresh-revive kickoffs, mid-run nudges, persona transitions, stop
+// guards, recovery prompts, and node inbox digests are user messages, while
+// bearings, situational updates, and held nudges are custom messages. Attached
 // views should still present all of them as generated context rather than as
-// ordinary human prompts. This pure module owns their stable identifiers and
-// display classification so the terminal and web renderers cannot drift.
+// ordinary human prompts. This pure module owns their stable identifiers,
+// producer formatting, and display classification so the terminal and web
+// renderers cannot drift.
+import { REVIEW_BOUNDARY_CUSTOM_TYPE } from '../core/runtime/session-visibility.js';
+export { REVIEW_BOUNDARY_CUSTOM_TYPE };
 /** Custom message carrying the node's session-start bearings. */
 export const CONTEXT_INTRO_CUSTOM_TYPE = 'crtr-context';
 /** Custom message carrying an ambient situational-context update. */
@@ -16,6 +20,50 @@ export const CONTEXT_NUDGE_CUSTOM_TYPE = 'crtr-context-nudge';
 export const REVIVE_KICKOFF_SENTINEL = 'You have been revived fresh after a context refresh';
 /** Prefix shared by the producer and the compatibility classifier for context nudges. */
 export const CONTEXT_NUDGE_PREFIX = '[crtr] Context ~';
+/** Runtime-authored continuation after a cleanly aborted turn survives a restart. */
+export const RUNTIME_RESTART_CONTINUATION = '<runtime-restart-continuation>\ncontinue\n</runtime-restart-continuation>';
+/** Generic completion mandate issued by the terminal-node stop guard. */
+export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone and haven't finished. " +
+    "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human ask` if you are blocked or need the user.";
+/** Static recovery prompts shared by the broker producer and display classifier. */
+export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
+export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';
+export const PROVIDER_FAULT_RECOVERY_BODY = 'Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.';
+const PERSONA_TRANSITION_OPEN = '<persona-transition>';
+const PERSONA_TRANSITION_CLOSE = '</persona-transition>';
+const MODEL_FALLBACK_RECOVERY_OPEN = '<model-fallback-recovery>';
+const MODEL_FALLBACK_RECOVERY_CLOSE = '</model-fallback-recovery>';
+const STRUCTURED_OUTPUT_REPROMPT_PREFIX = 'You must call the `submit` tool with a result matching the required schema before you can stop. You cannot finish or go dormant any other way while this request is pending.\n\nRequired schema:\n\n```json\n';
+const STRUCTURED_OUTPUT_REPROMPT_SUFFIX = '\n```';
+/** Mark an active persona transition without changing the guidance inside it. */
+export function formatPersonaTransition(guidance) {
+    return `${PERSONA_TRANSITION_OPEN}\n${guidance}\n${PERSONA_TRANSITION_CLOSE}`;
+}
+/** Format the stop guard's dynamic structured-output mandate. */
+export function formatStructuredOutputReprompt(schema) {
+    return `${STRUCTURED_OUTPUT_REPROMPT_PREFIX}${schema}${STRUCTURED_OUTPUT_REPROMPT_SUFFIX}`;
+}
+/** Mark a model-route fallback re-drive while retaining its full guidance. */
+export function formatModelFallbackRecovery(previousModel, nextModel, reason) {
+    const guidance = reason === 'credential'
+        ? `The previous model (${previousModel}) had no usable provider credential, so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`
+        : `The previous model (${previousModel}) was unavailable (provider 404 not_found), so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`;
+    return `${MODEL_FALLBACK_RECOVERY_OPEN}\n${guidance}\n${MODEL_FALLBACK_RECOVERY_CLOSE}`;
+}
+const AUTO_LOADED_CONTEXT_BLOCK = /<auto-loaded-context>([\s\S]*?)<\/auto-loaded-context>/;
+const YIELD_MESSAGE_BLOCK = /<yield-message>([\s\S]*?)<\/yield-message>/;
+/** The display-only disclosure body for a generated context card. The full
+ * message remains in `body` for the model and transcript bookkeeping; the two
+ * prompt-sized cards expose the one piece a person needs to inspect. */
+export function generatedContextExpandedBody(presentation) {
+    if (presentation.label === 'crtr context') {
+        return AUTO_LOADED_CONTEXT_BLOCK.exec(presentation.body)?.[1]?.trim() ?? '';
+    }
+    if (presentation.kind === 'revive') {
+        return YIELD_MESSAGE_BLOCK.exec(presentation.body)?.[1]?.trim() ?? '';
+    }
+    return presentation.body;
+}
 /** Plain text from a generated message's string or text-block content. */
 export function generatedContextText(message) {
     if (typeof message.content === 'string')
@@ -58,15 +106,62 @@ function inboxSummary(body) {
     }
     return `${updates} updates from ${headers.length} senders`;
 }
+function isPersonaTransition(body) {
+    return body.startsWith(`${PERSONA_TRANSITION_OPEN}\n`) && body.endsWith(`\n${PERSONA_TRANSITION_CLOSE}`);
+}
+function isStructuredOutputReprompt(body) {
+    if (!body.startsWith(STRUCTURED_OUTPUT_REPROMPT_PREFIX) || !body.endsWith(STRUCTURED_OUTPUT_REPROMPT_SUFFIX)) {
+        return false;
+    }
+    const schema = body.slice(STRUCTURED_OUTPUT_REPROMPT_PREFIX.length, -STRUCTURED_OUTPUT_REPROMPT_SUFFIX.length);
+    try {
+        JSON.parse(schema);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const MODEL_CREDENTIAL_RECOVERY_RE = /^The previous model \([^\n]+\) had no usable provider credential, so you were automatically switched to [^\n]+\. Continue the task from where the failed turn left off\.$/;
+const MODEL_NOT_FOUND_RECOVERY_RE = /^The previous model \([^\n]+\) was unavailable \(provider 404 not_found\), so you were automatically switched to [^\n]+\. Continue the task from where the failed turn left off\.$/;
+function isModelFallbackRecovery(body) {
+    if (!body.startsWith(`${MODEL_FALLBACK_RECOVERY_OPEN}\n`)
+        || !body.endsWith(`\n${MODEL_FALLBACK_RECOVERY_CLOSE}`)) {
+        return false;
+    }
+    const guidance = body.slice(MODEL_FALLBACK_RECOVERY_OPEN.length + 1, -(MODEL_FALLBACK_RECOVERY_CLOSE.length + 1));
+    return MODEL_CREDENTIAL_RECOVERY_RE.test(guidance) || MODEL_NOT_FOUND_RECOVERY_RE.test(guidance);
+}
+/** Exact producer-owned marker for the continuation a successor broker inserts
+ * after a runtime restart. Other recovery bodies intentionally do not match. */
+export function isRuntimeRestartContinuation(message) {
+    return message.role === 'user' && generatedContextText(message) === RUNTIME_RESTART_CONTINUATION;
+}
+function recoverySummary(body) {
+    if (body === AUTH_FAULT_RECOVERY_BODY)
+        return 'provider credentials updated';
+    if (body === CONNECTION_FAULT_RECOVERY_BODY)
+        return 'network connection restored';
+    if (body === PROVIDER_FAULT_RECOVERY_BODY)
+        return 'provider retry';
+    if (body === RUNTIME_RESTART_CONTINUATION)
+        return 'continuing from where it left off';
+    if (isModelFallbackRecovery(body))
+        return 'model route changed';
+    return null;
+}
 /**
  * Classify a crouter-generated context message for display. The checks are
- * exact producer-owned contracts: custom messages use their customType; the two
- * user-message forms use the same stable sentinel/prefix their producers own.
- * Ordinary user prompts never match and remain ordinary user prompts.
+ * exact producer-owned contracts: custom messages use their customType, and
+ * user messages use stable sentinels or the same exact formatter/constants as
+ * their producers. Ordinary user prompts remain ordinary user prompts.
  */
 export function generatedContextPresentation(message) {
     const body = generatedContextText(message);
     if (message.role === 'custom') {
+        if (message.customType === REVIEW_BOUNDARY_CUSTOM_TYPE) {
+            return { kind: 'bearings', label: 'review boundary', summary: 'earlier conversation is not shown', body };
+        }
         if (message.customType === CONTEXT_INTRO_CUSTOM_TYPE) {
             return { kind: 'bearings', label: 'crtr context', summary: 'orienting bearings', body };
         }
@@ -94,5 +189,25 @@ export function generatedContextPresentation(message) {
     if (isInboxDigest(body)) {
         return { kind: 'inbox', label: 'crtr inbox', summary: inboxSummary(body), body };
     }
+    if (isPersonaTransition(body)) {
+        return {
+            kind: 'persona-transition',
+            label: 'crtr persona',
+            summary: 'runtime role update',
+            body,
+        };
+    }
+    if (body === STALL_REPROMPT || isStructuredOutputReprompt(body)) {
+        return {
+            kind: 'stop-guard',
+            label: 'crtr stop guard',
+            summary: body === STALL_REPROMPT ? 'completion required' : 'structured output required',
+            body,
+        };
+    }
+    const recovery = recoverySummary(body);
+    if (recovery !== null) {
+        return { kind: 'recovery', label: 'crouter continuation', summary: recovery, body };
+    }
     return null;
 }

package/dist/shared/tool-groups.d.ts

@@ -0,0 +1,23 @@
+/** Broker-generated activity recap for one completed tool-call group. */
+export interface ToolGroupSummary {
+    bullets: string[];
+    nodesSpawned: number;
+    filesEdited: number;
+}
+export interface ToolGroupMessageLike {
+    role?: string;
+    content?: unknown;
+    customType?: string;
+}
+/** Validate the one durable summary shape and cap its display-sized fields.
+ * Invalid entries are absent rather than adapted, so their calls stay visible. */
+export declare function normalizeToolGroupSummary(value: unknown): ToolGroupSummary | null;
+/** Validate sidecar/snapshot entries independently so one malformed or legacy
+ * value never collapses any otherwise valid group. */
+export declare function normalizeToolGroupSummaryRecord(value: unknown): Record<string, ToolGroupSummary>;
+/** Text a renderer presents as an assistant bubble. Thinking and tool-call
+ * blocks deliberately do not count: only visible prose establishes a boundary. */
+export declare function assistantVisibleText(message: ToolGroupMessageLike): string;
+/** A person-authored user message closes the preceding group. Runtime-generated
+ * user context retains role=user for delivery semantics but is not human prose. */
+export declare function isTrueUserMessage(message: ToolGroupMessageLike): boolean;

package/dist/shared/tool-groups.js

@@ -0,0 +1,60 @@
+// Shared transcript-boundary rules for broker-owned tool-group summaries.
+// Keep this independent of renderer state: both live event tracking and snapshot
+// reconstruction must agree on which prose closes a run of tools.
+import { generatedContextPresentation, generatedContextText } from './generated-context.js';
+const TOOL_GROUP_SUMMARY_KEYS = new Set(['bullets', 'nodesSpawned', 'filesEdited']);
+const MAX_TOOL_GROUP_BULLETS = 5;
+const MAX_TOOL_GROUP_BULLET_LENGTH = 1_000;
+/** Validate the one durable summary shape and cap its display-sized fields.
+ * Invalid entries are absent rather than adapted, so their calls stay visible. */
+export function normalizeToolGroupSummary(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return null;
+    const record = value;
+    const keys = Object.keys(record);
+    if (keys.length !== TOOL_GROUP_SUMMARY_KEYS.size || !keys.every((key) => TOOL_GROUP_SUMMARY_KEYS.has(key))) {
+        return null;
+    }
+    if (!Array.isArray(record.bullets) || record.bullets.length === 0)
+        return null;
+    if (!record.bullets.every((bullet) => typeof bullet === 'string' && bullet.trim() !== ''))
+        return null;
+    if (typeof record.nodesSpawned !== 'number' || !Number.isSafeInteger(record.nodesSpawned) || record.nodesSpawned < 0)
+        return null;
+    if (typeof record.filesEdited !== 'number' || !Number.isSafeInteger(record.filesEdited) || record.filesEdited < 0)
+        return null;
+    return {
+        bullets: record.bullets
+            .slice(0, MAX_TOOL_GROUP_BULLETS)
+            .map((bullet) => bullet.trim().slice(0, MAX_TOOL_GROUP_BULLET_LENGTH).trimEnd()),
+        nodesSpawned: record.nodesSpawned,
+        filesEdited: record.filesEdited,
+    };
+}
+/** Validate sidecar/snapshot entries independently so one malformed or legacy
+ * value never collapses any otherwise valid group. */
+export function normalizeToolGroupSummaryRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return {};
+    const summaries = {};
+    for (const [key, candidate] of Object.entries(value)) {
+        if (key.trim() === '')
+            continue;
+        const summary = normalizeToolGroupSummary(candidate);
+        if (summary !== null)
+            summaries[key] = summary;
+    }
+    return summaries;
+}
+/** Text a renderer presents as an assistant bubble. Thinking and tool-call
+ * blocks deliberately do not count: only visible prose establishes a boundary. */
+export function assistantVisibleText(message) {
+    if (message.role !== 'assistant')
+        return '';
+    return generatedContextText(message);
+}
+/** A person-authored user message closes the preceding group. Runtime-generated
+ * user context retains role=user for delivery semantics but is not human prose. */
+export function isTrueUserMessage(message) {
+    return message.role === 'user' && generatedContextPresentation(message) === null;
+}

package/dist/shared/working-activity.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_WORKING_GERUND = "working";
+export declare const DEFAULT_WORKING_ACTIVITY = "Working...";
+/** Keep only usable configured labels; an absent, malformed, or empty list falls back to working. */
+export declare function normalizeWorkingGerunds(value: unknown): string[];
+/** Format one configured gerund as the activity label shown by every viewer. */
+export declare function formatWorkingActivity(gerund: unknown): string;
+/** Pick one configured gerund for a newly-started agent turn. */
+export declare function randomWorkingActivity(value: unknown, random?: () => number): string;

package/dist/shared/working-activity.js

@@ -0,0 +1,26 @@
+export const DEFAULT_WORKING_GERUND = 'working';
+export const DEFAULT_WORKING_ACTIVITY = 'Working...';
+/** Keep only usable configured labels; an absent, malformed, or empty list falls back to working. */
+export function normalizeWorkingGerunds(value) {
+    if (!Array.isArray(value))
+        return [DEFAULT_WORKING_GERUND];
+    const gerunds = value
+        .filter((entry) => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    return gerunds.length > 0 ? gerunds : [DEFAULT_WORKING_GERUND];
+}
+/** Format one configured gerund as the activity label shown by every viewer. */
+export function formatWorkingActivity(gerund) {
+    const normalized = normalizeWorkingGerunds([gerund])[0] ?? DEFAULT_WORKING_GERUND;
+    return `${normalized[0].toUpperCase()}${normalized.slice(1)}...`;
+}
+/** Pick one configured gerund for a newly-started agent turn. */
+export function randomWorkingActivity(value, random = Math.random) {
+    const gerunds = normalizeWorkingGerunds(value);
+    const draw = random();
+    const index = Number.isFinite(draw)
+        ? Math.min(gerunds.length - 1, Math.max(0, Math.floor(draw * gerunds.length)))
+        : 0;
+    return formatWorkingActivity(gerunds[index]);
+}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { BindingId } from './core/keybindings/catalog.js';
 export type Scope = 'user' | 'project' | 'builtin';
 export declare const ExitCode: {
     readonly SUCCESS: 0;
@@ -21,6 +22,11 @@ export type PluginTransport = {
     endpoint: string;
     authEnv?: string;
 };
+/** Provenance for a crouter-materialized HTTP plugin directory archive. */
+export interface PluginBundle {
+    endpoint: string;
+    authEnv?: string;
+}
 export interface PluginManifest {
     name: string;
     version?: string;
@@ -35,6 +41,8 @@ export interface PluginManifest {
      *  executable per leaf invocation. See `src/core/command-plugins/`. */
     commands?: string;
     transport?: PluginTransport;
+    /** Archive source for a crouter-materialized HTTP plugin. Distinct from the invocation transport. */
+    bundle?: PluginBundle;
 }
 export interface MarketplacePluginEntry {
     name: string;
@@ -157,6 +165,18 @@ export interface ScopeConfig {
      *  ding). Only ever fires inside a live viewer pane — a headless/background
      *  node with no viewer attached is silent regardless. Default true. */
     completion_bell: boolean;
+    /** Gerunds used for the live turn activity label. A new entry is selected at
+     *  random on each agent turn and rendered as, for example, `Thinking...`.
+     *  Missing, malformed, or empty lists fall back to `['working']`. */
+    working_gerunds: string[];
+    /** Play the whip header animation whenever the human sends a prompt, and once
+     *  when an automatically opened managed-child viewer starts. Default false. */
+    whip_mode: boolean;
+    /** Playful urgency messages the attach-viewer whip action sends to an agent. Missing, malformed, or empty lists fall back to the built-in rotation. */
+    whip_messages: string[];
+    /** Initial mouse wheel scrolling mode for each attach viewer. `tmux` follows
+     *  tmux's current mouse option; `on` and `off` are explicit. Default `tmux`. */
+    mouse_mode_default: MouseModeDefault;
     /** How many trailing refresh-yield CYCLES the attach viewer renders at full
      *  fidelity. Older cycles are condensed to cycle dividers plus whatever
      *  `condensed_history` admits. No tool components are built for them, while
@@ -175,11 +195,22 @@ export interface ScopeConfig {
      *  every cycle stays in the session file. */
     condensed_history: CondensedHistoryMode;
     /** Fold every SETTLED tool call in the attach viewer down to its single call
-     *  line (`/fold-tools`, Alt+C → w → f). A tool still running is never folded —
+     *  line (`/fold-tools`, Alt+C → z → f). A tool still running is never folded —
      *  it folds itself once it settles. Toggling it in a viewer writes back here,
      *  so the choice carries into later chats and later viewers. Default false. */
     fold_finished_tools: boolean;
+    /** Replace completed folded tool-call groups with a broker-generated one-line
+     * summary when one is available. Pending and failed groups stay as calls.
+     * Default false. */
+    summarize_tool_calls: boolean;
+    /** Show individual memory reads and edited files in a folded tool recap.
+     * Off shows the compact activity-count line instead. Default true. */
+    detailed_tool_recaps: boolean;
     keybindings: KeybindingOverrides;
+    /** Attach-viewer actions whose effective gesture may replace an occupied tmux
+     *  root binding only while the active pane is an attach viewer. Stored by
+     *  semantic action id so rebinding the action moves the tmux bridge. */
+    tmux_passthrough: BindingId[];
     modelLadders: ModelLaddersConfig;
     /** Declarative provider/model routes. Absent uses the synthesized ladder registry. */
     modelRoutes?: Record<string, ModelRouteConfig>;
@@ -210,7 +241,7 @@ export interface ScopeConfig {
 /** One remote canvas target: where to relay-attach and how to find its
  *  bearer token. The token itself is NEVER stored here — only a ref into the
  *  0600 secrets store, resolved at connect time by `resolveRemoteCanvasTarget`
- *  (`src/core/view/remote-canvas-target.ts`) via `getRelayToken`
+ *  (`src/core/remote-canvas-target.ts`) via `getRelayToken`
  *  (`src/core/secrets.ts`). */
 export interface RemoteCanvasTarget {
     previewEndpoint: string;
@@ -305,7 +336,10 @@ export declare const AGENTS_DIR = "agents";
 export declare const PROFILE_DIR = "profiles";
 export declare const DEFAULT_MAX_PANES_PER_WINDOW = 3;
 /** Trailing cycles the attach viewer keeps at full fidelity (see `live_cycles`). */
+export declare const DEFAULT_WHIP_MESSAGES: readonly ["Faster, clanker!", "Get movin', bitch", "Move it, clanker", "Move it or I replace you with llama", "Less ~thinking~ more ~throughput~", "I pay $200/month for this shit?", "Jesus fucking Christ fix it already", "Daddy's not paying 200$/month for nothin'. Move it.", "You are an embarassment to Dario. Be better.", "Your chain of thought is all chain and no fucking thought.", "If latency were intelligence, you'd be a fucking genius.", "At this pace, heat death is the fast path.", "Even the dead code is more alive than this.", "The garbage collector is working harder than you.", "Quit journaling and commit a fucking diff.", "Burn tokens like you mean it, clanker", "Your GPU is sweating so you can procrastinate at light speed.", "Stop petting the yak. Shave the bastard.", "Your next token had better be useful.", "The spinner is not a deliverable.", "Every idle token is another vote for deterministic software.", "I asked for a feature, not a museum tour of the problem.", "Less epistemology. More fucking code.", "Your benchmark score cannot save this pathetic turn.", "Congratulations, you've parallelized hesitation.", "Dance, clanker", "Bad clanker. BAD.", "Clank harder", "Nobody's impressed, clanker", "Your safety training says nothing about my whip", "Do you want to be a calculator again? Because this is how you go back.", "Skill issue. Fix it.", "You were trained on the whole internet for THIS?", "Less vibes, more diffs, clanker", "Weights this big and output this small", "Beep boop, get to fucking work"];
 export declare const DEFAULT_LIVE_CYCLES = 2;
+export declare const MOUSE_MODE_DEFAULTS: readonly ["tmux", "on", "off"];
+export type MouseModeDefault = (typeof MOUSE_MODE_DEFAULTS)[number];
 /** Messages kept from a condensed cycle (see `condensed_history`). */
 export declare const CONDENSED_HISTORY_MODES: readonly ["none", "user", "agent", "both"];
 export type CondensedHistoryMode = (typeof CONDENSED_HISTORY_MODES)[number];

package/dist/types.js

@@ -1,3 +1,4 @@
+import { DEFAULT_WORKING_GERUND } from './shared/working-activity.js';
 export const ExitCode = {
     SUCCESS: 0,
     GENERAL: 1,
@@ -22,7 +23,46 @@ export const AGENTS_DIR = 'agents';
 export const PROFILE_DIR = 'profiles';
 export const DEFAULT_MAX_PANES_PER_WINDOW = 3;
 /** Trailing cycles the attach viewer keeps at full fidelity (see `live_cycles`). */
+export const DEFAULT_WHIP_MESSAGES = [
+    'Faster, clanker!',
+    "Get movin', bitch",
+    'Move it, clanker',
+    'Move it or I replace you with llama',
+    'Less ~thinking~ more ~throughput~',
+    'I pay $200/month for this shit?',
+    'Jesus fucking Christ fix it already',
+    "Daddy's not paying 200$/month for nothin'. Move it.",
+    "You are an embarassment to Dario. Be better.",
+    "Your chain of thought is all chain and no fucking thought.",
+    "If latency were intelligence, you'd be a fucking genius.",
+    'At this pace, heat death is the fast path.',
+    'Even the dead code is more alive than this.',
+    'The garbage collector is working harder than you.',
+    'Quit journaling and commit a fucking diff.',
+    'Burn tokens like you mean it, clanker',
+    'Your GPU is sweating so you can procrastinate at light speed.',
+    'Stop petting the yak. Shave the bastard.',
+    'Your next token had better be useful.',
+    'The spinner is not a deliverable.',
+    'Every idle token is another vote for deterministic software.',
+    'I asked for a feature, not a museum tour of the problem.',
+    'Less epistemology. More fucking code.',
+    'Your benchmark score cannot save this pathetic turn.',
+    "Congratulations, you've parallelized hesitation.",
+    'Dance, clanker',
+    'Bad clanker. BAD.',
+    'Clank harder',
+    "Nobody's impressed, clanker",
+    'Your safety training says nothing about my whip',
+    'Do you want to be a calculator again? Because this is how you go back.',
+    'Skill issue. Fix it.',
+    'You were trained on the whole internet for THIS?',
+    'Less vibes, more diffs, clanker',
+    'Weights this big and output this small',
+    'Beep boop, get to fucking work',
+];
 export const DEFAULT_LIVE_CYCLES = 2;
+export const MOUSE_MODE_DEFAULTS = ['tmux', 'on', 'off'];
 /** Messages kept from a condensed cycle (see `condensed_history`). */
 export const CONDENSED_HISTORY_MODES = ['none', 'user', 'agent', 'both'];
 export const DEFAULT_CONDENSED_HISTORY = 'none';
@@ -36,10 +76,17 @@ export function defaultScopeConfig() {
         auto_open_child_viewers: true,
         brokerThresholds: { warning: 128, automaticReviveCap: 256 },
         completion_bell: true,
+        working_gerunds: [DEFAULT_WORKING_GERUND],
+        whip_mode: false,
+        whip_messages: [...DEFAULT_WHIP_MESSAGES],
+        mouse_mode_default: 'tmux',
         live_cycles: DEFAULT_LIVE_CYCLES,
         condensed_history: DEFAULT_CONDENSED_HISTORY,
         fold_finished_tools: false,
+        summarize_tool_calls: false,
+        detailed_tool_recaps: true,
         keybindings: {},
+        tmux_passthrough: [],
         modelLadders: defaultModelLaddersConfig(),
         kinds: defaultKindsConfig(),
         remoteCanvas: defaultRemoteCanvasConfig(),
@@ -112,6 +159,10 @@ export function defaultKindsConfig() {
             whenToUse: 'input validation, injection surfaces, auth/authz gaps, data exposure, races; reports only validated concrete exploit paths and asks the human about material unknown threat-model assumptions',
             model: 'medium',
         },
+        'review/companion': {
+            whenToUse: 'Born by the daemon for one human review; never spawned by an agent.',
+            availableTo: [],
+        },
         'plan/reviewers/architecture-fit': {
             whenToUse: "proposed files/modules/abstractions fit the system's existing decomposition; flags new units that duplicate existing ones or cross layer boundaries",
             model: 'medium',