dsh-github-copilot 0.4.0-alpha.66 → 0.4.0-alpha.68

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -236,7 +236,7 @@ Never say GPT-6/search works merely because settings, typecheck or a package imp
236
236
 
237
237
  ## Changing capabilities
238
238
 
239
- Explicit parent-model following is a source candidate tracked in #229. `github-copilot.parentModelFollow` binds named native child/direct-parent Session IDs; the default is empty. `src/parent-model-follow.ts` and the Auto Host integration use public projections and per-turn scoped routing, never descriptor/history/default writes. Child-owned explicit selections win, fork seeds are not child overrides, and only enrolled native `spawn` children with supported managed parent routes participate. Preserve the native behavior of unenrolled Sessions and all historical dedicated role policies. Full native Team/runtime qualification remains pending; do not describe the candidate as released or general automatic inheritance. See `docs/automatic-model-routing.md`.
239
+ Parent-model following uses the profile-wide `github-copilot.followParentModel` switch (default false), with a single control in the plugin-detail page (#234). Never require per-session enrollment for the ordinary experience. Preserve legacy `parentModelFollow` bindings independently, including when the broad switch is off. `src/parent-model-follow.ts` and the Auto Host integration use public projections and per-turn scoped routing, never descriptor/history/default writes. Child-owned explicit selections win; enabling authorizes replacement of creation-time route snapshots, not removal of later picker history. Only supported native spawn children and managed Copilot parents participate; roots, other providers, fork descriptors and historical dedicated policies remain native. Missing eligible parent evidence fails explicitly. Settings changes preserve admitted turns, and Client saves use one path-level CAS without credentials/discovery. See `docs/parent-model-follow.md` for requirements/mockup and `docs/automatic-model-routing.md` for exact-source evidence.
240
240
 
241
241
  Model preferences must survive the Client's owned-field projection before strict decoding. `excludedModelIds` is a hidden volatile Config leaf, read via `readInlineConfig`; exercise native SettingsForms CAS, fiber preservation and restart persistence, not only map-backed settings mocks. Missing preference/selection evidence leaves model rows read-only with named diagnostics and status-only Retry. Unknown exclusion state is not an empty exclusion set. Discovery diagnostics stay in a separate Manage disclosure.
242
242
 
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.0-alpha.68 (prepared)
4
+
5
+ - Add one **Follow parent model** control in plugin settings. Enable once for existing and new supported Copilot subagents and Team mates; no Session IDs or per-child setup (#234).
6
+ - Preserve active turns, child-owned manual selections and independent child Auto decisions. Keep legacy explicit bindings without hidden migration.
7
+ - Record requirements, implementation plan and a synthetic screenshot of the actual settings component; use narrow settings CAS and preserve unsaved search drafts.
8
+
3
9
  ## 0.4.0-alpha.66 (prepared)
4
10
 
5
11
  - Add explicit native child/direct-parent model-follow bindings, disabled by default. Enrolled children follow fixed selections on their next turn or independently resolve the parent's Auto preference against their own context (#229).
package/README.md CHANGED
@@ -98,7 +98,7 @@ The Host reads GitHub's internal quota endpoint using the existing canonical OAu
98
98
 
99
99
  ## Install and sign in
100
100
 
101
- The commands below target the package version `0.4.0-alpha.66`. Versioned URLs describe the intended release artifacts, not proof that publication or local activation has completed; use them only once that Release and its checksums are available. Install into the profile you use (replace `web` when targeting another profile):
101
+ The commands below target the package version `0.4.0-alpha.68`. Versioned URLs describe the intended release artifacts, not proof that publication or local activation has completed; use them only once that Release and its checksums are available. Install into the profile you use (replace `web` when targeting another profile):
102
102
 
103
103
  Before installing/updating, unpack the **checksum-verified** archive into a temporary directory and run its read-only composition preflight (replace all paths with absolute paths for the intended profile):
104
104
 
@@ -111,10 +111,10 @@ Include any launcher patch files with repeated `--patch /absolute/file` argument
111
111
  For a standalone named profile only, the supported CLI command is:
112
112
 
113
113
  ```sh
114
- dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/dsh-github-copilot-0.4.0-alpha.66.tgz
114
+ dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/dsh-github-copilot-0.4.0-alpha.68.tgz
115
115
  ```
116
116
 
117
- For Desktop profiles, use Desktop's native package manager with `dsh-github-copilot@0.4.0-alpha.66` after the same preflight and only when registry access is permitted. Desktop reserves its `desktop` profile from CLI management. If registry access is blocked or unavailable, stop; the documented [controlled offline CLI procedure](./docs/npm-distribution.md#controlled-offline-cli-maintenance-for-standalone-profiles) is not a Desktop workaround.
117
+ For Desktop profiles, use Desktop's native package manager with `dsh-github-copilot@0.4.0-alpha.68` after the same preflight and only when registry access is permitted. Desktop reserves its `desktop` profile from CLI management. If registry access is blocked or unavailable, stop; the documented [controlled offline CLI procedure](./docs/npm-distribution.md#controlled-offline-cli-maintenance-for-standalone-profiles) is not a Desktop workaround.
118
118
 
119
119
  Then open the Models UI listed above, find **GitHub Copilot**, select **Sign in**, and complete the GitHub device-code flow. Plugin installation changes the selected profile; activation follows that profile's normal reload/restart policy.
120
120
 
@@ -130,7 +130,7 @@ If preferences cannot be read, available account rows remain visible but read-on
130
130
 
131
131
  ### Auto model routing
132
132
 
133
- **Source candidate, not yet released:** `github-copilot.parentModelFollow` can explicitly enroll native `spawn` children using `{ childSessionId, parentSessionId }` bindings. Enrolled members follow a fixed parent model at their next turn, or independently resolve the parent's exact Auto preference against their own context. The current turn is frozen; child-owned explicit selections win. The default is `[]`, so no existing member is automatically enrolled. See [configuration, limitations and validation status](./docs/automatic-model-routing.md#plugin-only-candidate-explicit-per-child-follow-policy). Native Team creation labels are not rewritten.
133
+ **One setting for subagents:** in the plugin configuration page, turn on **Subagent models → Follow parent model** and Save. It applies to existing and new supported Copilot subagents and Team mates, without Session IDs or per-child setup. A fixed parent model takes effect on each child's next turn; Auto inherits the same preference but chooses using each child's own context. Running turns stay unchanged and child-owned manual selections still win. Default Off (`github-copilot.followParentModel: false`). Enabling replaces creation-time model choices; it never clears explicit child selection history. Legacy `parentModelFollow` bindings remain active independently and are not migrated. See [requirements, mockup and boundaries](./docs/parent-model-follow.md). Native Team creation labels are not rewritten.
134
134
 
135
135
  The managed GitHub Copilot group includes **Auto · Balance**, **Auto · Efficiency**, and **Auto · Intelligence** as flat virtual picker rows. They share one account-verified eligible pool after applying exact model exclusions. Before preference, routing evaluates input headroom against each candidate's hard input budget, filtering out candidates that cannot accommodate current messages. Soft preferences distribute across upper/lower/center candidate bands using deterministic in-memory seeds to avoid monopolizing a single top candidate across Sessions. If no candidate fits, Auto selects the largest input capacity model and triggers compaction pressure on compressible history; if exclusions leave no eligible model, Auto fails closed. Auto resolves once per Core turn to a real model; every tool step, retry and automatic compaction recovery in that turn stays on that model, while a later Chat or Goal turn may choose again. Image turns require a non-excluded account-verified image-capable candidate. New turns retain Core's actual model/usage details without adding unsafe plugin events. Search keeps its independent provider-owned model policy. Today, native subagents and Team teammates initialize from the parent's latest recorded request route (or creation options before its first request); this is not a live link, and a route snapshot does not prove Auto intent. The requested per-child-turn inheritance behavior and Core/plugin boundary are documented in the [policy](./docs/automatic-model-routing.md#requested-parent-to-child-selection-inheritance). The nested management disclosure is plugin-owned; Core's picker remains flat.
136
136
 
@@ -165,7 +165,7 @@ Agents should treat the browser authorization as a human handoff, not as a token
165
165
  5. Confirm **Signed in** and inspect the automatic discovery result before asking the user to choose a model. Already-signed-in Models opening ensures missing/stale metadata automatically; fresh ready cache makes no request. Use visible **Retry** for errors or **Manage → Refresh models** for an intentional forced update, not routine setup. Status alone does not discover, and login, metadata and successful model calls remain separate evidence.
166
166
  6. Use **Sign out** only when the user explicitly asks to disconnect the account. It deletes the Copilot credential record but preserves route settings.
167
167
 
168
- GitHub Releases and npm are the default distribution channels for each new version, using the same verified tarball. Pin the version and verify the evidence for the channel used: Release `SHA256SUMS`, and npm `dist.integrity` when installing from npm. Install into Desktop profiles only through Desktop's native package manager; the reserved `desktop` profile is not managed by the DSH CLI. After npm publication is verified, the native manager accepts `dsh-github-copilot@0.4.0-alpha.66`, not a URL or file. Controlled offline CLI maintenance is documented for standalone named profiles only, never Desktop-managed profiles. Follow the mandatory search-composition preflight, backup, single-writer and post-install checks; do not bypass a corporate registry ban, disable TLS verification or restart without separate approval. See [distribution and publication requirements](./docs/npm-distribution.md).
168
+ GitHub Releases and npm are the default distribution channels for each new version, using the same verified tarball. Pin the version and verify the evidence for the channel used: Release `SHA256SUMS`, and npm `dist.integrity` when installing from npm. Install into Desktop profiles only through Desktop's native package manager; the reserved `desktop` profile is not managed by the DSH CLI. After npm publication is verified, the native manager accepts `dsh-github-copilot@0.4.0-alpha.68`, not a URL or file. Controlled offline CLI maintenance is documented for standalone named profiles only, never Desktop-managed profiles. Follow the mandatory search-composition preflight, backup, single-writer and post-install checks; do not bypass a corporate registry ban, disable TLS verification or restart without separate approval. See [distribution and publication requirements](./docs/npm-distribution.md).
169
169
 
170
170
  **Desktop package-update and Web-lifecycle boundaries:** the native manager's `restart-required` result for an in-place installed-package upgrade is authoritative and distinct from plugin-bundle removal/re-add behavior. Any disable, removal, or upgrade involving service recomposition (`cordis.patch.yml`, such as the isolated routed web search layer) may leave dependent entries pending until Desktop is fully exited and cold-restarted. If the native manager reports only entries such as `pending (waiting for service: web)` while this plugin already shows **Off**, the requested disabled state has been persisted; cold-restart Desktop instead of repeatedly toggling or reinstalling the plugin. Other errors are not covered by this guidance and must still be investigated.
171
171
 
@@ -440,8 +440,8 @@ Report the published Release URL, version, tag/commit and verified asset SHA-256
440
440
  `package.json` declares public npm distribution. A release tag must equal `v${package.json.version}`. Versions use standard SemVer prerelease labels (`alpha`, `beta`, or `rc`), each with its matching npm dist-tag; only stable versions use `latest`. The Release workflow performs the frozen install and complete verification gate, packs once (or recovers the original archive on retry), verifies `SHA256SUMS`, publishes the immutable GitHub Release and then publishes those same bytes to npm through OIDC. Either channel failing means delivery is incomplete. First package creation needs an authorized maintainer; staging requires an existing package and is not a first-package bootstrap. Historical releases are not republished.
441
441
 
442
442
  ```sh
443
- curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/dsh-github-copilot-0.4.0-alpha.66.tgz
444
- curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/SHA256SUMS
443
+ curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/dsh-github-copilot-0.4.0-alpha.68.tgz
444
+ curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/SHA256SUMS
445
445
  sha256sum --check SHA256SUMS
446
446
  ```
447
447
 
@@ -449,7 +449,7 @@ PowerShell can verify the same two downloaded files with:
449
449
 
450
450
  ```powershell
451
451
  $expected = (Get-Content .\SHA256SUMS).Split()[0]
452
- $actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.66.tgz -Algorithm SHA256).Hash.ToLowerInvariant()
452
+ $actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.68.tgz -Algorithm SHA256).Hash.ToLowerInvariant()
453
453
  if ($actual -cne $expected) { throw 'Release checksum mismatch' }
454
454
  ```
455
455
 
package/README.zh.md CHANGED
@@ -20,7 +20,7 @@
20
20
 
21
21
  截图来自当前构建 Client 的隔离浏览器 fixture,使用合成 Provider。它只证明已发布配置界面的形态,不证明真实凭据、账号权限、搜索成功或当前 Desktop 已加载。
22
22
 
23
- > 当前文档与安装命令对应版本 `0.4.0-alpha.66`。源码、发布制品、已安装版本和实际加载运行时需分别确认;本地升级和中断会话的重启仍需用户批准。
23
+ > 当前文档与安装命令对应版本 `0.4.0-alpha.68`。源码、发布制品、已安装版本和实际加载运行时需分别确认;本地升级和中断会话的重启仍需用户批准。
24
24
 
25
25
  Web search 路由现在优先显示在插件详情页;宿主不支持详情页插槽时才回退到 **设置 → 模型**或独立 Web search section。搜索子 Fiber 仍独立等待 Remote,不影响账号控件和既有搜索安全检查。
26
26
 
@@ -113,10 +113,10 @@ node package/scripts/check-search-composition.mjs --profile-dir /absolute/profil
113
113
  仅对独立的具名 profile,获准且网络可用时,可通过受支持的 CLI 命令安装:
114
114
 
115
115
  ```sh
116
- dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/dsh-github-copilot-0.4.0-alpha.66.tgz
116
+ dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/dsh-github-copilot-0.4.0-alpha.68.tgz
117
117
  ```
118
118
 
119
- Desktop profile 请在完成同样的预检后,使用 Desktop 原生包管理器安装 `dsh-github-copilot@0.4.0-alpha.66`。Desktop 保留 `desktop` profile,CLI 不负责管理。若 registry 被公司封禁或不可用,不要更换网络绕行或使用离线 CLI;请停止。[受控离线 CLI 流程](./docs/npm-distribution.md#controlled-offline-cli-maintenance-for-standalone-profiles)仅适用于独立具名 profile,不适用于 Desktop。
119
+ Desktop profile 请在完成同样的预检后,使用 Desktop 原生包管理器安装 `dsh-github-copilot@0.4.0-alpha.68`。Desktop 保留 `desktop` profile,CLI 不负责管理。若 registry 被公司封禁或不可用,不要更换网络绕行或使用离线 CLI;请停止。[受控离线 CLI 流程](./docs/npm-distribution.md#controlled-offline-cli-maintenance-for-standalone-profiles)仅适用于独立具名 profile,不适用于 Desktop。
120
120
 
121
121
  随后打开上表对应的 Models UI,找到 **GitHub Copilot**,点击 **Sign in** 并完成 GitHub device-code 流程。安装会修改指定 profile;是否立即激活取决于该 profile 的常规 reload/restart 策略。
122
122
 
@@ -132,7 +132,7 @@ Desktop profile 请在完成同样的预检后,使用 Desktop 原生包管理
132
132
 
133
133
  ### Auto 模型路由
134
134
 
135
- **源码候选功能,尚未发布:** `github-copilot.parentModelFollow` 可通过 `{ childSessionId, parentSessionId }` 配置明确授权原生 `spawn` 子成员跟随父 Agent。已授权成员在下一轮跟随父 Agent 的固定模型,或继承其准确的 Auto 偏好并按自身上下文独立选模;当前轮次不变,子成员自己的显式选择优先。默认 `[]`,不会自动接管已有成员。参见[配置、限制与验证状态](./docs/automatic-model-routing.md#plugin-only-candidate-explicit-per-child-follow-policy)。原生 Team 的创建时模型标签不会被改写。
135
+ **子代理只需设置一次:** 在插件配置页打开 **Subagent models → Follow parent model** 并保存,即应用于已有和新创建的受支持 Copilot 子代理及 Team mate,无需填写 Session ID 或逐个登记。父会话为固定模型时,子会话从下一轮跟随;父会话为 Auto 时,继承相同偏好并按各自上下文独立选模。正在执行的轮次不变,子会话自己的手动选择仍优先。默认关闭(`github-copilot.followParentModel: false`)。开启意味着接管创建时保存的模型选择,但不清除子会话的显式选择历史。旧 `parentModelFollow` 绑定独立保留,不自动迁移。参见[需求、mockup 与边界](./docs/parent-model-follow.md)。原生 Team 的创建时模型标签不会被改写。
136
136
 
137
137
  托管 GitHub Copilot 分组提供三个平铺的虚拟选择:**Auto · Balance**(均衡)、**Auto · Efficiency**(效率)和 **Auto · Intelligence**(智能)。三档先应用精确模型排除,再共用当前账号验证过的合格模型池。在应用偏好前,路由会根据候选模型的硬输入预算计算输入余量,剔除无法容纳当前消息的候选。软偏好通过确定性内存种子在候选区间(上段/下段/中段)内分布,避免单一顶配模型跨 Session 被垄断。若所有候选均超限,Auto 会选择输入容量最大的模型并对可压缩历史触发 compaction pressure;若排除后没有任何合格模型,则 Auto 关闭式失败。Auto 在每个 Core turn 只解析一次;同轮工具步骤、重试和自动 compact 恢复使用同一真实模型,新轮次可重新选择。图片轮次必须有未被排除且已验证的图片候选。新轮次保留 Core 的真实模型/用量信息,不追加不兼容的插件事件。搜索仍由独立策略管理。目前原生子代理与 Team 队友会以 master 最近记录的请求 route 初始化(master 尚未发出请求时回退到创建配置);这不是随 master 后续选择自动变化的动态关联,route 快照也不能证明 Auto 意图已继承。每轮跟随 master 固定模型、或让子代理按自身上下文独立执行 Auto 的目标行为及 Core/插件边界,见[设计记录](./docs/automatic-model-routing.md#requested-parent-to-child-selection-inheritance)。嵌套管理折叠区由插件提供;Core picker 仍保持平铺。
138
138
 
@@ -167,7 +167,7 @@ Agent 应把浏览器授权视为需要用户完成的 handoff,而不是自行
167
167
  5. 确认 **Signed in** 并检查自动发现结果,再请用户选择模型。已登录时打开 Models 会自动确保缺失/过期元数据,新鲜 ready 缓存不发请求。错误可使用 **Retry**,有意强制更新时使用 **Manage → Refresh models**,不作为常规设置步骤。状态读取本身不发现;登录、元数据与真实调用成功是独立证据。
168
168
  6. 只有用户明确要求断开账号时才使用 **Sign out**;它会删除 Copilot credential record,但保留 route settings。
169
169
 
170
- 每个新版本默认同时分发到 GitHub Releases 和 npm,两个渠道使用同一份已验证 tarball。应固定版本并核对所用渠道的证据:Release 的 `SHA256SUMS`;从 npm 安装时另核对 `dist.integrity`。Desktop profile 只能通过原生 Desktop 包管理器安装;获准且 registry 可用时输入 `dsh-github-copilot@0.4.0-alpha.66`,不是 URL 或本地文件。Desktop 保留 `desktop` profile,不能通过 DSH CLI 管理。受控离线 CLI 维护仅适用于独立具名 profile,不得作为 Desktop 安装绕行方案。[双渠道发布与 OIDC 要求](./docs/npm-distribution.md)保持不变。
170
+ 每个新版本默认同时分发到 GitHub Releases 和 npm,两个渠道使用同一份已验证 tarball。应固定版本并核对所用渠道的证据:Release 的 `SHA256SUMS`;从 npm 安装时另核对 `dist.integrity`。Desktop profile 只能通过原生 Desktop 包管理器安装;获准且 registry 可用时输入 `dsh-github-copilot@0.4.0-alpha.68`,不是 URL 或本地文件。Desktop 保留 `desktop` profile,不能通过 DSH CLI 管理。受控离线 CLI 维护仅适用于独立具名 profile,不得作为 Desktop 安装绕行方案。[双渠道发布与 OIDC 要求](./docs/npm-distribution.md)保持不变。
171
171
 
172
172
  **Desktop package 更新与 Web 生命周期边界:**原生 manager 对已安装 package 原位升级返回的 `restart-required` 是权威结果,与移除/重加 plugin bundle 的行为是两个不同问题。涉及服务重编排补丁(`cordis.patch.yml`,如本插件所采用的隔离路由 Web 搜索层)的停用、移除或升级,可能让依赖条目保持 pending,直到完全退出并冷重启 Desktop。若原生 manager 只报告类似 `pending (waiting for service: web)` 的条目,同时本插件已经显示 **Off**,说明请求的停用状态已经落盘;请冷重启 Desktop,不要反复切换或重装插件。其它错误不属于此提示范围,仍需单独排查。
173
173
 
@@ -451,8 +451,8 @@ node scripts/agent.mjs attribution "DeepSeek Harness (DSH)"
451
451
  `package.json` 声明公开 npm 分发。Release tag 必须严格等于 `v${package.json.version}`。预发布使用 `alpha`、`beta` 或 `rc` 及对应 npm dist-tag,只有稳定版使用 `latest`。Release workflow 执行 frozen install 和完整门禁,只打包一次(重试恢复原始归档),验证 `SHA256SUMS`,发布不可变 GitHub Release,再通过 OIDC 将同一份字节发布到 npm。任一渠道失败都表示交付未完成。首次建包须由获准环境中的维护者完成;staging 要求包已存在,不能代替首次建包。不会批量补发历史版本。
452
452
 
453
453
  ```sh
454
- curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/dsh-github-copilot-0.4.0-alpha.66.tgz
455
- curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.66/SHA256SUMS
454
+ curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/dsh-github-copilot-0.4.0-alpha.68.tgz
455
+ curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.68/SHA256SUMS
456
456
  sha256sum --check SHA256SUMS
457
457
  ```
458
458
 
@@ -460,7 +460,7 @@ PowerShell 可以对已下载的同一组文件执行:
460
460
 
461
461
  ```powershell
462
462
  $expected = (Get-Content .\SHA256SUMS).Split()[0]
463
- $actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.66.tgz -Algorithm SHA256).Hash.ToLowerInvariant()
463
+ $actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.68.tgz -Algorithm SHA256).Hash.ToLowerInvariant()
464
464
  if ($actual -cne $expected) { throw 'Release checksum mismatch' }
465
465
  ```
466
466
 
@@ -8,7 +8,7 @@
8
8
  },
9
9
  "package": {
10
10
  "name": "dsh-github-copilot",
11
- "version": "0.4.0-alpha.66"
11
+ "version": "0.4.0-alpha.68"
12
12
  },
13
13
  "evidence": {
14
14
  "kind": "source-and-synthetic-test-inventory",
@@ -1000,6 +1000,8 @@
1000
1000
  {"file": "src/auto-model-host.ts", "marker": "keep attribution out of the log"},
1001
1001
  {"file": "src/parent-model-follow.ts", "marker": "resolveParentModel"},
1002
1002
  {"file": "src/config.ts", "marker": "parentModelFollow"},
1003
+ {"file": "src/config.ts", "marker": "followParentModel"},
1004
+ {"file": "src/parent-model-follow-card.ts", "marker": "Follow parent model"},
1003
1005
  {"file": "src/auto-model-host.ts", "marker": "COPILOT_AUTO_TOKEN_METER_UNAVAILABLE"},
1004
1006
  {"file": "src/auto-model-presentation.ts", "marker": "conversation.chat.assistant-actions"},
1005
1007
  {"file": "src/auto-model-presentation.ts", "marker": "turnModelProvenanceDefinition"},
@@ -1009,7 +1011,7 @@
1009
1011
  {"file": "docs/automatic-model-routing.md", "marker": "plugin-only"}
1010
1012
  ],
1011
1013
  "tests": [
1012
- {"file": "tests/auto-model-host.spec.ts", "name": "follows fixed and Auto parents at turn boundaries without writing child selections"},
1014
+ {"file": "tests/auto-model-host.spec.ts", "name": "follows fixed and Auto parents using %s without writing child selections"},
1013
1015
  {"file": "tests/scripts/parent-model-follow.test.mjs", "name": "explicit same-model and different-model child selections both win"},
1014
1016
  {"file": "tests/auto-model-routing.spec.ts", "name": "classifies only the latest user turn and selects a deterministic capacity tier"},
1015
1017
  {"file": "tests/auto-model-routing.spec.ts", "name": "does not discard a complete Core assistant message when it contains reasoning"},
@@ -142,7 +142,7 @@ General native subagent Auto inheritance is **not** in the base MVP.
142
142
 
143
143
  In official DSH 0.2.0-rc.2, `TeamRoster.spawn` calls `ctx.subagents.startContinuable` without `request.agentOptions`. Core initializes the child from the parent's latest recorded request route, falling back to the parent's creation options before it has made a request, and records the resulting child options in its descriptor. This is creation-time inheritance, not a live link to the parent's selection. A recorded concrete route alone does not establish whether it came from an inherited selection or an explicit child override, and a resolved route does not prove the parent had no pending Auto intent. The plugin must not relabel a child route as Auto or write fabricated selection history.
144
144
 
145
- Without explicit `parentModelFollow` enrollment, the plugin preserves native child routing behavior:
145
+ With `followParentModel` off and no legacy `parentModelFollow` enrollment, the plugin preserves native child routing behavior:
146
146
 
147
147
  - a child with an explicit model override uses that model;
148
148
  - a new child or Team mate without an override starts with Core's parent-route snapshot and fallback behavior;
@@ -164,7 +164,7 @@ The desired behavior is for native subagents and Team mates to follow the master
164
164
 
165
165
  This is a requested product direction, not current behavior. A native implementation would carry an explicit inheritance mode and parent/override provenance, then resolve the parent's current effective selection at the start of each new child turn. For Auto, the child must invoke its own per-turn Auto resolution against its own messages and capabilities. Explicit child selection remains authoritative. The resolver must use the live parent's selected/requested model state, not the global default, and must fail visibly when parent evidence is missing rather than guess from a stale concrete child route. The open [Core PR #95](https://github.com/cloga/deepseek-harness/pull/95) proposes creation-time route rules for new children; its design preserves existing children on later messages and does not establish per-turn parent-following or inherited Auto intent.
166
166
 
167
- The plugin has public request-selection middleware seams. The candidate implementation below uses them for explicitly enrolled native `spawn` children, rather than claiming automatic inference of creation-time intent. General transparent enrollment is not implemented. Actual request routes remain authoritative; native Team labels are not rewritten.
167
+ The plugin uses public request-selection middleware for supported native `spawn` children. The profile-wide switch explicitly authorizes overriding creation-time snapshots without inferring their original intent; legacy per-child bindings remain compatible. This is opt-in policy, not a change to native defaults. Actual request routes remain authoritative; native Team labels are not rewritten.
168
168
 
169
169
  ### October 2 investigation: routing is possible; automatic enrollment is ambiguous
170
170
 
@@ -204,9 +204,16 @@ parent/child model IDs, inspecting only `Agent.options`, or treating a missing
204
204
  child picker event as inheritance cannot implement the stated precedence for
205
205
  every existing child. Request middleware does not recover the lost information.
206
206
 
207
- ### Plugin-only candidate: explicit per-child follow policy
207
+ ### One-switch policy and legacy per-child bindings
208
208
 
209
- **Opt-in plugin implementation; transparent enrollment remains unsupported.**
209
+ The ordinary UI is now one profile-wide **Follow parent model** switch in the
210
+ plugin configuration page. See [requirements, design and mockup](parent-model-follow.md).
211
+ It defaults to Off and does not ask users to manage child IDs. Explicitly
212
+ enabling this broad policy authorizes replacing creation-time snapshots;
213
+ child-owned manual selection events still win. The per-child binding mechanism
214
+ below remains for alpha.66 compatibility, not as the ordinary user workflow.
215
+
216
+ **Legacy opt-in bindings; preserved independently of the broad switch.**
210
217
  Do not silently enroll all existing children or treat a new setting as proof of
211
218
  their original creation intent. `github-copilot.parentModelFollow` defaults to
212
219
  an empty array. The standard plugin configuration accepts explicit bindings:
@@ -243,9 +250,10 @@ strict history reading/refolding, unavailable parents, normal model exclusions,
243
250
  live binding changes and disposal. The native AgentLoop fixture reconstructs a
244
251
  child from its own strict-reader-validated history and verifies the next turn;
245
252
  it does not exercise disk-backed resume or the native Team orchestrator.
246
- The current native creation path has no proven automatic-enrollment mechanism
247
- that preserves original override precedence, so this alternative needs explicit
248
- per-child user authorization rather than a claim of transparent default inheritance.
253
+ The native creation path cannot recover original equal-route override intent.
254
+ Legacy bindings authorize individual children; the new switch authorizes this
255
+ tradeoff once for the profile. Neither mechanism fabricates provenance or clears
256
+ child-owned selection events.
249
257
 
250
258
  Local full validation is blocked: `pnpm exec vitest --version` triggered pnpm's
251
259
  dependency reconciliation, which failed with HTTP 404 for
package/lib/client.js CHANGED
@@ -7052,6 +7052,18 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
7052
7052
  };
7053
7053
  }, [load]);
7054
7054
  const usesCopilot = draft.primary === GITHUB_COPILOT_SEARCH_PROVIDER || draft.provider === GITHUB_COPILOT_SEARCH_PROVIDER;
7055
+ (0, react.useEffect)(() => {
7056
+ const revision = props.settingsRevision;
7057
+ if (!revision) return;
7058
+ setDraft((value) => value.routingRevision === revision.previous ? {
7059
+ ...value,
7060
+ routingRevision: revision.next
7061
+ } : value);
7062
+ setOverride((value) => value.revision === revision.previous ? {
7063
+ ...value,
7064
+ revision: revision.next
7065
+ } : value);
7066
+ }, [props.settingsRevision]);
7055
7067
  const disabled = loading || saving !== void 0 || !writable || draft.routingRevision === void 0 || !catalogReady;
7056
7068
  const primaryKnown = draft.primary === "auto" || draft.primary === "none" || providers.includes(draft.primary);
7057
7069
  const fallbackKnown = draft.provider === "none" || providers.includes(draft.provider);
@@ -7293,6 +7305,207 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
7293
7305
  }, message));
7294
7306
  }
