@sagmans/dsh-tui 0.6.0 → 0.7.0

package/.agents/skills/dsh-tui-update-models/references/model-wiring.md

@@ -0,0 +1,162 @@
+# Model wiring reference
+
+Companion to [SKILL.md](../SKILL.md): exact fields, files, and checks.
+
+## Resolution order
+
+1. Bundle layers in `cordis.yml`, in order.
+2. The profile patch `~/.dsh/profiles/<profile>/cordis.patch.yml`, entry by entry:
+   `id` targeted config, `disabled`, `insert`.
+3. A patch `config` **replaces** that row's base config; fields it omits fall back
+   to the schema default, not to the bundle's value.
+4. The model directory a profile sees is owned by whichever row is enabled:
+   `llm-pi-ai` (additive provider config), `dsh-provider-extra` (owned catalog),
+   or both, if the profile is not using exclusive ownership.
+
+Exclusive ownership is a set of disable rows plus the catalog itself:
+
+```yaml
+- { "id": "agent-default-model", "disabled": true }
+- { "id": "llm-pi-ai", "disabled": true }
+- { "id": "llm-deepseek", "disabled": true }
+- id: dsh-provider-extra
+  config: { catalog: { version: 1, ... } }
+```
+
+## `llm-pi-ai` provider config
+
+```yaml
+- id: llm-pi-ai
+  config:
+    providers:
+      qwen-token-plan:
+        apiKeyEnv: QWEN_TOKEN_PLAN_API_KEY   # env var holding the key
+        baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
+        api: openai-completions              # optional wire override
+        models:
+          - id: qwen3.8-max                  # served as-is
+          - id: deepseek-v4.1-flash
+            name: DeepSeek V4.1 Flash
+            contextWindow: 1000000
+            maxTokens: 384000
+            input: [text, image]
+            reasoningEfforts: { low: low, high: high, max: max }
+            compat:
+              supportsStore: false
+              supportsDeveloperRole: false
+              supportsReasoningEffort: true
+              supportsStrictMode: true
+              thinkingFormat: qwen
+```
+
+An id that the installed catalog already describes needs no restatement. An id it
+does not describe needs the metadata (or a `template` sibling to clone).
+
+## `dsh-provider-extra`
+
+Two config generations exist; a profile normally uses one:
+
+| Config | Use |
+| --- | --- |
+| Additive: `routeId`, `displayName`, `apiKeyEnv`, `fallbackSessionId`, `extraModels`, `models`, `codexExtraModels`, `codexModels`, `codexTransport` | add a gateway or subscription route beside whatever else the profile serves |
+| `catalog` v1 | own the entire directory: ids, aliases, metadata, and the default selection |
+
+Catalog fields:
+
+```yaml
+catalog:
+  version: 1                      # exactly 1
+  default:                        # null only when the catalog is empty
+    { provider: opencode-go-session, model: deepseek-flash, reasoningEffort: max }
+  providers:
+    - id: opencode-go-session     # the id every selection and alias check uses
+      name: OpenCode Go (session)
+      source: opencode-go         # pi-ai provider id: its installed data is the base
+      baseURL: https://api.x.ai/v1            # optional
+      transport: sse                          # optional
+      fallbackSessionId: dsh-provider-extra   # optional
+      auth: { apiKeyRef: OPENCODE_GO_API_KEY }        # or { credentialProvider: openai-codex }
+      models:
+        - id: deepseek-flash
+          name: DeepSeek V4.1 Flash
+          aliases: [deepseek-v4.1-flash]      # extra ids that resolve to this model
+          template: deepseek-v4-flash         # clone wire behavior when the source lacks the id
+          defaultMaxTokens: 384000            # request ceiling; metadata.maxTokens overrides
+          metadata:
+            api: openai-completions
+            reasoning: true
+            input: [text, image]
+            cost: { input: 0.22, output: 0.66, cacheRead: 0.007, cacheWrite: 0 }
+            contextWindow: 1000000
+            maxTokens: 384000
+            thinkingLevelMap: { off: null, minimal: null, low: low, medium: null, high: high, xhigh: null, max: max }
+            compat: { supportsStore: false, supportsDeveloperRole: false, supportsReasoningEffort: true, supportsStrictMode: true, thinkingFormat: qwen }
+```
+
+Behaviour:
+
+| Case | Result |
+| --- | --- |
+| `template` names a sibling the source ships | clone its wire behavior and metadata |
+| `template` names nothing | that model lands in the route's diagnostics; the rest of the route still serves |
+| a `models` whitelist names an id nothing provides | the whole route is refused - a typo there is a broken deployment |
+| two providers share an id | composition error |
+| `default` names a model outside the catalog | composition error |
+| `reasoningEffort` unsupported by the model | composition error |
+
+## Where the base data comes from
+
+```sh
+# the harness install owns the pi-ai catalog the profile resolves against
+DSH=$(readlink -f "$(command -v dsh)")
+PI_AI="${DSH%/lib/bin.js}/node_modules/@earendil-works/pi-ai"
+ls "$PI_AI/dist/providers/data"      # one JSON per provider source, keyed by api
+```
+
+A JSON entry is the whole truth for a `source`: `id`, `name`, `cost`,
+`contextWindow`, `maxTokens`, `input`, `reasoning`, `thinkingLevelMap`, `compat`.
+A model declared without `template` and without `metadata` is served exactly as
+this file describes it, so an id the vendor renamed or repriced shows stale
+numbers until the catalog declares them. An entry that carries its own complete
+`metadata` needs no installed entry at all, which is how a route the harness does
+not describe is wired.
+
+## Credentials
+
+| Field | Meaning |
+| --- | --- |
+| `apiKeyEnv` | read the key from this environment variable |
+| `apiKeyRef` | read it from the profiles' stored credentials under this reference |
+| `credentialProvider` | use a login flow's stored credentials (codex subscriptions) |
+
+Keys never belong in a patch, a settings file, or a repository. Put launch-time
+values in `$DSH_HOME/.env` or the environment. A provider row whose credential is
+missing fails its route only; other routes still serve.
+
+## Verify
+
+```sh
+dsh --profile tui list-models        # provider/model<TAB>display name, one per reachable route
+~/.agents/skills/dsh-tui-update-models/scripts/dump-model-catalog.mjs --home "$DSH_HOME"
+```
+
+`list-models` exits zero only after printing a line, so a deployment that
+advertises nothing cannot pass for one that was enumerated.
+
+For every model you touched, confirm against the vendor's own page:
+
+1. price per 1M tokens for input, output, cached input, cache write;
+2. context window and maximum output tokens (a "272K" beside "above 272K input
+   is priced 2x" is a billing threshold, not the window);
+3. the accepted reasoning effort values, and how the vendor spells "no reasoning"
+   (OpenAI: `none`; codex: omit the parameter);
+4. whether the route bills per token at all - a credit or token plan wants cost
+   `0`, a metered API wants its published rates;
+5. that an `xhigh` or `max` mapping exists when the vendor documents one.
+
+A model with no vendor page (stealth releases, previews) is documented only by the
+routing catalog: its pi.dev model page and `models.dev/api.json`.
+
+Then run the profile against a cloned home before the real one - see the
+`dsh-tui-dogfood` skill - and `pnpm run build` any linked bundle first: a linked
+profile loads `lib/`, not `src/`.

package/.agents/skills/dsh-tui-update-models/scripts/dump-model-catalog.mjs

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+/**
+ * Print the model directory a dsh profile resolves, with the provenance of
+ * every field.
+ *
+ * The surface reads prices, context windows, and reasoning levels from the
+ * composition, not from the vendor's page, so an inherited or stale value is
+ * invisible in the UI. This reads the same two inputs the resolver does - the
+ * owned catalog in the profile patch, and the installed pi-ai provider data -
+ * and names where each number came from: "installed" for the source's own
+ * entry, "template:<id>" for a clone, "metadata" for what the catalog declares.
+ * An entry the catalog spells out completely needs no installed entry at all,
+ * so a missing harness install must not hide it.
+ *
+ * Usage: dump-model-catalog.mjs [--home <dsh home>] [--profile <name>] [--json]
+ */
+import { execFileSync } from 'node:child_process'
+import { readFileSync, realpathSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
+/** Fields a catalog entry may inherit, and the layer each value came from. */
+const INHERITED_FIELDS = ['contextWindow', 'maxTokens', 'cost', 'input', 'reasoning', 'thinkingLevelMap', 'api']
+const INSTALLED = 'installed'
+const METADATA = 'metadata'
+const ABSENT = 'none'
+
+/** The levels pi-ai offers: a null mapping removes one, and xhigh/max need one. */
+export function supportedLevels(levelMap) {
+  return LEVELS.filter((level) => {
+    const mapped = levelMap?.[level]
+    if (mapped === null) return false
+    if (level === 'xhigh' || level === 'max') return mapped !== undefined
+    return true
+  })
+}
+
+function parseArgs(argv) {
+  const options = { home: process.env.DSH_HOME ?? join(homedir(), '.dsh'), profile: 'tui', json: false }
+  for (let index = 0; index < argv.length; index += 1) {
+    const flag = argv[index]
+    if (flag === '--json') options.json = true
+    else if (flag === '--home') options.home = argv[++index]
+    else if (flag === '--profile') options.profile = argv[++index]
+    else throw new Error('unknown argument ' + flag)
+  }
+  return options
+}
+
+/** The pi-ai data directory of the harness install the launcher belongs to. */
+function dataDirectory() {
+  try {
+    const bin = execFileSync('sh', ['-c', 'command -v dsh'], { encoding: 'utf8' }).trim()
+    const root = join(realpathSync(bin), '..', '..')
+    return join(root, 'node_modules', '@earendil-works', 'pi-ai', 'dist', 'providers', 'data')
+  } catch {
+    // No harness install is a supported reading: declared entries still resolve.
+    return undefined
+  }
+}
+
+/** Every JSON patch entry that configures the owned catalog, last one winning. */
+export function catalogConfig(patch) {
+  const lines = readFileSync(patch, 'utf8').split('\n')
+  let catalog
+  for (const line of lines) {
+    if (!line.startsWith('- {') || !line.includes('"catalog"')) continue
+    const entry = JSON.parse(line.slice(2))
+    if (entry.config?.catalog !== undefined) catalog = entry.config.catalog
+  }
+  return catalog
+}
+
+export function providerData(directory, source) {
+  if (directory === undefined) return undefined
+  try {
+    return JSON.parse(readFileSync(join(directory, source + '.json'), 'utf8'))
+  } catch {
+    return undefined
+  }
+}
+
+/** Look one id up across a provider's api maps; an api in the spec disambiguates. */
+function lookup(data, id, api) {
+  if (data === undefined) return undefined
+  for (const [key, models] of Object.entries(data)) {
+    if ((api === undefined || key === api) && models[id] !== undefined) return { ...models[id], api: models[id].api ?? key }
+  }
+  return undefined
+}
+
+/** Resolve one catalog entry against the installed data it may inherit from. */
+export function resolve(spec, data) {
+  const metadata = spec.metadata ?? {}
+  const declared = Object.keys(metadata).length > 0
+  const cloneOf = spec.template ?? spec.id
+  const base = lookup(data, cloneOf, metadata.api)
+  if (base === undefined && !declared) {
+    return { error: 'no source entry for ' + cloneOf + '; declare a template or metadata' }
+  }
+  const merged = { ...base, ...metadata, id: spec.id, name: spec.name ?? base?.name ?? spec.id }
+  merged.maxTokens = metadata.maxTokens ?? spec.defaultMaxTokens ?? base?.maxTokens
+  const origins = {}
+  for (const field of INHERITED_FIELDS) {
+    const declaredValue = field === 'maxTokens' ? metadata.maxTokens ?? spec.defaultMaxTokens : metadata[field]
+    if (declaredValue !== undefined) origins[field] = METADATA
+    else if (base === undefined) origins[field] = ABSENT
+    else origins[field] = spec.template === undefined ? INSTALLED : 'template:' + spec.template
+  }
+  return { model: merged, origins, levels: supportedLevels(merged.thinkingLevelMap) }
+}
+
+function rowsOf(catalog, directory) {
+  const rows = []
+  for (const provider of catalog.providers ?? []) {
+    const data = providerData(directory, provider.source)
+    for (const spec of provider.models ?? []) {
+      const result = resolve(spec, data)
+      const route = provider.id + '/' + spec.id
+      if (result.error !== undefined) {
+        rows.push({ route, error: result.error })
+        continue
+      }
+      const cost = result.model.cost ?? {}
+      rows.push({
+        route,
+        name: result.model.name,
+        api: result.model.api,
+        contextWindow: result.model.contextWindow,
+        maxTokens: result.model.maxTokens,
+        cost: '$' + [cost.input, cost.output, cost.cacheRead, cost.cacheWrite].join('/') + ' per 1M',
+        levels: result.levels.join(','),
+        origins: INHERITED_FIELDS
+          .map(field => [field, result.origins[field]])
+          .filter(([, origin]) => origin !== INSTALLED)
+          .map(([field, origin]) => field + '=' + origin)
+          .join(' ') || 'all installed',
+      })
+    }
+  }
+  return rows
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2))
+  const patch = join(options.home, 'profiles', options.profile, 'cordis.patch.yml')
+  const catalog = catalogConfig(patch)
+  if (catalog === undefined) {
+    process.stderr.write('no owned catalog in ' + patch + '\n'
+      + 'this profile wires models another way; see references/model-wiring.md\n')
+    process.exit(1)
+  }
+  const directory = dataDirectory()
+  if (directory === undefined) {
+    process.stderr.write('no harness install found; entries that inherit from it cannot be checked\n')
+  }
+  const rows = rowsOf(catalog, directory)
+  const unresolved = rows.filter(row => row.error !== undefined).length
+  if (options.json) {
+    process.stdout.write(JSON.stringify({ default: catalog.default ?? null, rows }, null, 2) + '\n')
+  } else {
+    for (const row of rows) {
+      if (row.error !== undefined) {
+        process.stdout.write(row.route + '\n  UNRESOLVED: ' + row.error + '\n')
+        continue
+      }
+      process.stdout.write(row.route + '\n  ' + row.name + ' | ' + row.api + ' | ctx ' + row.contextWindow
+        + ' | max ' + row.maxTokens + ' | ' + row.cost + ' | efforts ' + row.levels + '\n  inherited: ' + row.origins + '\n')
+    }
+    process.stdout.write('default: ' + JSON.stringify(catalog.default ?? null) + '\n')
+  }
+  process.exit(unresolved === 0 ? 0 : 1)
+}
+
+// Importing the resolver must not run the CLI: the spec reads it that way.
+if (process.argv[1] !== undefined && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) main()

