@kdonev/termscape 0.1.0 → 0.1.1

package/dist/agents/profiles.js

@@ -11,6 +11,33 @@ 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.
+ *
+ * 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: {
@@ -32,6 +59,19 @@ 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.
@@ -47,6 +87,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 +239,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 +277,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 +292,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,85 @@
+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;
+    /**
+     * 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;
+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;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,GAAG,IAAI,CAUf;AAED,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;IA2DvE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIrC,IAAI,IAAI,aAAa,EAAE;IAIvB,0DAA0D;IAC1D,IAAI,IAAI,iBAAiB,EAAE;CAY5B"}

package/dist/agents/templates.js

@@ -0,0 +1,133 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { parse as parseToml } from 'smol-toml';
+import { paths } from '../paths.js';
+/** The trivial template for a profile: this agent, nothing else specified. */
+function bare(profile) {
+    return {
+        id: profile.id,
+        description: profile.description,
+        agent: profile.id,
+        source: 'derived',
+    };
+}
+/** One the user made from the panel, as it comes out of the database. */
+function fromStored(t, profiles) {
+    return {
+        id: t.id,
+        description: t.description ?? profiles.get(t.agent)?.description ?? t.id,
+        agent: t.agent,
+        model: t.model ?? undefined,
+        effort: t.effort ?? undefined,
+        prompt: t.prompt ?? undefined,
+        source: 'stored',
+    };
+}
+/**
+ * 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 function validate(t, profiles) {
+    const agent = profiles.get(t.agent);
+    if (!agent)
+        return `unknown agent "${t.agent}"`;
+    if (t.model !== undefined && !agent.modelArgs) {
+        return `${t.agent} does not take a model on the command line`;
+    }
+    if (t.effort !== undefined && !agent.effortArgs) {
+        return `${t.agent} has no effort setting`;
+    }
+    return null;
+}
+export class TemplateRegistry {
+    templates;
+    constructor(templates) {
+        this.templates = templates;
+    }
+    /**
+     * 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, store) {
+        const merged = Object.fromEntries(profiles.list().map((p) => [p.id, bare(p)]));
+        /*
+         * Stored over derived, file over stored.
+         *
+         * Stored beats derived because a bare template is only a default: making
+         * one called `claude` with a model on it is exactly how you say "when I
+         * pick claude, I mean this". File beats stored because someone who wrote a
+         * template by hand meant it, and a UI silently overriding their file is
+         * worse than a UI refusing an id the file has claimed - which is what the
+         * hub does on create.
+         */
+        if (store) {
+            for (const t of store.listStoredTemplates()) {
+                merged[t.id] = fromStored(t, profiles);
+            }
+        }
+        const file = paths.profiles();
+        if (existsSync(file)) {
+            try {
+                const raw = parseToml(readFileSync(file, 'utf8'));
+                // `[template.reviewer]` parses as one table named `template`, which is
+                // also why "template" is not usable as an agent id.
+                const declared = raw.template;
+                if (typeof declared === 'object' && declared !== null) {
+                    for (const [id, v] of Object.entries(declared)) {
+                        if (typeof v !== 'object' || v === null)
+                            continue;
+                        const t = v;
+                        const agent = typeof t.agent === 'string' ? t.agent : id;
+                        merged[id] = {
+                            id,
+                            description: typeof t.description === 'string'
+                                ? t.description
+                                : (profiles.get(agent)?.description ?? id),
+                            agent,
+                            model: typeof t.model === 'string' ? t.model : undefined,
+                            effort: typeof t.effort === 'string' ? t.effort : undefined,
+                            prompt: typeof t.prompt === 'string' ? t.prompt : undefined,
+                            source: 'file',
+                        };
+                    }
+                }
+            }
+            catch (err) {
+                console.error(`[templates] ignoring ${file}: ${err.message}`);
+            }
+        }
+        for (const t of Object.values(merged)) {
+            const problem = validate(t, profiles);
+            if (problem)
+                t.error = problem;
+        }
+        return new TemplateRegistry(merged);
+    }
+    get(id) {
+        return this.templates[id] ?? null;
+    }
+    list() {
+        return Object.values(this.templates);
+    }
+    /** What the browser is given to build the picker from. */
+    info() {
+        return this.list().map((t) => ({
+            id: t.id,
+            description: t.description,
+            agent: t.agent,
+            model: t.model ?? null,
+            effort: t.effort ?? null,
+            prompt: t.prompt ?? null,
+            error: t.error ?? null,
+            source: t.source,
+        }));
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/agents/templates.js.map

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

package/dist/agents/wiring.d.ts

@@ -1,4 +1,4 @@
-import type { AgentProfile } from './profiles.js';
+import { type AgentProfile } from './profiles.js';
 /**
  * Everything an agent process needs on disk before it starts: its MCP config,
  * its hook settings, and its brief. All generated per launch into
@@ -20,11 +20,40 @@ export interface WiringOutput {
     mcpConfigPath: string;
     settingsPath: string;
     briefPath: string;
+    /**
+     * Gemini CLI reads no `--mcp-config`; the only per-run way in is
+     * GEMINI_CLI_SYSTEM_SETTINGS_PATH, which points its *system* settings layer
+     * at a file of our choosing. Written for every wired session rather than
+     * only for gemini, so a profile stays a config entry naming a path and not
+     * a special case in this file.
+     */
+    geminiSettingsPath: string;
+    /**
+     * opencode's whole config, as a JSON string for an environment variable.
+     *
+     * The odd one out, and the least invasive of the three: opencode reads
+     * `OPENCODE_CONFIG_CONTENT` directly, so there is no file at all - not even
+     * one of ours. 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.
+     */
+    opencodeConfig: string;
 }
+/**
+ * Where a session's brief is written. Exported because an agent with no
+ * `--append-system-prompt-file` has its brief typed into the terminal
+ * instead, and the hub needs to read back what was written here.
+ */
+export declare function briefFileFor(sessionId: string): string;
 export declare function writeWiring(input: WiringInput): WiringOutput;
 /**
  * Without this an agent has no idea why text is appearing in its input, or
  * that it has an identity and peers at all.
+ *
+ * An unwired agent gets a shorter one. It is not a courtesy: the router writes
+ * to any running window it can resolve an address for, so such an agent can be
+ * messaged whether or not it was ever told messaging exists - and the
+ * paragraph telling it that a `[from ...]` line is a colleague rather than the
+ * human is exactly the paragraph it would otherwise be missing.
  */
 export declare function renderBrief(input: WiringInput): string;
 //# sourceMappingURL=wiring.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../src/agents/wiring.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAsE5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAiDtD"}
+{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../src/agents/wiring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAgD5D;AAwID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAuEtD"}