super-dsh 0.3.3 → 0.3.4-a

package/superd-hub/dist/client/companion-api.js

@@ -1,30 +0,0 @@
-/** Local ctx0 companion management, independent of the selected agent world. */
-import { mintRpcId } from './runtime-settings-api.js';
-export async function callCompanion(operation, doFetch) {
-    const method = `superdCompanions/${operation}`;
-    const send = doFetch ?? ((path, init) => fetch(path, init));
-    const response = await send(`/api/${method}`, {
-        method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ type: 'client-request', rpcId: mintRpcId(), method, payload: { args: {} } }),
-    });
-    if (!response.ok)
-        throw new Error(`Better Dash: HTTP ${response.status}`);
-    let body;
-    try {
-        body = JSON.parse(await response.text());
-    }
-    catch {
-        throw new Error('Better Dash: unreadable response');
-    }
-    const result = body?.result;
-    if (result?.ok !== true)
-        throw new Error(result?.error?.message ?? 'Better Dash: request failed');
-    const value = result.value;
-    if (value === null || typeof value !== 'object' || typeof value.installed !== 'boolean'
-        || typeof value.installing !== 'boolean' || typeof value.requestedVersion !== 'string'
-        || (value.version !== undefined && typeof value.version !== 'string')
-        || (value.enabled !== undefined && typeof value.enabled !== 'boolean')
-        || (value.error !== undefined && typeof value.error !== 'string'))
-        throw new Error('Better Dash: invalid status');
-    return value;
-}

package/superd-hub/dist/companion-contract.d.ts

@@ -1,9 +0,0 @@
-/** Browser-safe ctx0 companion status returned by the native unary API. */
-export interface BetterDashStatus {
-    installed: boolean;
-    version?: string;
-    enabled?: boolean;
-    installing: boolean;
-    error?: string;
-    requestedVersion: string;
-}

package/superd-hub/dist/companion-contract.js

@@ -1 +0,0 @@
-export {};

package/superd-hub/dist/companions.d.ts

@@ -1,30 +0,0 @@
-import type { ProfileContext } from '@deepseek-ai/dsh-app-boot';
-import type { PluginManager } from '@deepseek-ai/dsh-plugin-manager';
-import type { BetterDashStatus } from './companion-contract.js';
-type Manager = Pick<PluginManager, 'listBundles' | 'installBundle'>;
-/** One controller per native profile; no package, registry, HMR or selection writer of its own. */
-export declare class BetterDashCompanion {
-    private readonly version;
-    private readonly manager;
-    private readonly directory;
-    private readonly receipt;
-    private readonly legacy;
-    private initialized?;
-    private intent;
-    private active?;
-    private stopped;
-    private restartNotice?;
-    constructor(profile: Pick<ProfileContext, 'home' | 'dir'>, version: string, manager: () => Manager | undefined);
-    private initialize;
-    private cleanLegacy;
-    private save;
-    getBetterDash(): Promise<BetterDashStatus>;
-    ensureAutomatic(): Promise<BetterDashStatus>;
-    installBetterDash(): Promise<BetterDashStatus>;
-    private run;
-    private install;
-    /** Read-only observation: an intermediate native event must never trigger reinstatement. */
-    observeNativeChange(): Promise<BetterDashStatus>;
-    dispose(): void;
-}
-export {};

package/superd-hub/dist/companions.js