7295
7307
  //#endregion
7308
+ //#region lib/types/parent-model-follow-card.js
7309
+ const ns = "github-copilot";
7310
+ const button$1 = {
7311
+ font: "inherit",
7312
+ color: "inherit",
7313
+ background: "transparent",
7314
+ padding: "8px 14px",
7315
+ border: "1px solid currentColor",
7316
+ borderRadius: "6px",
7317
+ minHeight: "40px"
7318
+ };
7319
+ async function readParentFollowSettings(settings) {
7320
+ const result = await settings.describe();
7321
+ if (!result.ok) throw new Error("Could not load subagent settings. Reload to retry.");
7322
+ const entry = result.value.namespaces.find((value) => value.ns === ns);
7323
+ const value = entry?.value;
7324
+ if (!entry || !Number.isSafeInteger(entry.revision) || entry.revision < 0 || typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("Subagent settings are unavailable. Reload after the plugin is active.");
7325
+ const enabled = Reflect.get(value, "followParentModel");
7326
+ const legacy = Reflect.get(value, "parentModelFollow");
7327
+ if (enabled !== void 0 && typeof enabled !== "boolean" || legacy !== void 0 && !Array.isArray(legacy)) throw new Error("Subagent settings are invalid. Review the saved configuration before editing.");
7328
+ return {
7329
+ enabled: enabled === true,
7330
+ revision: entry.revision,
7331
+ writable: result.value.writable === true,
7332
+ legacy: Array.isArray(legacy) && legacy.length > 0
7333
+ };
7334
+ }
7335
+ async function saveParentFollowSettings(settings, saved, enabled) {
7336
+ const current = await readParentFollowSettings(settings);
7337
+ if (!current.writable) throw new Error("Subagent settings are read-only in this deployment.");
7338
+ if (current.enabled !== saved.enabled) throw new Error("This setting changed elsewhere. Reload and review it before saving.");
7339
+ const result = await settings.mutate(ns, [{
7340
+ op: "set",
7341
+ path: ["followParentModel"],
7342
+ value: enabled
7343
+ }], current.revision);
7344
+ if (!result.ok) throw new Error("Could not confirm the save. Reload to check saved settings before retrying.");
7345
+ if (!Number.isSafeInteger(result.value.revision) || result.value.revision <= current.revision) throw new Error("Save returned no valid revision. Reload before editing again.");
7346
+ return {
7347
+ snapshot: {
7348
+ ...current,
7349
+ enabled,
7350
+ revision: result.value.revision
7351
+ },
7352
+ revision: {
7353
+ previous: current.revision,
7354
+ next: result.value.revision
7355
+ }
7356
+ };
7357
+ }
7358
+ function ParentModelFollowCard({ settings, onSaved }) {
7359
+ const [saved, setSaved] = (0, react.useState)();
7360
+ const [enabled, setEnabled] = (0, react.useState)(false);
7361
+ const [busy, setBusy] = (0, react.useState)(true);
7362
+ const [message, setMessage] = (0, react.useState)("");
7363
+ const [failed, setFailed] = (0, react.useState)(false);
7364
+ const lifecycle = (0, react.useRef)({
7365
+ active: false,
7366
+ generation: 0,
7367
+ busy: false
7368
+ });
7369
+ const descriptionId = (0, react.useId)();
7370
+ const load = async () => {
7371
+ const owner = lifecycle.current;
7372
+ if (!owner.active || owner.busy) return;
7373
+ const generation = owner.generation;
7374
+ owner.busy = true;
7375
+ setBusy(true);
7376
+ try {
7377
+ const next = await readParentFollowSettings(settings);
7378
+ if (!owner.active || owner.generation !== generation) return;
7379
+ setSaved(next);
7380
+ setEnabled(next.enabled);
7381
+ setFailed(false);
7382
+ setMessage(next.writable ? "" : "Subagent settings are read-only in this deployment.");
7383
+ } catch {
7384
+ if (owner.active && owner.generation === generation) {
7385
+ setFailed(true);
7386
+ setMessage("Could not load subagent settings. Reload to retry.");
7387
+ }
7388
+ } finally {
7389
+ if (owner.active && owner.generation === generation) {
7390
+ owner.busy = false;
7391
+ setBusy(false);
7392
+ }
7393
+ }
7394
+ };
7395
+ (0, react.useEffect)(() => {
7396
+ const owner = lifecycle.current;
7397
+ owner.active = true;
7398
+ load();
7399
+ return () => {
7400
+ owner.active = false;
7401
+ owner.generation++;
7402
+ owner.busy = false;
7403
+ };
7404
+ }, [settings]);
7405
+ const disabled = busy || failed || !saved?.writable;
7406
+ const save = async () => {
7407
+ const owner = lifecycle.current;
7408
+ if (disabled || !saved || owner.busy || enabled === saved.enabled) return;
7409
+ const generation = owner.generation;
7410
+ owner.busy = true;
7411
+ setBusy(true);
7412
+ setMessage("Saving…");
7413
+ try {
7414
+ const next = await saveParentFollowSettings(settings, saved, enabled);
7415
+ if (!owner.active || owner.generation !== generation) return;
7416
+ setSaved(next.snapshot);
7417
+ onSaved?.(next.revision);
7418
+ setMessage("Saved. Applies from each child’s next turn.");
7419
+ } catch {
7420
+ if (owner.active && owner.generation === generation) {
7421
+ setFailed(true);
7422
+ setMessage("Could not confirm the save. Reload to check for conflicts or read-only settings before retrying. Your choice has been kept.");
7423
+ }
7424
+ } finally {
7425
+ if (owner.active && owner.generation === generation) {
7426
+ owner.busy = false;
7427
+ setBusy(false);
7428
+ }
7429
+ }
7430
+ };
7431
+ return (0, react.createElement)("section", {
7432
+ "data-dsh-parent-model-follow": true,
7433
+ "aria-busy": busy,
7434
+ style: {
7435
+ padding: "18px",
7436
+ marginTop: "16px",
7437
+ display: "grid",
7438
+ gap: "14px",
7439
+ minWidth: 0
7440
+ }
7441
+ }, (0, react.createElement)("h3", { style: {
7442
+ margin: 0,
7443
+ fontSize: "16px"
7444
+ } }, "Subagent models"), (0, react.createElement)("label", { style: {
7445
+ display: "flex",
7446
+ gap: "12px",
7447
+ alignItems: "center",
7448
+ minHeight: "40px"
7449
+ } }, (0, react.createElement)("input", {
7450
+ type: "checkbox",
7451
+ role: "switch",
7452
+ checked: enabled,
7453
+ disabled,
7454
+ "aria-describedby": descriptionId,
7455
+ onChange: (event) => {
7456
+ setEnabled(event.currentTarget.checked);
7457
+ setMessage("Unsaved change.");
7458
+ }
7459
+ }), (0, react.createElement)("strong", null, "Follow parent model")), (0, react.createElement)("div", {
7460
+ id: descriptionId,
7461
+ style: {
7462
+ fontSize: "13px",
7463
+ lineHeight: 1.6,
7464
+ maxWidth: "70ch"
7465
+ }
7466
+ }, (0, react.createElement)("p", { style: { margin: 0 } }, "Apply to existing and new supported Copilot subagents and Team mates."), (0, react.createElement)("p", { style: { margin: "6px 0 0" } }, "Fixed parent: follow its model next turn. Auto parent: each child chooses using its own context."), (0, react.createElement)("p", { style: { margin: "6px 0 0" } }, "Running turns stay unchanged. Replaces creation-time model choices; a child’s own manual selection still wins.")), saved?.legacy ? (0, react.createElement)("p", {
7467
+ role: "note",
7468
+ style: {
7469
+ margin: 0,
7470
+ fontSize: "13px"
7471
+ }
7472
+ }, "Existing per-child bindings remain active even when this switch is off. They have not been changed.") : null, (0, react.createElement)("div", { style: {
7473
+ display: "flex",
7474
+ flexWrap: "wrap",
7475
+ gap: "12px"
7476
+ } }, (0, react.createElement)("button", {
7477
+ type: "button",
7478
+ style: {
7479
+ ...button$1,
7480
+ opacity: disabled || enabled === saved?.enabled ? .5 : 1
7481
+ },
7482
+ disabled: disabled || enabled === saved?.enabled,
7483
+ onClick: () => {
7484
+ save();
7485
+ }
7486
+ }, busy ? "Please wait…" : "Save"), (0, react.createElement)("button", {
7487
+ type: "button",
7488
+ style: {
7489
+ ...button$1,
7490
+ opacity: busy ? .5 : 1
7491
+ },
7492
+ disabled: busy,
7493
+ title: "Reload saved values and discard unsaved edits",
7494
+ onClick: () => {
7495
+ load();
7496
+ }
7497
+ }, "Reload")), (0, react.createElement)("p", {
7498
+ role: "status",
7499
+ "aria-live": "polite",
7500
+ "aria-atomic": true,
7501
+ style: {
7502
+ margin: 0,
7503
+ fontSize: "13px",
7504
+ lineHeight: 1.6
7505
+ }
7506
+ }, message || (busy ? "Loading subagent settings…" : "")));
7507
+ }
7508
+ //#endregion
7296
7509
  //#region lib/types/external-link.js
7297
7510
  /** Use Desktop's public v1 navigation handoff instead of WebView popup creation. */
7298
7511
  function externalLinkTarget() {
@@ -8987,6 +9200,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
8987
9200
  disposeFallback?.();
8988
9201
  };
8989
9202
  }
