dsh-better-copilot 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.2.0 — read-only subagent route badge
+
+- Add a browser client half that shows an addressed subagent's effective model
+  and reasoning effort in the Web session header, beside the title. The label is
+  text only: no selector, no click target, no Host write, because the child's
+  route is fixed at creation and reused on resume.
+- Read the route from the existing `modelSelection` session projection and show
+  an adapter-defaulted effort as `default`. Provider/model/effort ids render
+  verbatim; catalog display names are not available to client plugins.
+- Keep ordinary conversations and the DSH-rendered subagent catalog untouched.
+  Ship the bundle through `./client` and a `dsh.client` declaration, with render
+  tests and the publication allowlist updated.
+
 ## 0.1.1 — DSH 0.2.2-rc.1 compatibility
 
 - Retarget the manifest, peer ranges and development pins to DSH `0.2.2-rc.1`

package/README.md

@@ -101,6 +101,25 @@ tool schemas that lack one for a configured Copilot route and model family, and
 leaves every other byte of the request untouched. It never replaces an adapter or
 another plugin's settings, and a guard failure dispatches the original body.
 
+## Subagent model badge (Web)
+
+The package now carries a small browser client half. When a subagent
+conversation is open in the Web GUI, the session header shows the child's
+effective route as muted text next to the title — for example
+`gpt-6.1-sol · high`. The label is read-only: the plugin renders no selector and
+writes nothing back, because the Host fixes a child's provider, model and
+reasoning effort when the subagent is created and reuses the recorded route on
+resume. An adapter-defaulted effort appears as `default`, and the tooltip and
+accessible name say that the route is fixed.
+
+The badge reads the child Session's `modelSelection` projection; it adds no Host
+service, configuration field or RPC. Ids are shown exactly as the Host records
+them, because catalog display names are not exposed to third-party client
+plugins. Ordinary conversations are unchanged, and the subagent catalog
+dropdown is untouched: DSH renders those rows in its own client package rather
+than through an extension slot. The browser half is published as `./client`
+and declared through `dsh.client`; no additional wiring is needed.
+
 ## Migration from the three predecessor packages
 
 | Was | Now |

package/dist/client.js

