@dan-ai-studio/dshopencodego 0.1.91 → 0.1.93

package/lib/types/catalog/go-doc.d.ts

@@ -22,11 +22,12 @@ import type { WireProtocol } from './protocol.ts';
  * same path and is tried when GitHub itself is unreachable.
  *
  * The path is the provider's own, and it moves: `go.mdx` used to live at
- * `packages/web/src/content/docs/go.mdx` and the `packages/web` tree was
- * restructured, after which every request answered 404. A document that cannot
- * be read costs the endpoint table — the provider's own statement of each
- * model's protocol — so the path is asserted against the live repository by
- * `tests/go-doc-url.spec.ts` rather than left to rot unnoticed.
+ * `packages/web/src/content/docs/go.mdx`, then at
+ * `services/www/src/docs/content/console/go.mdx`, and the `www` tree was
+ * renamed to `site` — after which both mirrors answered 404 again. A document
+ * that cannot be read costs the endpoint table — the provider's own statement
+ * of each model's protocol — so the path is asserted against the live
+ * repository by `tests/go-doc-url.spec.ts` rather than left to rot unnoticed.
  */
 export declare const GO_DOC_URLS: readonly string[];
 /** What one parse of the document yields. */

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

@@ -0,0 +1,25 @@
+/**
+ * Wire contract for the desktop Remote.
+ *
+ * `readDesktop` answers which installer the desktop download host publishes
+ * right now, and where it lives. The reading is advisory: the page shows the
+ * address so a human can copy it or open it in a browser, and nothing here
+ * downloads or installs anything.
+ *
+ * @module @dan-ai-studio/dshopencodego/desktop/contract
+ */
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import type { DesktopReading } from './feed.ts';
+export type { DesktopReading, DesktopRelease } from './feed.ts';
+/** Validate a desktop reading crossing the wire. */
+export declare function parseDesktopReading(value: unknown): DesktopReading;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespaceMap {
+        opencodeGoDesktop: {
+            readDesktop(): Promise<RemoteResult<DesktopReading>>;
+            refreshDesktop(): Promise<RemoteResult<DesktopReading>>;
+        };
+    }
+}
+/** Remote methods this package owns, mounted together by the plugin. */
+export declare const desktopRemote: TypertRemoteContribution;