9203
+ function CopilotPluginSettingsPage(props) {
9204
+ const [revision, setRevision] = (0, react.useState)();
9205
+ return (0, react.createElement)("div", null, (0, react.createElement)(ParentModelFollowCard, {
9206
+ settings: props.settings,
9207
+ onSaved: setRevision
9208
+ }), (0, react.createElement)(WebSearchRoutingCard, {
9209
+ ...props,
9210
+ settingsRevision: revision
9211
+ }));
9212
+ }
8990
9213
  /** Optional search settings must never hold account authorization UI in waiting. */
8991
9214
  function registerSearchUi(ctx) {
8992
9215
  let active = true;
@@ -9039,7 +9262,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
9039
9262
  dispose = ctx.slots.register({
9040
9263
  name: "plugins.bundle.config",
9041
9264
  key: "dsh-github-copilot"
9042
- }, ({ view }) => view === "page" ? render() : null);
9265
+ }, ({ view }) => view === "page" ? (0, react.createElement)(CopilotPluginSettingsPage, {
9266
+ settings,
9267
+ routing
9268
+ }) : null);
9043
9269
  } catch {
9044
9270
  ctx.logger.warn("[github-copilot] WEB_SEARCH_ROUTING_BUNDLE_UNAVAILABLE");
9045
9271
  return () => {};
@@ -9128,6 +9354,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
9128
9354
  };
9129
9355
  }
9130
9356
  //#endregion
9357
+ exports.CopilotPluginSettingsPage = CopilotPluginSettingsPage;
9131
9358
  exports.CopilotUsageCard = CopilotUsageCard;
9132
9359
  exports.GitHubCopilotAccountModelsPanel = GitHubCopilotAccountModelsPanel;
9133
9360
  exports.GitHubCopilotAccountModelsSummary = GitHubCopilotAccountModelsSummary;
@@ -9140,6 +9367,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
9140
9367
  exports.GitHubCopilotProviderCard = GitHubCopilotProviderCard;
9141
9368
  exports.GitHubCopilotSettingsSection = GitHubCopilotSettingsSection;
9142
9369
  exports.HostedSearchSettingsCard = HostedSearchSettingsCard;
9370
+ exports.ParentModelFollowCard = ParentModelFollowCard;
9143
9371
  exports.WebSearchRoutingCard = WebSearchRoutingCard;
9144
9372
  exports.activeAuthorizationNotice = activeAuthorizationNotice;
9145
9373
  exports.apply = apply;