@dan-ai-studio/dshopencodego 0.1.21 → 0.1.23

package/lib/types/update/check.js

@@ -0,0 +1,132 @@
+/**
+ * Self update check: is a newer release of this package published?
+ *
+ * This module only *reads*: it asks the npm registry for the latest published
+ * version and compares it with the running build. It never downloads,
+ * installs, or replaces anything — the actual update stays with the host's
+ * `pluginManager` (`removeBundle` + `installBundle`), driven by an explicit
+ * user click on the settings page. Automatic self-replacement would bypass
+ * the host's manifest lock, peer-compatibility checks, build approvals, and
+ * HMR lifecycle, so it is deliberately not implemented here.
+ *
+ * The check runs only when the settings page asks (page open or manual
+ * refresh), never on the model-request path, and fails silent: an unreachable
+ * registry simply hides the banner instead of erroring the page.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/check
+ */
+/** This package as addressed on the registry. */
+export const PACKAGE_NAME = '@dan-ai-studio/dshopencodego';
+/** Document address answering `{ "version": "x.y.z", ... }`. */
+export const REGISTRY_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(PACKAGE_NAME)}/latest`;
+/** How long one lookup answers for before the registry is asked again. */
+export const CHECK_CACHE_MS = 6 * 60 * 60 * 1000;
+/** Bound on one registry round trip; expiry fails silent, never throws. */
+export const CHECK_TIMEOUT_MS = 10_000;
+/** Split `1.2.3-tag.4+build` into comparable parts; invalid input yields undefined. */
+export function parseVersion(value) {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9a-zA-Z.-]+))?(?:\+[0-9a-zA-Z.-]+)?$/.exec(value.trim());
+    if (match === undefined || match === null)
+        return undefined;
+    const [, major, minor, patch, prerelease] = match;
+    return {
+        core: [Number(major), Number(minor), Number(patch)],
+        prerelease: prerelease === undefined ? undefined : prerelease.split('.'),
+    };
+}
+/**
+ * Compare two version strings.
+ * @returns negative when `left` is older, positive when newer, zero when equal.
+ * @throws {Error} when either side is not a version.
+ */
+export function compareVersions(left, right) {
+    const ours = parseVersion(left);
+    const theirs = parseVersion(right);
+    if (ours === undefined || theirs === undefined)
+        throw new Error(`dshopencodego: cannot compare versions "${left}" and "${right}"`);
+    for (let index = 0; index < 3; index += 1) {
+        const difference = (ours.core[index] ?? 0) - (theirs.core[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    if (ours.prerelease === undefined && theirs.prerelease === undefined)
+        return 0;
+    if (ours.prerelease === undefined)
+        return 1;
+    if (theirs.prerelease === undefined)
+        return -1;
+    const width = Math.max(ours.prerelease.length, theirs.prerelease.length);
+    for (let index = 0; index < width; index += 1) {
+        const oursPart = ours.prerelease[index];
+        const theirsPart = theirs.prerelease[index];
+        if (oursPart === undefined)
+            return -1;
+        if (theirsPart === undefined)
+            return 1;
+        if (oursPart !== theirsPart)
+            return oursPart < theirsPart ? -1 : 1;
+    }
+    return 0;
+}
+/** True when `latest` is a newer release than `current`. Unparsable input is never an update. */
+export function isUpdateAvailable(current, latest) {
+    if (latest === undefined)
+        return false;
+    try {
+        return compareVersions(latest, current) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Read the `version` field out of a registry `latest` document. */
+export function parseLatestVersion(body) {
+    if (body === null || typeof body !== 'object')
+        return undefined;
+    const version = body['version'];
+    return typeof version === 'string' && parseVersion(version) !== undefined ? version : undefined;
+}
+/**
+ * Ask the registry for the latest published version, cached per process.
+ *
+ * Concurrent callers share one in-flight lookup. A lookup that fails for any
+ * reason — network, timeout, malformed document — resolves as "no update
+ * known" rather than rejecting, so the settings page never breaks because
+ * the registry is unreachable.
+ */
+export function createUpdateChecker(deps) {
+    const now = deps.now ?? Date.now;
+    const fetchImpl = deps.fetchImpl ?? fetch;
+    let cached;
+    let inflight;
+    async function lookup() {
+        const checkedAt = now();
+        try {
+            const response = await fetchImpl(REGISTRY_LATEST_URL, { signal: AbortSignal.timeout(CHECK_TIMEOUT_MS) });
+            if (!response.ok)
+                throw new Error(`registry answered ${response.status}`);
+            const latest = parseLatestVersion(await response.json());
+            return {
+                current: deps.currentVersion,
+                latest,
+                available: isUpdateAvailable(deps.currentVersion, latest),
+                checkedAt,
+            };
+        }
+        catch {
+            return { current: deps.currentVersion, latest: undefined, available: false, checkedAt };
+        }
+    }
+    return {
+        check(force = false) {
+            if (!force && cached !== undefined && now() - cached.checkedAt < CHECK_CACHE_MS)
+                return Promise.resolve(cached);
+            inflight ??= lookup().then((status) => {
+                cached = status;
+                inflight = undefined;
+                return status;
+            });
+            return inflight;
+        },
+    };
+}

package/lib/types/update/contract.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Wire contract for the update Remote.
+ *
+ * `readUpdate` answers whether a newer release of this package is published.
+ * The reading is advisory — applying the update stays a user click that
+ * drives the host's `pluginManager`, never an automatic download.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/contract
+ */
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import type { UpdateStatus } from './check.ts';
+export type { UpdateStatus } from './check.ts';
+/** Validate an update reading crossing the wire. */
+export declare function parseUpdateStatus(value: unknown): UpdateStatus;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespaceMap {
+        opencodeGoUpdate: {
+            readUpdate(force?: boolean): Promise<RemoteResult<UpdateStatus>>;
+        };
+    }
+}
+/** Remote methods this package owns, mounted together by the plugin. */
+export declare const updateRemote: TypertRemoteContribution;

package/lib/types/update/contract.js

@@ -0,0 +1,52 @@
+/**
+ * Wire contract for the update Remote.
+ *
+ * `readUpdate` answers whether a newer release of this package is published.
+ * The reading is advisory — applying the update stays a user click that
+ * drives the host's `pluginManager`, never an automatic download.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/contract
+ */
+/** Validate an update reading crossing the wire. */
+export function parseUpdateStatus(value) {
+    if (value === null || typeof value !== 'object')
+        throw new Error('invalid update reading');
+    const row = value;
+    if (typeof row['current'] !== 'string')
+        throw new Error('invalid update reading');
+    if (row['latest'] !== undefined && typeof row['latest'] !== 'string')
+        throw new Error('invalid update reading');
+    if (typeof row['available'] !== 'boolean')
+        throw new Error('invalid update reading');
+    if (typeof row['checkedAt'] !== 'number' || !Number.isFinite(row['checkedAt'])) {
+        throw new Error('invalid update reading');
+    }
+    return {
+        current: row['current'],
+        latest: typeof row['latest'] === 'string' ? row['latest'] : undefined,
+        available: row['available'],
+        checkedAt: row['checkedAt'],
+    };
+}
+/** Codec shape accepted by both released and source DSH builds. */
+const codec = (typeSymbol, parse) => ({
+    mode: 'strict',
+    typeSymbol,
+    schema: { parse },
+    create: () => ({ parse }),
+});
+/** Remote methods this package owns, mounted together by the plugin. */
+export const updateRemote = {
+    package: '@dan-ai-studio/dshopencodego',
+    descriptors: [
+        {
+            id: '@dan-ai-studio/dshopencodego#opencodeGoUpdate/readUpdate',
+            service: 'opencodeGoUpdate',
+            namespace: 'opencodeGoUpdate',
+            method: 'readUpdate',
+            invocation: { kind: 'direct' },
+            parameters: [],
+            result: codec('@dan-ai-studio/dshopencodego#UpdateStatus', parseUpdateStatus),
+        },
+    ],
+};

package/lib/types/update/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Self update check (advisory only).
+ *
+ * @module @dan-ai-studio/dshopencodego/update
+ */
+export { PACKAGE_NAME, REGISTRY_LATEST_URL, CHECK_CACHE_MS, CHECK_TIMEOUT_MS } from './check.ts';
+export type { UpdateStatus } from './check.ts';
+export { compareVersions, createUpdateChecker, isUpdateAvailable, parseLatestVersion, parseVersion } from './check.ts';
+export { PLUGIN_VERSION } from './version.ts';
+export { OpencodeGoUpdateService } from './service.ts';
+export type { UpdateServiceOptions } from './service.ts';
+export { parseUpdateStatus, updateRemote } from './contract.ts';

package/lib/types/update/index.js

@@ -0,0 +1,10 @@
+/**
+ * Self update check (advisory only).
+ *
+ * @module @dan-ai-studio/dshopencodego/update
+ */
+export { PACKAGE_NAME, REGISTRY_LATEST_URL, CHECK_CACHE_MS, CHECK_TIMEOUT_MS } from "./check.js";
+export { compareVersions, createUpdateChecker, isUpdateAvailable, parseLatestVersion, parseVersion } from "./check.js";
+export { PLUGIN_VERSION } from "./version.js";
+export { OpencodeGoUpdateService } from "./service.js";
+export { parseUpdateStatus, updateRemote } from "./contract.js";

package/lib/types/update/service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Host half of the update Remote.
+ *
+ * One method, one question: is a newer release of this package published?
+ * The service answers from the registry through the cached checker in
+ * `./check.ts`, so the settings page learns about updates without the model
+ * path ever touching the network. Applying an update is intentionally absent
+ * here — the page drives the host's own `pluginManager` (`removeBundle` then
+ * `installBundle`), which owns the manifest lock, peer checks, build
+ * approvals, and the HMR lifecycle a self-replacing plugin would bypass.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/service
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { UpdateStatus } from './check.ts';
+/** Host inputs for the update service. */
+export interface UpdateServiceOptions {
+    /** Running build's version. */
+    readonly currentVersion: string;
+}
+/** Update Remote: the cached registry reading for the settings page. */
+export declare class OpencodeGoUpdateService extends TypertRemoteService {
+    private readonly check;
+    constructor(ctx: Context, options: UpdateServiceOptions);
+    /** Whether a newer release is published; `force` bypasses the cache. */
+    readUpdate(force?: boolean): Promise<UpdateStatus>;
+}

package/lib/types/update/service.js

@@ -0,0 +1,28 @@
+/**
+ * Host half of the update Remote.
+ *
+ * One method, one question: is a newer release of this package published?
+ * The service answers from the registry through the cached checker in
+ * `./check.ts`, so the settings page learns about updates without the model
+ * path ever touching the network. Applying an update is intentionally absent
+ * here — the page drives the host's own `pluginManager` (`removeBundle` then
+ * `installBundle`), which owns the manifest lock, peer checks, build
+ * approvals, and the HMR lifecycle a self-replacing plugin would bypass.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/service
+ */
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { createUpdateChecker } from "./check.js";
+/** Update Remote: the cached registry reading for the settings page. */
+export class OpencodeGoUpdateService extends TypertRemoteService {
+    check;
+    constructor(ctx, options) {
+        super(ctx, 'opencodeGoUpdate');
+        const checker = createUpdateChecker({ currentVersion: options.currentVersion });
+        this.check = (force) => checker.check(force);
+    }
+    /** Whether a newer release is published; `force` bypasses the cache. */
+    readUpdate(force) {
+        return this.check(force);
+    }
+}

package/lib/types/update/version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The running build's own version.
+ *
+ * `scripts/build.mjs` replaces `__DSHOPENCODEGO_VERSION__` with the package
+ * version at bundle time, so the Host knows what it is without reading its
+ * own files back from disk. Outside the bundle (tests, source runs) the
+ * constant is absent and the value reads as a development placeholder; the
+ * update check treats an unparsable current version as "no update known"
+ * rather than erroring.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/version
+ */
+/** Version of this build, or a placeholder outside the bundle. */
+export declare const PLUGIN_VERSION: string;

package/lib/types/update/version.js

@@ -0,0 +1,16 @@
+/**
+ * The running build's own version.
+ *
+ * `scripts/build.mjs` replaces `__DSHOPENCODEGO_VERSION__` with the package
+ * version at bundle time, so the Host knows what it is without reading its
+ * own files back from disk. Outside the bundle (tests, source runs) the
+ * constant is absent and the value reads as a development placeholder; the
+ * update check treats an unparsable current version as "no update known"
+ * rather than erroring.
+ *
+ * @module @dan-ai-studio/dshopencodego/update/version
+ */
+/** Version of this build, or a placeholder outside the bundle. */
+export const PLUGIN_VERSION = typeof __DSHOPENCODEGO_VERSION__ === 'string'
+    ? __DSHOPENCODEGO_VERSION__
+    : '0.0.0-dev';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",
@@ -15,7 +15,7 @@
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0"
+    "dsh": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.2.1 || >=0.2.1-alpha.1 <0.3.0"
   },
   "main": "./lib/index.js",
   "types": "./lib/types/index.d.ts",
@@ -67,11 +67,11 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
     "@earendil-works/pi-ai": "~1.0.2"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.2 || 4.0.3 || 4.0.4 || 4.0.5-alpha.1",
+    "@deepseek-ai/cordis": "4.0.2 || 4.0.3 || 4.0.4 || 4.0.5-alpha.1 || 4.0.5-alpha.2",
     "@deepseek-ai/dsh-api-remotes": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
     "@deepseek-ai/dsh-attachment": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
     "@deepseek-ai/dsh-brand": ">=0.1.7-alpha.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
@@ -111,28 +111,28 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5-alpha.1",
-    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-launch-environment": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "4.0.5-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-launch-environment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.3",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.20.0",