@kdonev/termscape 0.1.0 → 0.1.2

package/dist/agents/profiles.d.ts

@@ -16,19 +16,136 @@ export interface AgentProfile {
     /** Regex matched against the last non-empty line when status = heuristic. */
     readyHint?: string;
     inject: InjectMode;
+    /**
+     * How the brief reaches the agent.
+     *
+     * `flag` - the profile's own args point at `{{brief_path}}`, the way Claude
+     * Code's `--append-system-prompt-file` does. The brief is part of the
+     * system prompt and the agent never sees it as a turn.
+     *
+     * `typed` - the CLI has no way to *append* to its system prompt, so the
+     * brief is typed into the terminal once the CLI is up, ahead of any opening
+     * instruction. Both of the other wired CLIs are in this position, and for
+     * the same reason: Codex's `base_instructions` and Gemini's
+     * `GEMINI_SYSTEM_MD` each *replace* the whole system prompt rather than add
+     * to it, so using either would cost the agent its own tool instructions -
+     * a far worse trade than a first turn that arrives as text.
+     *
+     * `none` - nothing is sent. `shell` is the reason this value exists and it
+     * is not a value any agent should want: a shell *executes* what is typed at
+     * it, so a brief there is not context, it is a series of commands that fail
+     * loudly.
+     *
+     * Absent means `flag` for a wired agent - what every profile written before
+     * this did - and `none` for an unwired one, because `mcp: false` has always
+     * meant "a plain terminal" and a profile that declared one should not start
+     * having text typed into it. An unwired agent that *is* an agent says
+     * `brief = "typed"` and gets the shorter brief: no tool list, because it has
+     * no tools, but it is still told its address and still told that a
+     * `[from ...]` line is a colleague rather than the human.
+     */
+    brief?: 'flag' | 'typed' | 'none';
     /**
      * Argument template used to bring a session back with its prior
      * conversation. `{{uuid}}` is replaced with agent_session_uuid. When absent,
      * the profile is not resumable and restarts clean.
      */
     resumeArgs?: string[];
+    /**
+     * Environment for the *detection* probes only, not for a session.
+     *
+     * Detection runs these CLIs on a machine whose owner may never have run them
+     * by hand, so a probe that leaves something behind is the hub writing to
+     * somebody's home directory uninvited. `opencode models` does exactly that -
+     * it creates ~/.config/opencode/opencode.jsonc - and this is how it is told
+     * not to.
+     */
+    probeEnv?: Record<string, string>;
+    /**
+     * How to ask this CLI its version. Its stdout is shown to the user and is
+     * also the cache key for the model list, so a CLI that updates underneath
+     * us re-lists rather than serving last week's answer.
+     */
+    versionArgs?: string[];
+    /**
+     * How to ask this CLI what models it can be pointed at: one
+     * `provider/model` (or bare name) per line on stdout. Absent when the CLI
+     * has no such command, which is the common case.
+     */
+    modelsArgs?: string[];
+    /**
+     * The answer for a CLI that cannot be asked. Claude Code is the example:
+     * it has no listing command, and its --help documents the aliases instead.
+     * Used only when `modelsArgs` is absent or its command fails.
+     */
+    models?: string[];
+    /**
+     * How this agent spells a model on the command line. `{{model}}` carries
+     * the value a template chose.
+     *
+     * A template holds *values*, not argv, because no two of these agents agree:
+     * Claude Code takes `--model`, opencode takes `-m provider/model`. So the
+     * template says which model and the agent says how to write it down.
+     *
+     * Absent means the agent takes no model here, and a template that names one
+     * for it is a configuration error reported at load rather than a flag
+     * silently dropped at launch. The whole fragment disappears when a template
+     * leaves the value unset - it does not expand to an empty string.
+     */
+    modelArgs?: string[];
+    /** The same for effort, with `{{effort}}`. */
+    effortArgs?: string[];
+    /** The effort levels this agent documents, for the dialog to offer. */
+    efforts?: string[];
 }
 /**
  * Built-in profiles. All Claude Code flags here are verified against the CLI:
- * --mcp-config, --strict-mcp-config, --session-id, --settings,
- * --append-system-prompt-file, --resume.
+ * --mcp-config, --session-id, --settings, --append-system-prompt-file,
+ * --resume.
+ *
+ * `--mcp-config` deliberately arrives *without* `--strict-mcp-config`. Strict
+ * mode makes the named file the whole of the agent's MCP configuration, which
+ * silently drops every server the user set up for themselves — an agent
+ * started here would be missing the tools it has everywhere else, with nothing
+ * on screen to say why. Without it the hub's server is one more entry beside
+ * theirs, which is the only version of "wired to the hub" worth having.
+ *
+ * Codex and Gemini are wired too, and every flag and key below was verified
+ * against the CLI actually installed - codex-cli 0.153.4 and gemini 0.58.0 -
+ * rather than written from memory. Both reach the hub the same way Claude
+ * Code does, over one streamable-HTTP MCP server carrying a bearer token, and
+ * neither needs a byte written to config the user owns:
+ *
+ * - **Codex** takes `-c <dotted.key>=<toml>` on any invocation, so the server
+ *   is declared in argv for the one run. The token is *not* in argv - it goes
+ *   in the environment, and `bearer_token_env_var` names the variable to read
+ *   it from, which keeps it out of every process listing on the machine.
+ * - **Gemini** has no per-run config flag, but
+ *   `GEMINI_CLI_SYSTEM_SETTINGS_PATH` repoints its system settings layer at a
+ *   file of our choosing, which the hub generates per session.
+ *
+ * - **opencode** turned out to be the least invasive of the three and was
+ *   assumed to be the hardest. It reads its entire config from
+ *   `OPENCODE_CONFIG_CONTENT`, so nothing is written anywhere at all, and what
+ *   it is given is merged with the user's own config rather than replacing it.
+ *   The assumption that it had no per-run route came from reading
+ *   `opencode mcp add` - which does write to the user's file, and ignores
+ *   `OPENCODE_CONFIG` when it does - and mistaking that command for the only
+ *   way in.
+ *
+ * `shell` is the only profile left that is not an agent, and it is not one in
+ * a way no flag can fix: it runs a shell, so text typed at it is executed
+ * rather than read.
  */
 export declare const BUILTIN_PROFILES: Record<string, AgentProfile>;
