dsh-github-copilot 0.4.0-alpha.36 → 0.4.0-alpha.38
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 +7 -4
- package/CHANGELOG.md +15 -0
- package/README.md +23 -15
- package/README.zh.md +23 -15
- package/deployment-baseline.json +53 -19
- package/docs/npm-distribution.md +28 -18
- package/docs/official-first-020-rc1.md +28 -0
- package/lib/client.js +8 -5
- package/lib/client.js.map +1 -1
- package/lib/index.js +146 -92
- package/lib/routed-web.js +1 -1
- package/lib/{search-routing-DqLKem1c.js → search-routing-C1o895V6.js} +29 -2
- package/lib/types/compatibility.d.ts +5 -5
- package/lib/types/config.d.ts +3 -0
- package/lib/types/pi-provider-bridge.d.ts +1 -1
- package/lib/types/route-ownership.d.ts +1 -1
- package/lib/types/serialize.d.ts +8 -11
- package/lib/types/settings-reader.d.ts +11 -0
- package/package.json +44 -43
- package/scripts/check-search-composition.mjs +2 -2
package/docs/npm-distribution.md
CHANGED
|
@@ -118,28 +118,37 @@ There is no historical bulk backfill and no silent npm opt-out.
|
|
|
118
118
|
|
|
119
119
|
## Installation preflight still applies
|
|
120
120
|
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
is verified,
|
|
124
|
-
Release URL or local tarball
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
121
|
+
Desktop profiles must be managed through Desktop's native package manager.
|
|
122
|
+
The reserved `desktop` profile is not supported by DSH CLI plugin commands.
|
|
123
|
+
After npm publication is verified, the native manager accepts the exact
|
|
124
|
+
`dsh-github-copilot@<version>` npm spec, not a Release URL or local tarball.
|
|
125
|
+
The CLI procedure below applies only to standalone named profiles and is not a
|
|
126
|
+
Desktop fallback when registry access is blocked.
|
|
127
|
+
|
|
128
|
+
Neither entry point replaces the package's required
|
|
129
|
+
`scripts/check-search-composition.mjs` preflight. The official DSH 0.2
|
|
130
|
+
`composeProfile()` path writes the empty `cordis.yml` root before normal launch,
|
|
131
|
+
including when Desktop supplies an already resolved profile. Therefore the
|
|
132
|
+
preflight refuses a nonempty root as `NONEMPTY_DISPOSABLE_PROFILE_ROOT`; do not
|
|
133
|
+
install or start/restart that profile until the data has been preserved and an
|
|
134
|
+
officially supported migration has been established. A package lookup,
|
|
135
|
+
preflight or successful installation is not proof of runtime activation or a
|
|
136
|
+
model call.
|
|
137
|
+
|
|
138
|
+
## Controlled offline CLI maintenance for standalone profiles
|
|
132
139
|
|
|
133
140
|
This path installs this package's prebuilt, verified Release without requiring
|
|
134
141
|
access to a blocked npm registry. It is not permission to bypass organizational registry restrictions:
|
|
135
142
|
use only artifacts obtained through organizationally approved sources and
|
|
136
143
|
already available dependency caches. A registry ban remains in force; offline
|
|
137
144
|
installation does not repair TLS or prove that npm publication is healthy. The
|
|
138
|
-
dual-channel **publication** policy above is unchanged.
|
|
145
|
+
dual-channel **publication** policy above is unchanged. **Do not use this path
|
|
146
|
+
for a Desktop-managed/reserved profile.**
|
|
139
147
|
|
|
140
148
|
1. Obtain explicit installation approval for the exact version and profile.
|
|
141
|
-
Resolve the
|
|
142
|
-
do not
|
|
149
|
+
Resolve the standalone DSH CLI, install anchor, `DSH_HOME` and profile
|
|
150
|
+
directory; do not target Desktop's reserved `desktop` profile or assume a
|
|
151
|
+
shell shim points to the intended installation.
|
|
143
152
|
2. Verify the original Release tarball with an independently trusted SHA-256,
|
|
144
153
|
its package name/version and safe archive layout. Do not substitute a local
|
|
145
154
|
build or repack an existing immutable Release. Extract only the verified
|
|
@@ -148,8 +157,8 @@ dual-channel **publication** policy above is unchanged.
|
|
|
148
157
|
and install anchor, including any extra startup patches. Require
|
|
149
158
|
`supported: true`; unknown, conflicting or unsupported composition is a stop,
|
|
150
159
|
not permission to remove guards or rewrite the profile.
|
|
151
|
-
4. Keep one writer: do not run
|
|
152
|
-
|
|
160
|
+
4. Keep one writer: do not run concurrent package/profile updates. Take a
|
|
161
|
+
private backup of installation metadata (package.json,
|
|
153
162
|
lockfile, bundle/patch configuration and relevant package-manager settings),
|
|
154
163
|
record the current version, and retain a verified rollback artifact.
|
|
155
164
|
Do not copy credential stores, `.env` files or browser storage. If ensuring
|
|
@@ -184,5 +193,6 @@ dual-channel **publication** policy above is unchanged.
|
|
|
184
193
|
If installation fails, inspect the actual installed state before retrying or
|
|
185
194
|
rolling back; a failed command is not proof that nothing changed. A rollback
|
|
186
195
|
also needs reviewed, narrowly scoped metadata/dependency restoration. This
|
|
187
|
-
|
|
188
|
-
change machine-wide registry policy, or grant blanket
|
|
196
|
+
procedure does not authorize Desktop profile management, rewrite installed or
|
|
197
|
+
published historical docs, change machine-wide registry policy, or grant blanket
|
|
198
|
+
approval for future updates.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Official-first review: DSH 0.2.0-rc.1
|
|
2
|
+
|
|
3
|
+
## Target and evidence boundary
|
|
4
|
+
|
|
5
|
+
Candidate plugin **`0.4.0-alpha.38`** adds official Core **`0.2.0-rc.1`**, tag commit [`4878cdabd87d4041bdaff61d04c966883b9fd07a`](https://github.com/deepseek-ai/deepseek-harness/commit/4878cdabd87d4041bdaff61d04c966883b9fd07a), as the current target while retaining every earlier compatibility pin. The independently observed Windows Desktop feed also identifies `0.2.0-rc.1`; its Desktop package set is not materialized in this checkout. Source/API qualification, npm package fixtures, and Desktop installation/runtime qualification are separate evidence.
|
|
6
|
+
|
|
7
|
+
This review inspected only the exact official tag and unchanged installed package artifacts. **Complete** means the cited public contract supports the named behavior, not that Desktop or a live service was qualified. **Partial** identifies both the official capability and the gap. **Unverified** means parity was not established, not that official support is absent. Decisions are **retain**, **migrate**, or **retire**. A retirement trigger is evidence for a separately reviewed change, never permission for automatic removal on a version bump.
|
|
8
|
+
|
|
9
|
+
## Compatibility decisions
|
|
10
|
+
|
|
11
|
+
| Surface | Exact official contract and support | Decision | Remaining gap / retirement trigger |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| Copilot OAuth, credentials, catalog and ordinary model transport | The unchanged official [`llm-pi-ai` login/auth exports](https://github.com/deepseek-ai/deepseek-harness/tree/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/llm/llm-pi-ai/src) continue to own provider registration, OAuth grants, refresh and normal transport. | **Retain** the narrow public credential bridge and account-scoped route; do not add a second adapter or catalog. | The official path does not establish the companion's strict grant normalization, conditional authorization bootstrap, or authenticated per-account endpoint/capability metadata. Retire those bridges only after public official behavior and runtime acceptance preserve the same data and safety contracts. |
|
|
14
|
+
| Core settings access and invalidation | [`SettingsForms`](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/settings/settings/src/index.ts) and its public [types](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/settings/settings/src/types.ts) expose current descriptor/mutation APIs and the `settings/document-updated` event. | **Migrate** readers to the public descriptor path where legacy `get` is absent; **retain** a narrow legacy branch for older supported releases. | Retire the compatibility reader/listener only when the corresponding older Core pins are removed through an explicit support-policy change and the current namespace/redaction guarantees remain intact. |
|
|
15
|
+
| Volatile provider configuration | The public [`PiAiConfig` provider view](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/llm/llm-pi-ai/src/config.ts) wraps provider storage; callers materialize it through `.get()` rather than object indexing. | **Migrate** the plugin's route builder to `.get()` and **retain** object support for older native layouts. | Do not infer registration from an empty volatile wrapper. Retire the legacy object branch only with removal of the older baselines and matching fixture evidence. |
|
|
16
|
+
| Tool results and message history | The current [`Message` contract](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/llm/llm/src/message.ts) includes first-class `role: 'tool'` messages; older history can still contain nested tool-result blocks. | **Migrate** serialization to recognize both current and retained forms without rewriting source history. | Do not collapse tool messages into assistant text or change replay ownership. Retire legacy handling only after old stored histories are outside the declared support scope. |
|
|
17
|
+
| Agent creation and existing role-history restoration | The public [Agent lifecycle](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/core/agent/src/index.ts) serializes and awaits `agent/created`; the event carries a creation source. | **Retain** compatibility-only projection restoration and test it through the awaited public lifecycle. | Retired role UI/settings/new-root behavior stays retired. Runtime policy enforcement and old-history recovery remain plugin-owned; never infer permission from a missing or malformed descriptor. |
|
|
18
|
+
| Remote and Client Gateway validation | Current [Typert codecs](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/typert/protocol/src/types.ts) expose `create()` factories. The [Client Gateway](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/api/gateway/src/client/index.ts) forwards parameter payloads without local parsing; strict input validation belongs at the registered Host boundary. Strict result codecs decode only when the descriptor publishes a decoder. | **Migrate** descriptor tests to current `create()` factories; **retain** the same strict Host codecs and legacy `.schema` helper bridge. | Client-side tests must not claim pre-transport input filtering or result validation the current Gateway does not promise. The exact-source Host fixture must continue to prove strict registered-boundary parsing. Retire the legacy bridge only after old Core consumers leave support. |
|
|
19
|
+
| Models UI and additive contribution | The official [Models Client](https://github.com/deepseek-ai/deepseek-harness/blob/4878cdabd87d4041bdaff61d04c966883b9fd07a/packages/client/ui-settings-models/src/client/index.ts) declares keyed `settings.models.provider-card` and list `settings.models.footer` slots. | **Retain** additive account/search controls and native model editing. | Slot existence is not account-management or search-policy parity. Retire a control only after equivalent official workflow, accessibility, ownership and lifecycle behavior pass Client/Desktop acceptance. |
|
|
20
|
+
| Web routing and search | Official Web exposes registered provider dispatch; the plugin's public facade captures an exact registered provider before routed search. | **Retain** fail-closed captured-registration dispatch and the explicit missing-seam diagnostic. | Never replace captured identity with an ID-only lookup, global model default or another Session's selection. Desktop/runtime and live provider behavior remain unverified. |
|
|
21
|
+
| Plugin installation and Desktop injection | The official Windows Desktop feed identifies release `0.2.0-rc.1`, but no installed Desktop package set or loaded runtime is present here. | **Retain** package entry-point/peer checks and document the independent Desktop boundary. | Do not claim successful injection, install, activation, authentication, model calls or UI behavior from Core source or npm package tests alone. |
|
|
22
|
+
|
|
23
|
+
## Qualification ledger
|
|
24
|
+
|
|
25
|
+
- The release/tag and public source contracts above are pinned; the Core tree and installed dependencies were not modified.
|
|
26
|
+
- Local source build, focused tests, repository verifiers, exact-tag runtime fixtures and the complete gate must be reported separately after execution. Package-version metadata is not semantic or runtime proof.
|
|
27
|
+
- No real Copilot OAuth, model, search, live-profile change, Desktop install/restart, publication, push or pull request is part of this adaptation.
|
|
28
|
+
- Desktop package hashes/contents, packaged Electron activation, and loaded-version equivalence are **not verified** in this checkout. The observed feed release is not a materialized Desktop artifact.
|
package/lib/client.js
CHANGED
|
@@ -6070,7 +6070,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
6070
6070
|
const [draft, setDraft] = (0, react.useState)({
|
|
6071
6071
|
primary: "auto",
|
|
6072
6072
|
provider: DEEPSEEK_SEARCH_PROVIDER,
|
|
6073
|
-
legacy: true
|
|
6073
|
+
legacy: true,
|
|
6074
|
+
routingNamespace: WEB_SEARCH_ROUTING_SETTINGS_NAMESPACE
|
|
6074
6075
|
});
|
|
6075
6076
|
const [override, setOverride] = (0, react.useState)({ model: "" });
|
|
6076
6077
|
const [providers, setProviders] = (0, react.useState)([]);
|
|
@@ -6103,9 +6104,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
6103
6104
|
setMessage("Could not load search settings. Reload settings to retry.");
|
|
6104
6105
|
return;
|
|
6105
6106
|
}
|
|
6106
|
-
const routing = result.value.namespaces.find((entry) => entry.ns === WEB_SEARCH_ROUTING_SETTINGS_NAMESPACE);
|
|
6107
6107
|
const copilot = result.value.namespaces.find((entry) => entry.ns === GITHUB_COPILOT_SETTINGS_NAMESPACE);
|
|
6108
|
-
const
|
|
6108
|
+
const routing = result.value.namespaces.find((entry) => entry.ns === WEB_SEARCH_ROUTING_SETTINGS_NAMESPACE);
|
|
6109
|
+
const copilotValue = record$1(copilot?.value);
|
|
6110
|
+
const routingValue = record$1(routing?.value);
|
|
6109
6111
|
const normalized = normalizeWebSearchRouting({
|
|
6110
6112
|
searchProvider: typeof routingValue.searchProvider === "string" ? routingValue.searchProvider : void 0,
|
|
6111
6113
|
searchMode: routingValue.searchMode === "fixed" ? "fixed" : "auto",
|
|
@@ -6115,7 +6117,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
6115
6117
|
primary: normalized.primaryProvider,
|
|
6116
6118
|
provider: normalized.defaultProvider,
|
|
6117
6119
|
legacy: normalized.legacy,
|
|
6118
|
-
routingRevision: revisionOf(routing?.revision)
|
|
6120
|
+
routingRevision: revisionOf(routing?.revision),
|
|
6121
|
+
routingNamespace: WEB_SEARCH_ROUTING_SETTINGS_NAMESPACE
|
|
6119
6122
|
});
|
|
6120
6123
|
setOverride({
|
|
6121
6124
|
model: typeof copilotValue.searchModel === "string" ? copilotValue.searchModel.trim() : "",
|
|
@@ -6170,7 +6173,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
6170
6173
|
setSaving("routing");
|
|
6171
6174
|
setMessage("");
|
|
6172
6175
|
try {
|
|
6173
|
-
const result = await props.settings.mutate(
|
|
6176
|
+
const result = await props.settings.mutate(draft.routingNamespace, [{
|
|
6174
6177
|
op: "set",
|
|
6175
6178
|
path: ["searchProvider"],
|
|
6176
6179
|
value: primary
|