package/README.md

@@ -6,7 +6,7 @@ Status: **v1 feature-complete; published on npm as `@sagmans/dsh-tui`.** The sur
 
 ## Install
 
-A profile keeps this plugin as one bundle layer. Install it from a checkout of this repository, or from the registry (`0.1.0` or later). Both paths need Node.js >= 22.19 and `pnpm` on `PATH`. Both need a real terminal: stdin and stdout must be TTYs.
+A profile keeps this plugin as one bundle layer. Install it from a checkout of this repository, or from the registry (`0.1.0` or later). Both paths need Node.js >= 22.19 and `pnpm` on `PATH`. Interactive sessions need a real terminal: stdin and stdout must be TTYs.
 
 ### From a plugin checkout
 
@@ -30,6 +30,33 @@ dsh --profile tui
 
 Releases are published, so this path works today. A checkout stays the path for unreleased work.
 
+### Install the dogfood skill (optional)
+
+Run this explicit command after you add the plugin:
+
+```sh
+dsh --profile tui install-skills
+```
+
+The command copies `dsh-tui-dogfood` to
+`~/.agents/skills/dsh-tui-dogfood/`. Agents can then load it from any dsh
+plugin repository. The skill uses a cloned dsh home, so tests do not change
+your real profile. A first install needs no TTY. `npm install` does not copy
+skills into your home.
+
+If the skill exists, the command asks `Update existing skill? [y/N]` in a
+terminal. Only `y` or `yes` replaces it. Enter or `n` keeps the existing
+copy. To update without a prompt, including in non-interactive runs, use:
+
+```sh
+dsh --profile tui install-skills --update
+```
+
+Updating removes any local changes inside the previous skill directory.
+The command stages the new copy before replacement and restores the old
+copy if replacement fails. If cleanup fails after replacement, the new copy
+stays installed and the command reports the old backup path.
+
 ### Confirm the plugin mounted
 
 The profile records its layers in `$DSH_HOME/profiles/tui/package.json` (`~/.dsh` by default). `@sagmans/dsh-tui` must appear in `dsh.profile.bundles`:
@@ -117,8 +144,18 @@ dsh --profile tui --preset minimal          # start in a shipped mode other than
 dsh --profile tui --model deepseek-chat
 dsh --profile tui --no-color
 dsh --profile tui --no-bell            # do not ring when a long turn finishes
+dsh --profile tui list-models          # print every provider/model the picker can reach
 ```
 
+`list-models` prints one line per route the `/model` picker can reach —
+`provider/model`, a tab, then the model's display name — in picker order:
+providers as the llm service registered them, then each provider's own model
+order. It writes plain stdout, so it works piped or redirected, never opens the
+alternate screen, and exits 0 after printing at least one route. When the
+profile has no llm service, when the provider listing cannot be read, or when
+nothing is configured to advertise a model, it names the reason on stderr and
+exits 1.
+
 Every key below is a shipped default. `/keys` opens every action the surface
 and its library can perform as a list you filter as you type, with the keys in
 force, and the `keys:` section moves any of them — see [Keys](#keys).
@@ -223,7 +260,7 @@ While a turn runs, a prompt submitted into the editor waits in the agent's own i
 
 Copying is read back through what the surface drew rather than through the screen, so a selection is the words alone: dragging across a message takes its box with it on screen, and the surface takes its own frame back out before the text reaches the clipboard — the sides, the padding beside them, and the rules above and below. A selection that covers a whole message, two of them, or a part of one is read the same way, and a row the transcript did not draw — the editor's own bar, a picker's card — is copied exactly as it read, and a selection that was nothing but frame is handed back as the reader made it, because a copy is never emptied. The frame still comes back in a copy taken with the terminal's own selection — Shift held while dragging, or a terminal that keeps selection to itself — which is the one path no program can filter.
 
-Every submitted line is also kept in a global prompt history at
+When prompt history is enabled, each submitted line is kept in a global history at
 `$DSH_HOME/prompt-history.json`. Typing the start of a prompt that was sent
 before draws the rest of the newest match after the cursor in a faint shade.
 `Ctrl+E` takes the whole suggestion and the word-movement key takes the next
@@ -328,8 +365,8 @@ must not also be a way to lose the work.
 
 Every styled element is a named token with a shipped default, and every key is
 an action with one, so the surface can be restyled and rebound without touching
-code. Preferences live in the same user-settings document as every other
-(`$DSH_HOME/settings.yaml`), under a `dsh-tui:` section:
+code. Released hosts with section APIs store preferences in
+`$DSH_HOME/settings.yaml`, under a `dsh-tui:` section:
 
 ```yaml
 dsh-tui:
@@ -364,6 +401,61 @@ dsh-tui:
       hidden: true            # the element renders nothing at all
 ```
 
+Config-backed source hosts store the same preference fields in the TUI entry's
+`config` in the active profile patch. Use the actual entry ID, normally `tui`,
+not the legacy `dsh-tui` namespace. For example:
+
+```yaml
+- id: tui
+  config:
+    theme: violet-orbit
+    history:
+      enabled: false
+      ghost: false
+```
+
+The plugin exports a Config schema for all preferences shown above, including
+`prefix`, `prefixWindow`, and `keys`. Launch fields such as `sessionId`,
+`model`, and `provider` remain separate from live preference edits.
+The settings service owns persistence. TUI does not create another preference store.
+It uses released `installSection` or `register` APIs, or Config-backed
+`describe` and revision-checked `update` APIs. Unsupported or read-only writes
+show a notice instead of reporting success. A rejected theme selection restores
+the applied theme, and `/theme tokens` reports that same appearance.
+
+On Config-backed hosts, absent `history.enabled` and `history.ghost` stay off.
+Set each switch to `true` explicitly to enable it. This prevents recording while
+the host's asynchronous legacy import is pending or has failed. Released section
+hosts retain their existing defaults. If the host reports unreadable preferences,
+history stays off. Readable `false` switches survive errors in other fields.
+Malformed updates retain the last valid appearance and do not overwrite their source.
+
+When public descriptors expose raw user layers, history checks those layers at use
+time. A readable opt-out survives rejected siblings even without a change event.
+Another rejected opt-in cannot clear this protection; a valid committed update can.
+A released-provider limit remains: after an absent user section, rejected scalar
+sections can produce identical public descriptors. TUI cannot detect that transition
+without host validity metadata, so normal released defaults remain active.
+
+The inspected source host has no legacy import alias from `dsh-tui` to `tui`.
+Exporting Config does not resolve that namespace mismatch. The host can rename
+`settings.yaml` to `settings.yaml.imported` before import completes.
+TUI does not retry or restore that file automatically. Preserve current privacy
+opt-outs and copy only the intended legacy fields into the actual TUI entry's
+`config`. Keep the original file for rollback.
+
+Live Config edits require the loaded schema runtime to create native volatile
+references. The released schemastery 3.18.2 implementation used by this checkout's
+unit tests lacks that API. A source host can resolve a different implementation
+with the same version label. TUI checks the loaded implementation and actual
+references, not the package version or CLI identity.
+
+If the loaded schema runtime lacks native support, TUI exports ordinary fields
+rather than unsupported live metadata. TUI then rejects Config-backed writes,
+and the host cannot import preferences through its volatile-field settings API.
+Reading row preferences still works, and ordinary profile changes use the host's
+reload lifecycle. Native schema-backed hosts can apply live preference updates.
+
 Every field is optional, so a section that changes one shade is enough. The
 document is hot-reloaded: an edit restyles a running session and re-arms the
 keymap on the next press, and `/theme` shows each element's effective value and
@@ -778,9 +870,11 @@ The workflow stores no npm token: the registry trusts `release.yml` on the `npm-
 
 - Two different things are called a preset. The agent mode (`--preset`, `/preset`) is fixed once a session has produced a turn; the permission preset (`/permission <preset>`, named in the status line) can change at any time.
 - `/model` changes the route and reasoning effort for the running session only. Catalog membership is advisory — an adapter may accept an id it does not advertise, while an explicit effort is checked against the route's own levels before it is applied. The picker offers the routes this deployment configured, not the ones it can prove credentialed: a provider whose key or sign-in is still missing appears like any other, and its first request names the missing credential.