+/**
+ * How this profile's brief travels, with the defaults applied.
+ *
+ * One place, because three callers need the same answer and the interesting
+ * part is the default rather than the field: absent means `flag` for a wired
+ * agent and `none` for an unwired one.
+ */
+export declare function briefMode(p: AgentProfile): 'flag' | 'typed' | 'none';
 export declare class ProfileRegistry {
     private profiles;
     constructor(profiles?: Record<string, AgentProfile>);

package/dist/agents/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/agents/profiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,GAAG,EAAE,OAAO,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA8CzD,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAInD,oEAAoE;IACpE,MAAM,CAAC,IAAI,IAAI,eAAe;IA8B9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAMjC,IAAI,IAAI,YAAY,EAAE;IAItB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAIjC;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAElF"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/agents/profiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,GAAG,EAAE,OAAO,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAItB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAIlB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAkNzD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAEpE;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAInD,oEAAoE;IACpE,MAAM,CAAC,IAAI,IAAI,eAAe;IAyC9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAMjC,IAAI,IAAI,YAAY,EAAE;IAItB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAIjC;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAElF"}

package/dist/agents/profiles.js

@@ -9,8 +9,42 @@ function defaultShell() {
 }
 /**
  * Built-in profiles. All Claude Code flags here are verified against the CLI:
- * --mcp-config, --strict-mcp-config, --session-id, --settings,
- * --append-system-prompt-file, --resume.
+ * --mcp-config, --session-id, --settings, --append-system-prompt-file,
+ * --resume.
+ *
+ * `--mcp-config` deliberately arrives *without* `--strict-mcp-config`. Strict
+ * mode makes the named file the whole of the agent's MCP configuration, which
+ * silently drops every server the user set up for themselves — an agent
+ * started here would be missing the tools it has everywhere else, with nothing
+ * on screen to say why. Without it the hub's server is one more entry beside
+ * theirs, which is the only version of "wired to the hub" worth having.
+ *
+ * Codex and Gemini are wired too, and every flag and key below was verified
+ * against the CLI actually installed - codex-cli 0.153.4 and gemini 0.58.0 -
+ * rather than written from memory. Both reach the hub the same way Claude
+ * Code does, over one streamable-HTTP MCP server carrying a bearer token, and
+ * neither needs a byte written to config the user owns:
+ *
+ * - **Codex** takes `-c <dotted.key>=<toml>` on any invocation, so the server
+ *   is declared in argv for the one run. The token is *not* in argv - it goes
+ *   in the environment, and `bearer_token_env_var` names the variable to read
+ *   it from, which keeps it out of every process listing on the machine.
+ * - **Gemini** has no per-run config flag, but
+ *   `GEMINI_CLI_SYSTEM_SETTINGS_PATH` repoints its system settings layer at a
+ *   file of our choosing, which the hub generates per session.
+ *
+ * - **opencode** turned out to be the least invasive of the three and was
+ *   assumed to be the hardest. It reads its entire config from
+ *   `OPENCODE_CONFIG_CONTENT`, so nothing is written anywhere at all, and what
+ *   it is given is merged with the user's own config rather than replacing it.
+ *   The assumption that it had no per-run route came from reading
+ *   `opencode mcp add` - which does write to the user's file, and ignores
+ *   `OPENCODE_CONFIG` when it does - and mistaking that command for the only
+ *   way in.
+ *
+ * `shell` is the only profile left that is not an agent, and it is not one in
+ * a way no flag can fix: it runs a shell, so text typed at it is executed
+ * rather than read.
  */
 export const BUILTIN_PROFILES = {
     claude: {
@@ -20,7 +54,6 @@ export const BUILTIN_PROFILES = {
         args: [
             '--mcp-config',
             '{{mcp_config_path}}',
-            '--strict-mcp-config',
             '--session-id',
             '{{session_uuid}}',
             '--settings',
@@ -32,13 +65,25 @@ export const BUILTIN_PROFILES = {
         mcp: true,
         status: 'hooks',
         inject: 'bracketed',
+        versionArgs: ['--version'],
+        /*
+         * Claude Code has no listing command, so this is the declared half of
+         * "ask where you can, declare where you cannot". Exactly the aliases
+         * `claude --help` names for --model; a full name like `claude-fable-5` is
+         * accepted too, which is why a template must not be limited to this list.
+         */
+        models: ['fable', 'opus', 'sonnet'],
+        // Both verified against `claude --help`: --model takes an alias or a full
+        // name, --effort takes low, medium, high, xhigh or max.
+        modelArgs: ['--model', '{{model}}'],
+        effortArgs: ['--effort', '{{effort}}'],
+        efforts: ['low', 'medium', 'high', 'xhigh', 'max'],
         // Resume swaps --session-id for --resume; everything else is re-templated
         // identically, and crucially the session is relaunched in the same cwd,
         // because Claude Code keys its conversation store by working directory.
         resumeArgs: [
             '--mcp-config',
             '{{mcp_config_path}}',
-            '--strict-mcp-config',
             '--resume',
             '{{session_uuid}}',
             '--settings',
@@ -47,6 +92,151 @@ export const BUILTIN_PROFILES = {
             '{{brief_path}}',
         ],
     },
+    opencode: {
+        id: 'opencode',
+        description: 'opencode TUI, wired to the hub MCP endpoint',
+        command: 'opencode',
+        // Bare, which is its default subcommand and starts the TUI. `run` is the
+        // one-shot form and is not what a window on the canvas wants.
+        args: [],
+        /*
+         * The least invasive of the four, and the one that was assumed hardest.
+         * opencode reads its whole config from this variable, so there is no file
+         * anywhere - not even one of ours - and it is *merged* with the user's own
+         * config rather than replacing it, so their models, themes and their own
+         * MCP servers survive the session.
+         *
+         * Note what this deliberately does not use: `opencode mcp add` writes to
+         * ~/.config/opencode/opencode.json and ignores OPENCODE_CONFIG while doing
+         * it. Setting this variable also stops opencode writing its default config
+         * file on start, so a session leaves nothing behind at all.
+         */
+        env: { OPENCODE_CONFIG_CONTENT: '{{opencode_config}}' },
+        // `opencode models` writes ~/.config/opencode/opencode.jsonc when it finds
+        // no config at all, and detection runs on machines whose owner may never
+        // have run opencode by hand. An empty config is still a config, so this
+        // suppresses that without changing what the probe reports.
+        probeEnv: { OPENCODE_CONFIG_CONTENT: '{}' },
+        mcp: true,
+        brief: 'typed',
+        status: 'heuristic',
+        inject: 'bracketed',
+        versionArgs: ['--version'],
+        // Real enumeration: one provider/model per line, 395 of them on the
+        // machine this was written on.
+        modelsArgs: ['models'],
+        // `-m provider/model` is a top-level option, so it applies to the TUI and
+        // not only to `run`. Verified against `opencode --help`.
+        modelArgs: ['-m', '{{model}}'],
+        // No effortArgs on purpose: `--variant` is documented under `opencode run`
+        // and is not a top-level option, so the TUI this profile starts does not
+        // take one. A template asking for an effort here is refused at load.
+    },
+    codex: {
+        id: 'codex',
+        description: 'Codex CLI, wired to the hub MCP endpoint',
+        command: 'codex',
+        /*
+         * Bare, which starts the interactive TUI - `exec` is the one-shot form and
+         * is not what a window on the canvas wants.
+         *
+         * The two `-c` overrides are exactly the table `codex mcp add --url` would
+         * have written into ~/.codex/config.toml, except they live for one run and
+         * touch nothing. The value after `=` is parsed as TOML, which is why the
+         * URL is quoted.
+         */
+        args: [
+            '-c',
+            'mcp_servers.termscape.url="{{mcp_url}}"',
+            '-c',
+            'mcp_servers.termscape.bearer_token_env_var="TERMSCAPE_TOKEN"',
+        ],
+        // The token is named here rather than written into argv: `-c` values land
+        // in the process command line, where every other user on the machine can
+        // read them.
+        env: { TERMSCAPE_TOKEN: '{{token}}' },
+        mcp: true,
+        brief: 'typed',
+        status: 'heuristic',
+        inject: 'bracketed',
+        versionArgs: ['--version'],
+        /*
+         * `codex debug models` does render the real catalog, but it is a debug
+         * command by its own description and it answers with 500KB of JSON that
+         * also carries every model's system prompt - not the one-per-line stdout
+         * `modelsArgs` reads. So this is the declared half of "ask where you can,
+         * declare where you cannot": the slugs that catalog marks
+         * `visibility: "list"`. A full name not in this list is still accepted,
+         * which is why a template must not be limited to it.
+         */
+        models: ['gpt-6-astra', 'gpt-5.6-sol', 'gpt-5.6-terra', 'gpt-5.6-luna', 'gpt-5.5', 'gpt-5.2'],
+        modelArgs: ['-m', '{{model}}'],
+        /*
+         * Codex has no `--effort`; reasoning depth is a config key, and it takes
+         * the same `-c` route as the MCP server above. Verified by reading it back
+         * off the `reasoning effort:` line of the session header.
+         *
+         * The levels are the union of `supported_reasoning_levels` across the
+         * listed models. They are per model in the catalog and Codex forwards
+         * whatever it is given without checking, so this list is what the dialog
+         * offers and never a limit the hub enforces.
+         */
+        effortArgs: ['-c', 'model_reasoning_effort="{{effort}}"'],
+        efforts: ['low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
+        /*
+         * No resumeArgs, and not an oversight. `codex resume` takes a session id,
+         * but Codex mints that id itself and offers no way to be handed one, so
+         * the hub cannot record up front what it would have to ask for later.
+         * `--last` is the alternative and it resolves to "the most recent session
+         * in this cwd", which is the wrong agent as soon as a workspace holds two
+         * of them. Better to say plainly it restarts clean.
+         */
+    },
+    gemini: {
+        id: 'gemini',
+        description: 'Gemini CLI, wired to the hub MCP endpoint',
+        command: 'gemini',
+        /*
+         * Gemini refuses to start MCP servers in a folder it does not trust, and
+         * says so only as a warning on stderr - the agent would come up looking
+         * fine with no tools. `--skip-trust` trusts the workspace for this session
+         * and writes nothing; the alternative, turning folder trust off in the
+         * settings file below, would disable the check for everything else too.
+         */
+        args: ['--skip-trust'],
+        // No `--mcp-config` equivalent exists. This repoints the *system* settings
+        // layer - normally a machine-wide file - at the per-session one the hub
+        // generates, so ~/.gemini/settings.json is never opened, let alone written.
+        env: { GEMINI_CLI_SYSTEM_SETTINGS_PATH: '{{gemini_settings_path}}' },
+        mcp: true,
+        brief: 'typed',
+        status: 'heuristic',
+        inject: 'bracketed',
+        versionArgs: ['--version'],
+        // Declared: there is no `gemini models`. These are the model constants the
+        // CLI itself names, minus the ones it uses internally for embeddings and
+        // its visual agent, which are not things to point an agent window at.
+        models: [
+            'gemini-3.1-pro-preview',
+            'gemini-3-pro-preview',
+            'gemini-3.5-flash',
+            'gemini-3-flash',
+            'gemini-3.1-flash-lite',
+            'gemini-2.5-pro',
+            'gemini-2.5-flash',
+        ],
+        modelArgs: ['-m', '{{model}}'],
+        /*
+         * No effortArgs: `gemini --help` documents no reasoning-effort option, so
+         * a template naming one for this agent is refused at load rather than
+         * dropped at launch.
+         *
+         * No resumeArgs either, for a narrower reason than Codex's. `--session-id`
+         * does accept a UUID of our choosing, but `--resume` takes "latest" or an
+         * index into a list - never that UUID - so the id the hub could record is
+         * not an id it could resume by.
+         */
+    },
     shell: {
         id: 'shell',
         description: 'Plain terminal, no agent wiring',
@@ -54,11 +244,29 @@ export const BUILTIN_PROFILES = {
         args: [],
         env: {},
         mcp: false,
+        // Said out loud rather than left to the default, because this is the one
+        // profile where being typed at is actively harmful: a shell runs what it
+        // is given. It can still be *sent* a message - the router writes to any
+        // running window - and that is the human's business, not the hub's.
+        brief: 'none',
         status: 'heuristic',
         readyHint: '[$#>%] ?$',
         inject: 'raw',
+        // Nothing to detect: it is whatever COMSPEC or SHELL points at, it is
+        // always there, and asking a shell its version means something different
+        // on every platform.
     },
 };
+/**
+ * How this profile's brief travels, with the defaults applied.
+ *
+ * One place, because three callers need the same answer and the interesting
+ * part is the default rather than the field: absent means `flag` for a wired
+ * agent and `none` for an unwired one.
+ */
+export function briefMode(p) {
+    return p.brief ?? (p.mcp ? 'flag' : 'none');
+}
 export class ProfileRegistry {
     profiles;
     constructor(profiles) {
@@ -74,6 +282,10 @@ export class ProfileRegistry {
                 for (const [id, v] of Object.entries(raw)) {
                     if (typeof v !== 'object' || v === null)
                         continue;
+                    // `[template.reviewer]` parses as one table named `template`, and it
+                    // belongs to TemplateRegistry rather than here.
+                    if (id === 'template')
+                        continue;
                     const base = merged[id];
                     merged[id] = {
                         id,
@@ -85,7 +297,15 @@ export class ProfileRegistry {
                         status: v.status ?? base?.status ?? 'heuristic',
                         readyHint: v.ready_hint ?? v.readyHint ?? base?.readyHint,
                         inject: v.inject ?? base?.inject ?? 'bracketed',
+                        brief: v.brief ?? base?.brief,
                         resumeArgs: v.resume_args ?? v.resumeArgs ?? base?.resumeArgs,
+                        probeEnv: v.probe_env ?? v.probeEnv ?? base?.probeEnv,
+                        versionArgs: v.version_args ?? v.versionArgs ?? base?.versionArgs,
+                        modelsArgs: v.models_args ?? v.modelsArgs ?? base?.modelsArgs,
+                        models: v.models ?? base?.models,
+                        modelArgs: v.model_args ?? v.modelArgs ?? base?.modelArgs,
+                        effortArgs: v.effort_args ?? v.effortArgs ?? base?.effortArgs,
+                        efforts: v.efforts ?? base?.efforts,
                     };
                 }
             }

package/dist/agents/profiles.js.map

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

package/dist/agents/templates.d.ts

@@ -0,0 +1,100 @@
+import type { AgentTemplateInfo, TemplateSource } from '../protocol/index.js';
+import type { Store } from '../db/store.js';
+import type { ProfileRegistry } from './profiles.js';
+/**
+ * A template is an agent plus a model, an effort and an opening instruction.
+ *
+ * Starting an agent used to ask exactly one question - which CLI - and
+ * everything that actually distinguishes one agent from another was missing.
+ * A template is a saved answer to all four, picked once instead of typed every
+ * time.
+ *
+ * On the words, because this file cannot be written without settling them:
+ *
+ * - **agent** is the CLI program, which the code calls a *profile*. That name
+ *   stays internal: it is the recipe for launching one CLI.
+ * - **template** is what a human picks from a list.
+ * - **session** is one running instance, with an address and a window.
+ *
+ * A template that names only an agent is exactly today's behaviour, which is
+ * why every profile gets one for free and nothing that works now stops
+ * working.
+ */
+export interface AgentTemplate {
+    id: string;
+    description: string;
+    /** Profile id. */
+    agent: string;
+    model?: string;
+    effort?: string;
+    /**
+     * Typed into the terminal once the CLI is up, not written into argv - in
+     * argv it would be a different thing entirely, and written immediately it
+     * lands before the program is reading.
+     */
+    prompt?: string;
+    /**
+     * Extra environment for the agent process, merged over what its profile
+     * sets. Values only — no expansion of any kind, so a value containing
+     * `{{...}}` reaches the process as typed.
+     */
+    env: Record<string, string>;
+    /**
+     * Why this template cannot be used, when it cannot.
+     *
+     * Kept rather than dropped, for the same reason a missing agent stays in the
+     * list: a template that silently vanished looks like the config was ignored.
+     * A template asking for an effort on an agent that has no effort setting is
+     * a configuration error worth reporting here, at load, and not a flag
+     * quietly dropped at launch.
+     */
+    error?: string;
+    /**
+     * Where this one came from, which is what decides whether the panel may
+     * edit it.
+     *
+     * - `derived` — the free template every agent gets under its own name.
+     *   Nothing is stored for it, so editing one means creating a stored
+     *   template that shadows it, and there is nothing to remove.
+     * - `stored` — made from the panel, in `state.db`. Editable and removable.
+     * - `file` — declared in `~/.termscape/agents.toml`. Read-only here: it is
+     *   the user's file and the hub does not write it.
+     */
+    source: TemplateSource;
+}
+/**
+ * Check a template against the agent it names.
+ *
+ * Returns the reason it cannot be used, or null. This is where "the agent
+ * declares how to spell it" is enforced: a template holds *values*, and a
+ * value nobody can spell on the command line is not a template, it is a typo
+ * that would otherwise be discovered at launch.
+ */
+export declare function validate(t: AgentTemplate, profiles: ProfileRegistry): string | null;
+/**
+ * What a process will actually accept as a variable name.
+ *
+ * Deliberately strict rather than permissive: a name with a space or an `=` in
+ * it is silently dropped by some shells and rejected by others, and finding
+ * that out at launch — as a missing key rather than an error — is exactly the
+ * kind of thing templates are validated at load to avoid.
+ */
+export declare function isEnvName(name: string): boolean;
+export declare class TemplateRegistry {
+    private readonly templates;
+    constructor(templates: Record<string, AgentTemplate>);
+    /**
+     * One bare template per agent, overlaid with `[template.x]` from
+     * ~/.termscape/agents.toml.
+     *
+     * A broken file falls back to the bare set rather than taking the hub down,
+     * exactly as the profile loader does - the two live in the same file, and
+     * failing differently for the two halves of it would be its own surprise.
+     */
+    static load(profiles: ProfileRegistry, store?: Store): TemplateRegistry;
+    get(id: string): AgentTemplate | null;
+    list(): AgentTemplate[];
+    /** What the browser is given to build the picker from. */
+    info(): AgentTemplateInfo[];
+}
+//# sourceMappingURL=templates.d.ts.map

package/dist/agents/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/agents/templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB;AA2BD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,GAAG,IAAI,CAaf;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAmBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;gBAE9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAIpD;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,gBAAgB;IA4DvE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIrC,IAAI,IAAI,aAAa,EAAE;IAIvB,0DAA0D;IAC1D,IAAI,IAAI,iBAAiB,EAAE;CAa5B"}