@dan-ai-studio/dshopencodego 0.1.43 → 0.1.44

package/lib/types/update/service.js

@@ -1,39 +0,0 @@
-/**
- * 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 (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
-     * `refreshUpdate` method below, mirroring the catalog's read/refresh pair.
-     */
-    readUpdate() {
-        return this.check(false);
-    }
-    /** Revalidate against the registry, bypassing the cache. */
-    refreshUpdate() {
-        return this.check(true);
-    }
-}

package/lib/types/update/version.js

@@ -1,16 +0,0 @@
-/**
- * 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/lib/types/usage/contract.js

@@ -1,106 +0,0 @@
-/**
- * Wire contract for the usage Remote.
- *
- * Two readings are exposed, and they answer different questions: `readWindows`
- * asks the gateway what the account has left, and `readMeter` reports what this
- * process has actually spent since it started. Neither is a per-model quota —
- * the endpoint does not publish one — and the client labels them accordingly.
- *
- * @module @dan-ai-studio/dshopencodego/usage/contract
- */
-/** Validate one window on the way back from the Host. */
-function parseWindow(value, key) {
-    if (value === null || typeof value !== 'object')
-        throw new Error(`invalid usage window "${key}"`);
-    const row = value;
-    if ((row['status'] !== 'ok' && row['status'] !== 'rate-limited')
-        || typeof row['percent'] !== 'number' || !Number.isFinite(row['percent'])
-        || typeof row['resetsAt'] !== 'string') {
-        throw new Error(`invalid usage window "${key}"`);
-    }
-    return { status: row['status'], percent: row['percent'], resetsAt: row['resetsAt'] };
-}
-/** Validate a windows reading crossing the wire. */
-export function parseUsageWindows(value) {
-    if (value === null || typeof value !== 'object')
-        throw new Error('invalid usage reading');
-    const row = value;
-    return {
-        ...typeof row['source'] === 'string' ? { source: row['source'] } : {},
-        rolling: parseWindow(row['rolling'], 'rolling'),
-        weekly: parseWindow(row['weekly'], 'weekly'),
-        monthly: parseWindow(row['monthly'], 'monthly'),
-    };
-}
-function parseTotals(value) {
-    if (value === null || typeof value !== 'object')
-        throw new Error('invalid meter totals');
-    const row = value;
-    const count = (key) => {
-        const entry = row[key];
-        if (typeof entry !== 'number' || !Number.isFinite(entry) || entry < 0)
-            throw new Error(`invalid meter field "${key}"`);
-        return entry;
-    };
-    return {
-        calls: count('calls'),
-        inputTokens: count('inputTokens'),
-        outputTokens: count('outputTokens'),
-        cacheReadTokens: count('cacheReadTokens'),
-        cacheWriteTokens: count('cacheWriteTokens'),
-        totalTokens: count('totalTokens'),
-    };
-}
-/** Validate a meter reading crossing the wire. */
-export function parseGoMeter(value) {
-    if (value === null || typeof value !== 'object')
-        throw new Error('invalid meter reading');
-    const row = value;
-    if (typeof row['sinceMs'] !== 'number' || typeof row['atMs'] !== 'number' || !Array.isArray(row['models'])) {
-        throw new Error('invalid meter reading');
-    }
-    return {
-        sinceMs: row['sinceMs'],
-        atMs: row['atMs'],
-        totals: parseTotals(row['totals']),
-        models: row['models'].map((entry) => {
-            if (entry === null || typeof entry !== 'object')
-                throw new Error('invalid meter model entry');
-            const model = entry['model'];
-            if (typeof model !== 'string')
-                throw new Error('invalid meter model entry');
-            return { model, ...parseTotals(entry) };
-        }),
-    };
-}
-/** 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 usageRemote = {
-    package: '@dan-ai-studio/dshopencodego',
-    descriptors: [
-        {
-            id: '@dan-ai-studio/dshopencodego#opencodeGoUsage/readWindows',
-            service: 'opencodeGoUsage',
-            namespace: 'opencodeGoUsage',
-            method: 'readWindows',
-            invocation: { kind: 'direct' },
-            parameters: [],
-            result: codec('@dan-ai-studio/dshopencodego#GoUsageWindows', parseUsageWindows),
-        },
-        {
-            id: '@dan-ai-studio/dshopencodego#opencodeGoUsage/readMeter',
-            service: 'opencodeGoUsage',
-            namespace: 'opencodeGoUsage',
-            method: 'readMeter',
-            invocation: { kind: 'direct' },
-            parameters: [],
-            result: codec('@dan-ai-studio/dshopencodego#GoMeter', parseGoMeter),
-        },
-    ],
-};

package/lib/types/usage/index.js

@@ -1,8 +0,0 @@
-/**
- * Usage readings for the `opencode-go` route.
- * @module @dan-ai-studio/dshopencodego/usage
- */
-export { UsageMeter } from './meter.js';
-export { parseGoUsage, readUsageWindows } from './windows.js';
-export { parseGoMeter, parseUsageWindows, usageRemote } from './contract.js';
-export { OpencodeGoUsageService } from './service.js';