package/lib/types/desktop/feed.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The desktop app's release feed.
+ *
+ * The Harness desktop build publishes one small YAML document per platform and
+ * channel under `download.deepseek.com/dsh-desk/feeds/`. Reading it answers a
+ * single question — which installer is the newest one published right now, and
+ * where does it live? — without asking the user to curl the feed by hand.
+ *
+ * This module only *reads*. It never downloads, verifies, or runs the
+ * installer: the address is surfaced so the page can show, copy, or open it,
+ * and the decision to install stays with the human. Verifying the published
+ * `sha512` would mean fetching a ~286 MB payload, which is not something a
+ * settings-page click may do unasked.
+ *
+ * Only `win-x64/nightly` exists today — every other platform directory answers
+ * 404 — so platform and channel are constants rather than a matrix. A feed that
+ * starts publishing elsewhere gets its own constant here.
+ *
+ * @module @dan-ai-studio/dshopencodego/desktop/feed
+ */
+/** Platform directory of the published feed. */
+export declare const DESKTOP_FEED_PLATFORM = "win-x64";
+/** Release channel of the published feed. */
+export declare const DESKTOP_FEED_CHANNEL = "nightly";
+/** Document answering the newest installer for that platform and channel. */
+export declare const DESKTOP_FEED_URL = "https://download.deepseek.com/dsh-desk/feeds/win-x64/nightly.yml";
+/** How long one reading answers for before the feed is asked again. */
+export declare const DESKTOP_CACHE_MS: number;
+/** Bound on one feed round trip; expiry fails silent, never throws. */
+export declare const DESKTOP_TIMEOUT_MS = 10000;
+/** One published installer, as the feed describes it. */
+export interface DesktopRelease {
+    /** Version the installer carries, e.g. `0.2.2-rc.3`. */
+    readonly version: string;
+    /** Absolute address of the installer. */
+    readonly url: string;
+    /** Size in bytes, when the feed states one. */
+    readonly size?: number;
+    /** Base64 SHA-512 of the payload, when the feed states one. */
+    readonly sha512?: string;
+    /** Share of clients this build is offered to, when the feed states one. */
+    readonly stagingPercentage?: number;
+    /** ISO timestamp of the publication, when the feed states one. */
+    readonly releaseDate?: string;
+}
+/** What the settings page renders. */
+export interface DesktopReading {
+    /**
+     * Whether the feed actually answered.
+     *
+     * `false` means the reading is a placeholder for a failed lookup: "no
+     * installer known", which is not the same fact as "nothing published". The
+     * page must not render the two alike.
+     */
+    readonly checked: boolean;
+    /** Milliseconds since the epoch of the lookup backing this reading. */
+    readonly checkedAt: number;
+    /** Platform the reading describes. */
+    readonly platform: string;
+    /** Channel the reading describes. */
+    readonly channel: string;
+    /** The newest installer, when the feed answered with one. */
+    readonly release?: DesktopRelease;
+}
+/**
+ * Read the newest installer out of one feed document.
+ *
+ * The top-level `path`/`sha512` pair is what the updater itself follows, so it
+ * wins over the `files:` list; that list is the fallback for a feed that only
+ * spells the payload out there. A document without both a version and an
+ * address is not a release this page can offer, and reads as `undefined`
+ * rather than as a half-filled row.
+ *
+ * @param source - the feed document as served.
+ * @returns the release it describes, or `undefined` when it describes none.
+ */
+export declare function parseDesktopFeed(source: string): DesktopRelease | undefined;
+/** Dependencies the reader needs, injectable for tests. */
+interface DesktopFeedDeps {
+    /** Fetch implementation; defaults to the global one. */
+    readonly fetchImpl?: typeof fetch;
+    /** Clock; defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * Ask the feed for the newest installer, cached per process.
+ *
+ * Concurrent callers share one in-flight lookup. A lookup that fails for any
+ * reason — network, timeout, a 404, a document without a release — resolves as
+ * "no installer known" rather than rejecting, so the settings page never
+ * breaks because the download host is unreachable.
+ */
+export declare function createDesktopFeedReader(deps?: DesktopFeedDeps): {
+    read(force?: boolean): Promise<DesktopReading>;
+};
+export {};

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

@@ -0,0 +1,10 @@
+/**
+ * The desktop app's download feed (advisory only).
+ *
+ * @module @dan-ai-studio/dshopencodego/desktop
+ */
+export { DESKTOP_CACHE_MS, DESKTOP_FEED_CHANNEL, DESKTOP_FEED_PLATFORM, DESKTOP_FEED_URL, DESKTOP_TIMEOUT_MS, } from './feed.ts';
+export type { DesktopReading, DesktopRelease } from './feed.ts';
+export { createDesktopFeedReader, parseDesktopFeed } from './feed.ts';
+export { OpencodeGoDesktopService } from './service.ts';
+export { desktopRemote, parseDesktopReading } from './contract.ts';

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

@@ -0,0 +1,30 @@
+/**
+ * Host half of the desktop Remote.
+ *
+ * One question: which installer does the desktop download host publish right
+ * now? The service answers from the cached feed reader in `./feed.ts`, so the
+ * settings page learns the address without the model path ever touching the
+ * network. Downloading and installing are intentionally absent — this only
+ * reports where the installer lives.
+ *
+ * @module @dan-ai-studio/dshopencodego/desktop/service
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { DesktopReading } from './feed.ts';
+/** Desktop Remote: the cached feed reading for the settings page. */
+export declare class OpencodeGoDesktopService extends TypertRemoteService {
+    private readonly read;
+    constructor(ctx: Context);
+    /**
+     * The newest published installer (cached reading).
+     *
+     * The wire method takes no arguments — the gateway client rejects any call
+     * whose positional arity differs from the descriptor's `parameters`, so a
+     * `force` flag cannot ride this call. Forced revalidation is the separate
+     * `refreshDesktop` method below, mirroring the update Remote's pair.
+     */
+    readDesktop(): Promise<DesktopReading>;
+    /** Revalidate against the feed, bypassing the cache. */
+    refreshDesktop(): Promise<DesktopReading>;
+}

package/lib/types/llm-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Raising this package's own LLM failures.
+ *
+ * `LlmError`'s constructor narrowed `code` to DSH's built-in union in
+ * `0.2.2-rc.2`, and that release added `LlmError.fromFailure` for a code any
+ * provider may have chosen. This package's side-channel codes
+ * (`USAGE_UNAVAILABLE`, `DOCUMENT_UNAVAILABLE`, `MODEL_METADATA_UNAVAILABLE`)
+ * are deliberately outside that union: they describe a usage probe or a
+ * document fetch, not a model request, and the built-in taxonomy has no word
+ * for them.
+ *
+ * Both paths are tried, because the declared peer range reaches back before
+ * `fromFailure` existed: the running build's method wins when present, and the
+ * constructor otherwise — its runtime check only requires a non-empty string,
+ * which is what `0.2.0-rc.1` through `0.2.2-rc.1` relied on.
+ *
+ * @module @dan-ai-studio/dshopencodego/llm-error
+ */
+import { LlmError } from '@deepseek-ai/dsh-llm';
+/**
+ * Build an {@link LlmError} carrying a code this package chose.
+ * @param message - human-readable failure text.
+ * @param code - this package's stable machine code.
+ * @param options - optional cause.
+ * @returns the error to throw.
+ */
+export declare function llmFailure(message: string, code: string, options?: ErrorOptions): LlmError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dan-ai-studio/dshopencodego",
-  "version": "0.1.91",
+  "version": "0.1.93",
   "description": "OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage",
   "type": "module",
   "license": "MIT",
@@ -126,30 +126,30 @@
     "@deepseek-ai/cordis": "4.1.0",
     "@deepseek-ai/cordis-plugin-include": "1.1.0",
     "@deepseek-ai/cordis-plugin-loader": "1.1.0",
-    "@deepseek-ai/dsh-api-remotes": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-brand": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-fs": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-launch-environment": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-sandbox": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-scope": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-settings": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-timeout": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-typert-registry": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-attachment": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-brand": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-store": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-credentials": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-fs": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-launch-environment": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-llm": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-sandbox": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-scope": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-settings": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-timeout": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-typert-registry": "0.2.2-rc.3",
     "@deepseek-ai/schemastery": "~3.19.0",
     "@earendil-works/pi-ai": "1.5.0",
     "@testing-library/dom": "^10.4.1",