@@ -0,0 +1,98 @@
+"use strict";
+/// <reference path="./client.types.d.ts" />
+/* Read-only subagent route badge for the Web conversation header.
+ * The Host fixes a subagent's provider, model and reasoning effort when the
+ * child is created, so this client half only presents them. It never renders a
+ * selection control and writes nothing back to the Session.
+ */
+window.__ModuleLoader__.load({
+    id: 'dsh-better-copilot',
+    factory(require) {
+        const React = require('react');
+        const h = React.createElement;
+        const NS = 'better-copilot.subagent';
+        const SLOT = 'conversation.session.header.actions';
+        const ID = 'better-copilot-subagent-model';
+        const en = {
+            'badge.defaultEffort': 'default',
+            'badge.fixed': "Model and effort are fixed for this subagent's lifetime.",
+            'badge.aria': 'Subagent model {model} from {provider}, reasoning effort {effort}. {fixed}',
+        };
+        const zh = {
+            'badge.defaultEffort': '默认',
+            'badge.fixed': '该子智能体的模型与推理强度在创建时已固定。',
+            'badge.aria': '子智能体模型 {model}（{provider}），推理强度 {effort}。{fixed}',
+        };
+        /** Validate one projected selection; anything malformed is not rendered. */
+        function readSelection(value) {
+            if (typeof value !== 'object' || value === null)
+                return null;
+            const candidate = value;
+            const provider = typeof candidate.provider === 'string' ? candidate.provider : '';
+            const model = typeof candidate.model === 'string' ? candidate.model : '';
+            if (provider === '' || model === '')
+                return null;
+            const reasoningEffort = typeof candidate.reasoningEffort === 'string' && candidate.reasoningEffort !== ''
+                ? candidate.reasoningEffort
+                : undefined;
+            return reasoningEffort === undefined ? { provider, model } : { provider, model, reasoningEffort };
+        }
+        /** Read the effective selection from the modelSelection wire view. */
+        function selectedOf(view) {
+            if (typeof view !== 'object' || view === null)
+                return null;
+            const projected = view;
+            return readSelection(projected.next) ?? readSelection(projected.lastUsed);
+        }
+        /** Compose the visible label, tooltip and accessible name for one route. */
+        function subagentBadge(selection, t) {
+            const explicit = selection.reasoningEffort;
+            const effort = explicit === undefined ? t('badge.defaultEffort') : explicit;
+            const route = explicit === undefined
+                ? `${selection.provider}/${selection.model}`
+                : `${selection.provider}/${selection.model} · ${explicit}`;
+            return {
+                label: `${selection.model} · ${effort}`,
+                title: `${route} — ${t('badge.fixed')}`,
+                aria: t('badge.aria', {
+                    provider: selection.provider,
+                    model: selection.model,
+                    effort,
+                    fixed: t('badge.fixed'),
+                }),
+            };
+        }
+        const badgeStyle = {
+            display: 'inline-block',
+            maxWidth: '26ch',
+            overflow: 'hidden',
+            color: 'var(--dsw-alias-label-tertiary)',
+            fontSize: '12px',
+            lineHeight: '18px',
+            whiteSpace: 'nowrap',
+            textOverflow: 'ellipsis',
+            verticalAlign: 'middle',
+            cursor: 'default',
+        };
+        /** Read-only header cell: visible only for an addressed subagent's own route. */
+        function SubagentModelBadge({ sessionId, useSessions, useProjection, t }) {
+            const subagent = useSessions((state) => state.byId[sessionId]?.origin === 'subagent');
+            const view = useProjection('modelSelection');
+            if (!subagent)
+                return null;
+            const selection = selectedOf(view);
+            if (selection === null)
+                return null;
+            const badge = subagentBadge(selection, t);
+            return h('span', { style: badgeStyle, title: badge.title, 'aria-label': badge.aria }, badge.label);
+        }
+        function apply(ctx) {
+            ctx.effect(() => ctx.locale.register(NS, { en, zh }));
+            ctx.slots.inject(SLOT, () => ctx.slots.register({ name: SLOT, id: ID, order: 15, locale: NS }, SubagentModelBadge));
+        }
+        return {
+            inject: ['slots', 'locale'],
+            apply,
+        };
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-better-copilot",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Account-aware GitHub Copilot model discovery, Copilot-compatible wire identity, native Responses web search and a Copilot Gemini tool-declaration guard in one DeepSeek Harness plugin.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,7 @@
       "types": "./dist/guard.d.ts",
       "import": "./dist/guard.js"
     },
+    "./client": "./dist/client.js",
     "./package.json": "./package.json"
   },
   "files": [
@@ -89,18 +90,26 @@
     "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1",
     "@deepseek-ai/dsh-web": "0.2.2-rc.1",
     "@deepseek-ai/schemastery": "3.19.0",
-    "@earendil-works/pi-ai": "1.3.0"
+    "@earendil-works/pi-ai": "1.3.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "dsh": {
     "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json",
-    "test": "pnpm run build && node --import tsx --test test/catalog.test.ts test/discovery.test.ts test/identity.test.ts test/secrets.test.ts test/catalog-plugin.test.ts test/config.test.ts test/composition.test.ts test/auth.test.ts test/refresh.test.ts test/provider.test.ts test/responses.test.ts test/search-plugin.test.ts test/schema.test.ts test/guard.test.ts test/guard-plugin.test.ts test/patch.test.ts",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json && tsc -p tsconfig.client.json --noEmit",
+    "test": "pnpm run build && node --import tsx --test test/catalog.test.ts test/discovery.test.ts test/identity.test.ts test/secrets.test.ts test/catalog-plugin.test.ts test/config.test.ts test/composition.test.ts test/auth.test.ts test/refresh.test.ts test/provider.test.ts test/responses.test.ts test/search-plugin.test.ts test/schema.test.ts test/guard.test.ts test/guard-plugin.test.ts test/patch.test.ts test/client.render.test.ts",
     "test:integration": "pnpm run build && node --import tsx --test test/integration/nested-layout.test.ts test/integration/catalog-runtime.test.ts test/integration/enterprise.test.ts test/integration/identity-wire.test.ts test/integration/search-runtime.test.ts test/integration/guard-runtime.test.ts test/integration/wire.test.ts",
     "test:types": "pnpm run build && tsc -p test/types/tsconfig.json",
     "test:pack": "pnpm run build && tsx ../../scripts/check-pack.ts .",