package/lib/types/usage/meter.js

@@ -1,65 +0,0 @@
-/**
- * The since-boot usage meter.
- *
- * The gateway's `/usage` endpoint reports account percentages, not tokens, so
- * the only honest source of per-model token counts is the usage the provider
- * itself returns on each completed call. This meter accumulates exactly that,
- * per model and in total, for the lifetime of the process — and says so: the
- * number is labelled "since this Harness started", never "today".
- *
- * A conversation's own totals are durable and are folded from the session log
- * by the client, which is why nothing here persists.
- *
- * @module @dan-ai-studio/dshopencodego/usage/meter
- */
-const EMPTY = {
-    calls: 0,
-    inputTokens: 0,
-    outputTokens: 0,
-    cacheReadTokens: 0,
-    cacheWriteTokens: 0,
-    totalTokens: 0,
-};
-function add(totals, usage) {
-    const inputTokens = totals.inputTokens + usage.inputTokens;
-    const outputTokens = totals.outputTokens + usage.outputTokens;
-    const cacheReadTokens = totals.cacheReadTokens + (usage.cacheReadTokens ?? 0);
-    const cacheWriteTokens = totals.cacheWriteTokens + (usage.cacheWriteTokens ?? 0);
-    return {
-        calls: totals.calls + 1,
-        inputTokens,
-        outputTokens,
-        cacheReadTokens,
-        cacheWriteTokens,
-        // The four counts are disjoint (uncached input, cached input, output), so
-        // their sum is the billed total. The provider's own `totalTokens` is not
-        // used: it is optional, and mixing the two would double-count a cache read.
-        totalTokens: inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens,
-    };
-}
-/** Accumulates provider-reported usage for the lifetime of one Host process. */
-export class UsageMeter {
-    sinceMs = Date.now();
-    totals = EMPTY;
-    byModel = new Map();
-    /**
-     * Record one completed call.
-     * @param model - the model id the call was made with.
-     * @param usage - the provider's own usage for that call.
-     */
-    record(model, usage) {
-        this.totals = add(this.totals, usage);
-        this.byModel.set(model, add(this.byModel.get(model) ?? EMPTY, usage));
-    }
-    /** The current reading, busiest model first. */
-    snapshot(now = Date.now()) {
-        return {
-            sinceMs: this.sinceMs,
-            atMs: now,
-            totals: this.totals,
-            models: [...this.byModel.entries()]
-                .map(([model, totals]) => ({ model, ...totals }))
-                .sort((left, right) => right.totalTokens - left.totalTokens || left.model.localeCompare(right.model)),
-        };
-    }
-}

package/lib/types/usage/service.js

