@crouter/api 0.3.387 → 0.3.389

package/dist/types.js

@@ -0,0 +1,186 @@
+import { DEFAULT_WORKING_GERUNDS } from './shared/working-activity.js';
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL: 1,
+    USAGE: 2,
+    NOT_FOUND: 3,
+    AMBIGUOUS: 4,
+    NETWORK: 5,
+};
+export const SCHEMA_VERSION = 4;
+export const PLUGIN_MANIFEST_DIR = '.crouter-plugin';
+export const PLUGIN_MANIFEST_FILE = 'plugin.json';
+export const MARKETPLACE_MANIFEST_DIR = '.crouter-marketplace';
+export const MARKETPLACE_MANIFEST_FILE = 'marketplace.json';
+export const CRTR_DIR_NAME = '.crouter';
+export const CONFIG_FILE = 'config.json';
+export const STATE_FILE = 'state.json';
+// Subagent definitions live as flat `<name>.md` files under `<root>/agents/`,
+// for both scope roots and plugins.
+export const AGENTS_DIR = 'agents';
+// Profile stores live as `<slug>-<id>/` dirs under `<user-scope-root>/profiles/`
+// (never a project/builtin scope — profiles are a user-root-only concept).
+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',
+];
+/** What the whip action sends (see `whip_message_mode`). */
+export const WHIP_MESSAGE_MODES = ['random', 'go-faster'];
+export const DEFAULT_WHIP_MESSAGE_MODE = 'random';
+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';
+export function defaultScopeConfig() {
+    return {
+        schema_version: SCHEMA_VERSION,
+        marketplaces: {},
+        plugins: {},
+        auto_update: { crtr: 'notify', content: 'notify', interval_hours: 24 },
+        max_panes_per_window: DEFAULT_MAX_PANES_PER_WINDOW,
+        auto_open_child_viewers: true,
+        // Every live broker is a whole pi engine. 256 of them is not a bound any
+        // real host survives — an 8 GB guest dies around a few dozen — so these are
+        // sized as a backstop that actually engages before the machine does.
+        // Override per host with CRTR_MAX_LIVE_BROKERS / CRTR_WARN_LIVE_BROKERS.
+        brokerThresholds: { warning: 16, automaticReviveCap: 32 },
+        // The unattended-park idle-eligibility delay: how long an eligible resident
+        // idles before its parking turn begins. Override per host with
+        // CRTR_UNATTENDED_PARK_MS.
+        lifecycle: { unattendedParkMs: 15 * 60_000 },
+        completion_bell: true,
+        working_gerunds: [...DEFAULT_WORKING_GERUNDS],
+        whip_mode: false,
+        page_components: [],
+        page_surface: false,
+        whip_messages: [...DEFAULT_WHIP_MESSAGES],
+        whip_message_mode: DEFAULT_WHIP_MESSAGE_MODE,
+        mouse_mode_default: 'tmux',
+        live_cycles: DEFAULT_LIVE_CYCLES,
+        condensed_history: DEFAULT_CONDENSED_HISTORY,
+        bash_tool_purpose: true,
+        fold_finished_tools: true,
+        summarize_tool_calls: true,
+        detailed_tool_recaps: true,
+        keybindings: {},
+        tmux_passthrough: [],
+        modelLadders: defaultModelLaddersConfig(),
+        providerOptions: {},
+        kinds: defaultKindsConfig(),
+        remoteCanvas: defaultRemoteCanvasConfig(),
+        api: { tcp: '' },
+        spawnEnv: { allow: [] },
+        bin: {},
+        humanActions: {},
+    };
+}
+/** No remote canvas targets are configured out of the box — every one is
+ *  registered via `crtr canvas config add` (see `RemoteCanvasConfig`). */
+export function defaultRemoteCanvasConfig() {
+    return { targets: {} };
+}
+/** The builtin kind registry (spec §1.5): core role discovery and launch
+ *  defaults. `whenToUse`/`model` are the base-worker defaults;
+ *  `orchestratorModel` optionally raises the default for a coordinating
+ *  persona. Optional plugins contribute their own specialist sub-personas. */
+export function defaultKindsConfig() {
+    return {
+        general: {
+            whenToUse: 'Anything else — the catch-all worker for a task that does not fit a specialist kind.',
+            model: 'anthropic/strong',
+        },
+        explore: {
+            whenToUse: 'Gather current-state evidence about unfamiliar code or existing architecture — read-only code-path research with concrete file:line support. Diagnosis or recommendations belong to advisor, target architecture to design, required behavior or acceptance criteria to spec, and implementation decomposition to plan.',
+            model: 'openai/light',
+            orchestratorModel: 'anthropic/strong',
+        },
+        developer: {
+            whenToUse: 'Implement a change — make the feature or fix genuinely work against its acceptance criteria, not merely compile.',
+            model: 'openai/medium',
+            orchestratorModel: 'anthropic/strong',
+        },
+        design: {
+            whenToUse: 'Architect a solution — produce one design document an implementer can build from without re-deciding anything left open.',
+            model: 'anthropic/strong',
+        },
+        plan: {
+            whenToUse: 'Break work into steps — turn a spec or design into a concrete, phased, parallelizable plan with every decision resolved.',
+            model: 'anthropic/strong',
+            orchestratorModel: 'anthropic/strong',
+        },
+        spec: {
+            whenToUse: 'Collaborate with the user to discover what to build, then write the spec — behavior, non-goals, interfaces, edge cases, testable acceptance criteria.',
+            model: 'anthropic/strong',
+        },
+        review: {
+            whenToUse: 'Validate or critique code, a plan, or a spec — deliver a complete, severity-rated verdict without adjudicating.',
+            model: 'openai/medium',
+            orchestratorModel: 'openai/strong',
+        },
+        advisor: {
+            whenToUse: 'Debug failures, investigate why something is broken or misbehaving, diagnose live/runtime issues, or give engineering advice and second opinions — reason from evidence and recommend the next move. Use advisor (not explore) whenever the task is to find out what is going wrong.',
+            model: 'anthropic/strong',
+        },
+        'review/companion': {
+            whenToUse: 'Born by the daemon for one human review; never spawned by an agent.',
+            availableTo: [],
+        },
+    };
+}
+export function defaultModelLaddersConfig() {
+    return {
+        anthropic: {
+            ultra: 'anthropic/claude-fable-5:xhigh',
+            strong: 'anthropic/claude-opus-5-5:medium',
+            medium: 'anthropic/claude-sonnet-5-5:medium',
+            light: 'anthropic/claude-haiku-4-5:high',
+        },
+        openai: {
+            ultra: 'openai-codex/gpt-6-astra:max',
+            strong: 'openai-codex/gpt-6.1-sol:high',
+            medium: 'openai-codex/gpt-6.1-sol:medium',
+            light: 'openai-codex/gpt-6-luna:low',
+        },
+    };
+}
+export function defaultScopeState() {
+    return { marketplaces: {}, plugins: {} };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouter/api",
-  "version": "0.3.387",
+  "version": "0.3.389",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",