+- Model discovery failures show a safe notice. Healthy provider catalogs remain selectable. Check provider configuration and credentials before retrying `/model`.
 - Scrolling is the mouse wheel, or the terminal's own scrollback keys where it offers them.
 - A turn that ran longer than ten seconds rings the terminal bell when it ends, because the reader may have walked away; `--no-bell` turns that off.
 - The dock shows the goal, plan mode, the todo items still to do, and any background job or delegation still running; a settled item leaves rather than turns into a completed row, and the list clears when the next turn opens so a fresh task never inherits the previous one's checklist. The transcript marks where older history was compacted away. `/plan` toggles plan mode; `/plan <message>` also steers that message, which is the base command's own behaviour.
+- The dock shows three running subagents by default. When more than three run, click the heading, overflow row, or blank cells in that section to show all. Click again to show three. Click a child’s text to view its transcript. Press `ctrl+b` to return.
 - Background jobs and subagent runs are live process state, not durable events: they disappear when the run ends, and a resumed session starts with an empty board and roster.
 - A card reads its tool's own render intent through the agent whose session is on screen, so a stored session with no live agent — one this process is not running, or a child that has already finished — folds to the generic card instead of the tool's own.
 - Reading a child's conversation does not move the terminal: commands, approvals, and the status line stay with the session you launched, and the transcript is the only thing that switches. The status line carries the way back, read from the map in force, so a remap shows up without reopening the view.