@@ -1,211 +0,0 @@
-/** Companion intent and the single native installation operation. */
-import { createHash } from 'node:crypto';
-import { readFile, mkdir, unlink, rmdir } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { writeFileAtomic } from '@deepseek-ai/dsh-atomic-write';
-// done marks a CONFIRMED first use (Better observed installed); removed marks a
-// migrated legacy removal record. A receipt with attempted but neither done,
-// error, nor removed is an interrupted first use — e.g. killed by the restart
-// that installing Super itself triggers — and must re-arm, not suppress, the retry.
-const message = (error) => error instanceof Error ? error.message : String(error);
-async function optionalJson(path) {
-    try {
-        return JSON.parse(await readFile(path, 'utf8'));
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-}
-function nativeFailure(result) {
-    if ((result.application === 'applied' || result.application === 'restart-required') && result.error === undefined
-        && (result.packageResult === undefined || result.packageResult.exitCode === 0))
-        return undefined;
-    return [result.application, result.error?.code, result.error?.diagnostic,
-        result.packageResult?.kind, result.packageResult?.logPath].filter(Boolean).join(': ');
-}
-/** One controller per native profile; no package, registry, HMR or selection writer of its own. */
-export class BetterDashCompanion {
-    version;
-    manager;
-    directory;
-    receipt;
-    legacy;
-    initialized;
-    intent = { attempted: false };
-    active;
-    stopped = false;
-    restartNotice;
-    constructor(profile, version, manager) {
-        this.version = version;
-        this.manager = manager;
-        const key = createHash('sha256').update(profile.dir).digest('hex') + '.json';
-        this.directory = join(profile.home, 'superd', 'companions');
-        this.receipt = join(this.directory, key);
-        this.legacy = join(profile.home, 'companion-registration', key);
-    }
-    initialize() {
-        return this.initialized ??= (async () => {
-            const saved = await optionalJson(this.receipt);
-            if (saved !== undefined) {
-                // Never-resurrect applies to a CONFIRMED first use, a recorded failure,
-                // or a migrated removal record; an interrupted first use (no done, no
-                // error, no removal marker) re-arms.
-                this.intent = saved.attempted && saved.done !== true && saved.error === undefined && saved.removed !== true
-                    ? { attempted: false } : saved;
-                await this.cleanLegacy();
-                return;
-            }
-            const old = await optionalJson(this.legacy);
-            // Any old registration was first use. An absent Better now means removal,
-            // including when Super has since changed version; never resurrect it.
-            if (old?.['super-dsh:better-dsh'] !== undefined) {
-                this.intent = { attempted: true, removed: true };
-                await this.save();
-                await this.cleanLegacy();
-            }
-        })();
-    }
-    async cleanLegacy() {
-        try {
-            await unlink(this.legacy);
-        }
-        catch (error) {
-            if (error.code !== 'ENOENT')
-                throw error;
-        }
-        try {
-            await rmdir(dirname(this.legacy));
-        }
-        catch (error) {
-            if (!['ENOENT', 'ENOTEMPTY'].includes(error.code ?? ''))
-                throw error;
-        }
-    }
-    async save() {
-        await mkdir(this.directory, { recursive: true, mode: 0o700 });
-        await writeFileAtomic(this.receipt, JSON.stringify(this.intent) + '\n', { mode: 0o600 });
-    }
-    async getBetterDash() {
-        const status = { installed: false, installing: this.active !== undefined, requestedVersion: this.version };
-        try {
-            await this.initialize();
-            const manager = this.manager();
-            if (manager === undefined)
-                throw new Error('Native Plugin Manager is unavailable; enable it and retry Install in Settings.');
-            const better = (await manager.listBundles()).find(bundle => bundle.name === 'better-dsh' && bundle.installed);
-            if (better !== undefined) {
-                status.installed = true;
-                if (better.version !== undefined)
-                    status.version = better.version;
-                status.enabled = better.enabled;
-                // An installed dependency alone does not prove application succeeded:
-                // native configure can fail after writing that dependency. Only a
-                // missing -> installed recovery clears a previous failure here.
-                if (this.active === undefined && this.intent.attempted
-                    && (this.intent.done !== true || (this.intent.error !== undefined && this.intent.missingAfterFailure === true))) {
-                    this.intent.done = true;
-                    delete this.intent.error;
-                    delete this.intent.missingAfterFailure;
-                    await this.save();
-                }
-            }
-            else {
-                this.restartNotice = undefined;
-                if (this.active === undefined && this.intent.error !== undefined && this.intent.missingAfterFailure !== true) {
-                    this.intent.missingAfterFailure = true;
-                    await this.save();
-                }
-            }
-            const error = this.intent.error ?? this.restartNotice;
-            if (error !== undefined)
-                status.error = error;
-        }
-        catch (error) {
-            status.error = message(error);
-        }
-        return status;
-    }
-    ensureAutomatic() { return this.run(false); }
-    installBetterDash() { return this.run(true); }
-    run(manual) {
-        if (this.active !== undefined)
-            return this.active;
-        const task = this.install(manual).catch(async (error) => {
-            this.intent.error = `Better Dash installation failed: ${message(error)}. Check Better Dash in Plugin Manager; if missing, retry Install in Settings.`;
-            const status = await this.getBetterDash();
-            this.intent.missingAfterFailure = !status.installed;
-            try {
-                await this.save();
-            }
-            catch { /* Report the operation error even when persistence is unavailable. */ }
-            return status;
-        }).then(status => ({ ...status, installing: false })).finally(() => { this.active = undefined; });
-        this.active = task;
-        return task;
-    }
-    async install(manual) {
-        await this.initialize();
-        const before = await this.getBetterDash();
-        if (this.stopped)
-            return before;
-        if (before.installed) {
-            this.intent.attempted = true;
-            this.intent.done = true;
-            if (this.intent.missingAfterFailure === true) {
-                delete this.intent.error;
-                delete this.intent.missingAfterFailure;
-            }
-            await this.save();
-            return this.getBetterDash(); // Native disablement and installed versions belong to the user.
-        }
-        // Native changed notifications enter through this operation, so its
-        // read is active and deliberately cannot update the receipt itself.
-        // Record removal here even when first-use installation is already done.
-        if (this.intent.error !== undefined && this.intent.missingAfterFailure !== true) {
-            this.intent.missingAfterFailure = true;
-            await this.save();
-        }
-        if (!manual && this.intent.attempted)
-            return before;
-        this.intent = { attempted: true };
-        await this.save(); // First use is durable before native HMR can unload this row.
-        const manager = this.manager();
-        if (manager === undefined)
-            throw new Error('Native Plugin Manager is unavailable');
-        if (this.version === 'unknown' || this.version.trim() === '')
-            throw new Error('The installed Super Dash package version could not be read');
-        const failures = [];
-        for (const spec of [`better-dsh@${this.version}`, 'better-dsh@latest', 'better-dsh']) {
-            if (this.stopped)
-                break;
-            try {
-                const result = await manager.installBundle(spec);
-                const failure = nativeFailure(result);
-                if (failure === undefined) {
-                    const after = await this.getBetterDash();
-                    if (after.installed) {
-                        this.intent.done = true;
-                        delete this.intent.error;
-                        delete this.intent.missingAfterFailure;
-                        this.restartNotice = result.application === 'restart-required'
-                            ? 'Better Dash is installed; restart DSH to apply the native change.' : undefined;
-                        await this.save();
-                        return this.getBetterDash();
-                    }
-                    failures.push(`${spec}: native manager reported ${result.application}, but Better Dash is not installed`);
-                }
-                else
-                    failures.push(`${spec}: ${failure}`);
-            }
-            catch (error) {
-                failures.push(`${spec}: ${message(error)}`);
-            }
-        }
-        throw new Error(failures.join('; ') || 'Super Dash companion component was unloaded');
-    }
-    /** Read-only observation: an intermediate native event must never trigger reinstatement. */
-    async observeNativeChange() { return this.getBetterDash(); }
-    dispose() { this.stopped = true; }
-}