@@ -1,74 +0,0 @@
-/**
- * Host half of the usage Remote.
- *
- * The credential never leaves the Host: the browser asks for a reading and gets
- * percentages, and the Host decides whether a failed read may be shown as the
- * previous one. A read that fails while the account is unchanged keeps the last
- * good value and says it is stale; a read for a different endpoint or key
- * invalidates it, because the old numbers describe a different account.
- *
- * @module @dan-ai-studio/dshopencodego/usage/service
- */
-import { randomUUID } from 'node:crypto';
-import { RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import { LlmError } from '@deepseek-ai/dsh-llm';
-import { assertBaseURL } from '../config.js';
-import { readUsageWindows } from './windows.js';
-/**
- * Decide what one failed read means for the client.
- *
- * A missing credential is a configuration fact, not a transient one: retrying
- * cannot help and the reading a client holds was produced by a *different*
- * account, so it must not be shown as this one's. Any other failure describes
- * the account the client already has a reading for, so that reading stays valid
- * and is marked stale.
- * @param error - the failure raised by credential resolution or the read.
- * @param source - identity of the account the failed read was for.
- * @returns the domain error to send across the wire.
- */
-export function usageFailure(error, source) {
-    const missing = error instanceof LlmError && error.code === 'MISSING_CREDENTIAL';
-    return new RemoteError('dshopencodego/usage-unavailable', error instanceof Error ? error.message : 'OpenCode Go usage is unavailable', missing
-        ? { retryable: false, retainPrevious: false }
-        : { retryable: true, retainPrevious: true, ...source === undefined ? {} : { source } }, { cause: error });
-}
-/** Usage Remote: account windows from the gateway, spend from this process. */
-export class OpencodeGoUsageService extends TypertRemoteService {
-    identity;
-    options;
-    constructor(ctx, options) {
-        super(ctx, 'opencodeGoUsage');
-        this.options = options;
-    }
-    /** The account's three windows, or a domain failure the client can render. */
-    async readWindows() {
-        const baseURL = assertBaseURL(this.options.baseURL());
-        let key;
-        try {
-            key = await this.options.resolveApiKey();
-        }
-        catch (error) {
-            this.identity = undefined;
-            throw usageFailure(error, undefined);
-        }
-        if (key === undefined || key.length === 0) {
-            this.identity = undefined;
-            throw usageFailure(new LlmError('No OpenCode Go API key is configured', 'MISSING_CREDENTIAL'), undefined);
-        }
-        if (this.identity?.baseURL !== baseURL || this.identity.key !== key) {
-            // A new account or endpoint invalidates any reading the client holds.
-            this.identity = { baseURL, key, source: randomUUID() };
-        }
-        const { source } = this.identity;
-        try {
-            return await readUsageWindows({ baseURL, apiKey: key, source });
-        }
-        catch (error) {
-            throw usageFailure(error, source);
-        }
-    }
-    /** What this process has spent through the route since it started. */
-    readMeter() {
-        return this.options.meter.snapshot();
-    }
-}

package/lib/types/usage/windows.js

@@ -1,84 +0,0 @@
-/**
- * The account's usage windows, read from the gateway.
- *
- * `/usage` reports three percentages — a rolling five-hour window, a week, and
- * a month — each with a reset time and a rate-limited flag. It reports *no*
- * per-model breakdown and no token counts, so this module never pretends to:
- * per-model and per-session numbers are derived locally from real provider
- * usage instead (see `./meter.ts` and the session fold in the client).
- *
- * @module @dan-ai-studio/dshopencodego/usage/windows
- */
-import { attributionHeaders, LlmError } from '@deepseek-ai/dsh-llm';
-import { readBoundedJson } from '../catalog/json-response.js';
-/** Response cap: this document is a few hundred bytes. */
-const USAGE_MAX_BYTES = 1024 * 1024;
-/** Timeout for one usage read. */
-const USAGE_TIMEOUT_MS = 10_000;
-/**
- * Parse a usage response body.
- * @param value - the `usage` member of the response.
- * @returns the three windows.
- * @throws {Error} when a window is missing or malformed; an unavailable reading
- *   must never be displayed as a zero percentage.
- */
-export function parseGoUsage(value) {
-    if (value === null || typeof value !== 'object')
-        throw new Error('invalid usage response');
-    const source = value;
-    const result = {};
-    for (const key of ['rolling', 'weekly', 'monthly']) {
-        const row = source[key];
-        if (row === null || row === undefined
-            || (row.status !== 'ok' && row.status !== 'rate-limited')
-            || typeof row.percent !== 'number' || !Number.isFinite(row.percent) || row.percent < 0
-            || typeof row.resetsAt !== 'string' || !Number.isFinite(Date.parse(row.resetsAt))) {
-            throw new Error(`invalid usage response: window "${key}" is missing or malformed`);
-        }
-        result[key] = { status: row.status, percent: row.percent, resetsAt: row.resetsAt };
-    }
-    return result;
-}
-/**
- * Read the account's usage windows.
- * @param options - endpoint, credential, and identity.
- * @returns the three windows, tagged with the identity that produced them.
- * @throws {LlmError} `USAGE_UNAVAILABLE` when the credential is missing, the
- *   endpoint fails, or the body is not a usage document.
- */
-export async function readUsageWindows(options) {
-    if (options.apiKey === undefined || options.apiKey.length === 0) {
-        throw new LlmError('dshopencodego: no credential is configured for the opencode-go route', 'USAGE_UNAVAILABLE');
-    }
-    const url = `${options.baseURL.replace(/\/+$/, '')}/usage`;
-    const timeout = AbortSignal.timeout(USAGE_TIMEOUT_MS);
-    let response;
-    try {
-        response = await fetch(url, {
-            redirect: 'error',
-            headers: {
-                ...attributionHeaders(),
-                accept: 'application/json',
-                authorization: `Bearer ${options.apiKey}`,
-            },
-            signal: options.signal === undefined ? timeout : AbortSignal.any([options.signal, timeout]),
-        });
-    }
-    catch (error) {
-        throw new LlmError(`could not reach ${url}`, 'USAGE_UNAVAILABLE', { cause: error });
-    }
-    if (!response.ok) {
-        await response.body?.cancel().catch(() => { });
-        throw new LlmError(`${url} answered HTTP ${response.status}`, 'USAGE_UNAVAILABLE');
-    }
-    const body = await readBoundedJson(response, url, USAGE_MAX_BYTES);
-    try {
-        return {
-            ...parseGoUsage(body?.usage),
-            ...options.source === undefined ? {} : { source: options.source },
-        };
-    }
-    catch (error) {
-        throw new LlmError(`${url} returned an invalid usage document`, 'USAGE_UNAVAILABLE', { cause: error });
-    }
-}