@@ -804,7 +898,7 @@ discipline as this one.
 | Plugin | What it adds |
 |---|---|
 | [`@sagmans/dsh-auto-compact`](https://github.com/sagmans/dsh-auto-compact) | An absolute token trigger for automatic compaction: the conversation condenses at `min(thresholdTokens, contextWindow × thresholdRatio)` instead of the window ratio alone, so a large-window model pays a fixed price, with per-route overrides. Its patch swaps the shipped `compaction-basic` backend — the same row this bundle already takes out of the global composition — so the profile still keeps exactly one compaction service, and this surface needs no setting for it. |
-| [`@sagmans/dsh-provider-extra`](https://github.com/sagmans/dsh-provider-extra) | Extra provider routes: OpenCode Go, which sends the live conversation id in `x-opencode-session` for routing and prompt caching, and OpenAI Codex over a ChatGPT subscription's OAuth flow with the harness credential store. Its routes join the `/model` picker like every configured provider. |
+| [`@sagmans/dsh-provider-extra`](https://github.com/sagmans/dsh-provider-extra) | Extra provider routes: OpenCode Go, which sends the live conversation id in `x-opencode-session` for routing and prompt caching, and OpenAI Codex over a ChatGPT subscription's OAuth flow with the harness credential store. Its routes join the `/model` picker like every configured provider. TUI also works without this package, using the core `llm` and `agentDefaultModel` services. |
 
 ```sh
 dsh plugin --profile tui add @sagmans/dsh-auto-compact

package/lib/agent/present.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAA;AA4BpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG,SAAS,GAAG,aAAa,CAqChG"}
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAgB,KAAK,aAAa,EAAwB,MAAM,aAAa,CAAA;AA4BpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG,SAAS,GAAG,aAAa,CAqChG"}

package/lib/agent/present.js

@@ -1,4 +1,5 @@
-import { cardOfCall, cardOfResult, contentLines, } from "../cards.js";
+import { cardOfCall, cardOfResult } from "../cards/presenter.js";
+import { contentLines } from "../cards.js";
 function parseArguments(argumentsJson) {
     try {
         return JSON.parse(argumentsJson);

package/lib/agent/present.js.map

@@ -1 +1 @@
-{"version":3,"file":"present.js","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,GAGb,MAAM,aAAa,CAAA;AAEpB,SAAS,cAAc,CAAC,aAAqB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAY,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,OAAgB;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QACzD,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAA;IAC3F,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,KAA+B;IAC/E,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,aAAa;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC,aAAa,CAAU,CAAC,CAAA;gBACpF,wEAAwE;gBACxE,wEAAwE;gBACxE,sEAAsE;gBACtE,yCAAyC;gBACzC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,KAAsB;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAC5C,cAAc,CAAC,KAAK,CAAC,aAAa,CAAU,EAC5C,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAW,CACjG,CAAA;gBACD,OAAO,YAAY,CAAC,IAAI,EAAE;oBACxB,IAAI;oBACJ,MAAM,EAAE,KAAK,CAAC,OAAO;oBACrB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;iBAC1C,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"present.js","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,YAAY,EAA4C,MAAM,aAAa,CAAA;AAEpF,SAAS,cAAc,CAAC,aAAqB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAY,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,OAAgB;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QACzD,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAA;IAC3F,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,KAA+B;IAC/E,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,aAAa;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC,aAAa,CAAU,CAAC,CAAA;gBACpF,wEAAwE;gBACxE,wEAAwE;gBACxE,sEAAsE;gBACtE,yCAAyC;gBACzC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,KAAsB;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAC5C,cAAc,CAAC,KAAK,CAAC,aAAa,CAAU,EAC5C,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAW,CACjG,CAAA;gBACD,OAAO,YAAY,CAAC,IAAI,EAAE;oBACxB,IAAI;oBACJ,MAAM,EAAE,KAAK,CAAC,OAAO;oBACrB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;iBAC1C,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/cards/composition.d.ts

@@ -0,0 +1,68 @@
+import { type ToolSubCall, type ToolSubCallRows, type ToolCard } from '../cards.ts';
+/**
+ * Nested calls retained on one PTC card.
+ *
+ * A program can dispatch in a loop, and one line each is small but not free;
+ * the cap keeps a card bounded while {@link ToolCard.subCallsTotal} still
+ * reports everything the program ran.
+ */
+export declare const SUBCALL_MAX = 100;
+/**
+ * What the fold learned about one dispatched call, in the order it learned it.
+ *
+ * A call is logged twice — once when the program asks for it, once with what it
+ * answered — and each moment supplies part of the row: the call view names it,
+ * the result view says how it ended and what it produced.
+ */
+export interface SubCallFacts {
+    /** The card the call declared, or nothing when no presenter answered for it. */
+    readonly view: ToolCard | undefined;
+    /** The rows the row opens to, once the call reported them. */
+    readonly output: ToolSubCallRows | undefined;
+    /** How the call finished, as the tool that ran it reported. */
+    readonly status: string | undefined;
+    /** Whether the call is logged and still unanswered. */
+    readonly running: boolean;
+    /** Whether the call is one the log marked as an error. */
+    readonly failed: boolean;
+}
+/**
+ * The one-line row for one nested call, as its start or its settle leaves it.
+ *
+ * A tool that declares a call view is drawn exactly as its own header would be;
+ * only a tool with no view at all falls back to its registry name and raw call,
+ * because the surface cannot name a salient argument for a schema it never saw.
+ * A settle logs the same call again, and the presenter that answered the first
+ * time is asked again for the view it would draw — so the row's identity comes
+ * from the row already on screen wherever there is one, and only a call that was
+ * dropped earlier is named from the log. The row also keeps how the call ended,
+ * because a program's calls are told apart by their outcomes rather than by
+ * anything the program itself says about them.
+ */
+export declare function subCallRow(id: string, name: string, argumentsJson: string, facts: SubCallFacts, existing?: ToolSubCall): ToolSubCall;
+/**
+ * The rows one dispatched call keeps, from the card that drew them.
+ *
+ * The total is clamped to what was kept: a card built from a call or result
+ * view reports no total of its own, because it is not a stream retention had to
+ * cut, and a count below the rows on screen would hint at rows already shown.
+ */
+export declare function subCallRows(card: ToolCard | undefined): ToolSubCallRows | undefined;
+/**
+ * The header fields a rebuilt card must keep.
+ *
+ * Replacing a card's rows says nothing about what the call was made with, what
+ * it measured, how it ended, or which calls it dispatched, so those fields
+ * travel with the rebuild: dropping the argument is how a shell card loses its
+ * command the moment a presenter declines the result.
+ */
+export declare function carriedFields(card: ToolCard): Pick<ToolCard, 'argument' | 'stats' | 'status' | 'subCalls' | 'subCallsTotal'>;
+/**
+ * Collapse one call and its result into the single row the reader sees.
+ *
+ * The pending row already told the reader what the tool is doing, so the
+ * settled row keeps that header and swaps in the outcome; a result that
+ * presents nothing keeps the call's detail rather than blanking the row.
+ */
+export declare function mergeCards(call: ToolCard | undefined, result: ToolCard | undefined): ToolCard;
+//# sourceMappingURL=composition.d.ts.map

package/lib/cards/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/cards/composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAY,MAAM,aAAa,CAAA;AAG7F;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAA;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAuBpI;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAGnF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC,CAQ5H;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CA8B7F"}