super-dsh 0.3.0-e → 0.3.0-g

package/remote/provenance.json

@@ -0,0 +1,64 @@
+{
+  "format": 1,
+  "entry": "better-dsh/src/remote/plugin.ts",
+  "workerEntry": "better-dsh/src/remote/file-worker.ts",
+  "sources": {
+    "better-dsh/src/remote/agent-registration.ts": "459301354ea1ab713984bb01bc491a080256d4e983e55ff074e2665c3213d355",
+    "better-dsh/src/remote/archive-python.ts": "9494689d508fa0f145cb7fc562233ce07fb1a88c2127b68c51b0b48bdd790611",
+    "better-dsh/src/remote/archive.ts": "fd32f96dc63421be7d56eb545badf355c6ee2498599605ffa48958b9efca9a63",
+    "better-dsh/src/remote/copy.ts": "345b348c658b75d9f678aaa1b3d4fce6115cb61a7f0ff6966727f15b570cdc35",
+    "better-dsh/src/remote/driver.ts": "e2bd098b4ac8eb1ed766b8a0826027c4dff84d98913c120dbb37cec433227fd7",
+    "better-dsh/src/remote/endpoints.ts": "280bf0cc3dbc939ef2ccee940e61e05f40f35c9d8782e3d1824da47260958ed4",
+    "better-dsh/src/remote/file-worker.ts": "31ac019a944cf7fdcd0ff044f8b330d923bf4d384c77056f9b7e3032bc8c9598",
+    "better-dsh/src/remote/hub-contract.ts": "4bd333f3ef3e94305a64f04c03948a9dae4bbf5268b0d26d9de99770be2d8ac9",
+    "better-dsh/src/remote/input.ts": "7e543adb0973c25cbd24103c2d838db0fdacdd32525278d789004fc237dcd924",
+    "better-dsh/src/remote/jobs.ts": "9587f2694426fcf00ff33d9db164d5b15ea659aed7dbcb1df2640fa3f08b2149",
+    "better-dsh/src/remote/nonce-framing.ts": "5592fec76cec0c1e1ac75f4806d0904cd111bf2061b1fada4f0dfa12014d1233",
+    "better-dsh/src/remote/oneshot.ts": "99f2c809ba1159c7865ec3cff2e6d7b1f165a7f03185a6fc9505c1a534ba57bc",
+    "better-dsh/src/remote/output-ring.ts": "a79104bd3dcddab06a3fe7e52d239a70becd4f2dcddd0c9b6513f5fe3c4ed0bc",
+    "better-dsh/src/remote/plugin.ts": "96a7cd4878d7a4ef76ed26cf48d58824ecf40e6892078ad55c9b3bacbdebe41e",
+    "better-dsh/src/remote/process.ts": "478eef8a252aa2747e8890950c5d6785e2d877343377c7f4f0da3ba1c32f77db",
+    "better-dsh/src/remote/pty-session.ts": "8ea63b3357c681c5dcacacbfb99da532cae8ed293482e7a54c0362b0f9f27a3d",
+    "better-dsh/src/remote/roster.ts": "753803521accb7a5eacc19a9bada648af8ee5fc67a152247915b92e9ddeb6887",
+    "better-dsh/src/remote/rsync.ts": "9cb0f4d2d0de599220024e33cc8c3eb3979e68b694f2486cf1b31bc2a4a0273c",
+    "better-dsh/src/remote/ssh-config.ts": "71ce833be5c934430e8a9ca982af055fccb71d6c3e64513ae83e7937b070e446",
+    "better-dsh/src/remote/ssh-lease.ts": "834c769b74996b3b8fb5d68b6bddae7ab8e72fb1d5d23229fa1c0f2ca780c504",
+    "better-dsh/src/remote/ssh-process.ts": "583502d157b0ae2dacd8a635200713727c7354e6793e40f924cac41d62b1bd2c",
+    "better-dsh/src/remote/ssh-relay.ts": "88eef0344f04e34f243780a44f7a94f0822dfc79c824e95a8f552034491df34c",
+    "better-dsh/src/remote/ssh-source-proxy.ts": "5ebb132ec9ae3263bd2bd76545abb63bec58521bc0703ffd793c90ef05c1923c",
+    "better-dsh/src/remote/ssh-targets.ts": "b8d83bfeda038ab604b4b6e312a719926508ea82fb54d2c02b939b51fbf7bbc3",
+    "better-dsh/src/remote/status.ts": "54264917bd50401c5a2f2ff9df325af7a5e790597e6307fcdc46a8455d18b530",
+    "better-dsh/src/remote/target.ts": "965a04b3561aa56ee089876a869fd2116b1773ef34b053b3006905fcde063a43",
+    "better-dsh/src/remote/tool.ts": "3222ac9e9460353e38170346b58b1be8e8beb066fa95fc90344c60aa673339e2",
+    "better-dsh/src/remote/transports.ts": "545706b7ef14c5fb626964b5b63f4b946e026ea90a5efc5202c5a38503f9bc16",
+    "better-dsh/third_party/schemastery/lib/index.cjs": "aca1c1a47c7b6034feee01501aefca3e6dd97a0bac4fe334fd30647ae5a9e480",
+    "better-dsh/third_party/schemastery/lib/index.d.mts": "66847f605af58c42575333c825eefdec4ad38278ad6cb260e37aa0cc63803bbd",
+    "better-dsh/third_party/schemastery/lib/index.mjs": "cfcbe46c7416bdb35ce891c252152bbf519e08199bede5930dd7cb880c65f1ef",
+    "better-dsh/third_party/schemastery/lib/types/index.d.ts": "fca846c1420a192b7ae749da96afa0c9b5c57b2e7dff418153674f90200f4e27",
+    "better-dsh/third_party/schemastery/lib/types/index.d.ts.map": "ee91a9f4c24c9bc82b5a37e8c84f690f5ec6e2385795902683557b0a08812e47",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/index.js": "ba44c0871656e4c7cac2c3c8a2ff644e0d2eb9d6bda7f6355866d686d513268e",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/array.d.ts": "f63b6a79179ea0f70902e1c9d8c98b3fd457b124c7c5dcb3adccc4fae5a8c5b6",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/array.d.ts.map": "76e7996107ba6d4ea97eebe33c825e85f53392fd9b21e87248d0030903f5cdf1",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/index.d.ts": "850b1bde1c4b0dd26069a365e3837180890205f243f962838c4b769302aa583b",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/index.d.ts.map": "cc8b19e444b8d7a04697460273e5ace19f1ea4ca51bbc987b3397c0e261d5e5c",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/misc.d.ts": "b3ffb1d306130b143d309b7621dc0f94446bf0d0721a5aeaae92f1112c3a852c",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/misc.d.ts.map": "7fd470887c2b1a2c86c5b149fdfddc90d7a00bea047547391ad6d169d1bc468f",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/string.d.ts": "018925218746fd81518276960ee5eaaf7664f7ac0a1bc01d6604903254186ced",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/string.d.ts.map": "6f10c183f6f0c7aac796f6fd0ae3b16b30d455a86d7d2018ecf3641093adeeac",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/time.d.ts": "2fb4faf4cb90b96c83a3282f6cad6eafd3395a251ae2d193a0a27c63cf4dfc78",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/time.d.ts.map": "afad91a505bd82c857a69ad72718e59d4a08f05c35493854ac000ace760a3a51",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/types.d.ts": "ecec322706391b1eed65497f97bb2ba53dfee289d276c35b91ad83550b61a2fa",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/types.d.ts.map": "6da6f71fd5de4144c9f2862aad0951c5586e7b03e95a9624c4ec5730c39cd368",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/volatile.d.ts": "9733d9ecf59e8b86a6e5605c830e2efacbd93e527c3fd8388aaf0d09649fef0c",
+    "better-dsh/third_party/schemastery/node_modules/@deepseek-ai/cosmokit/lib/types/volatile.d.ts.map": "7f41de53d13986b169df89edba078f017f0acdaff8338d00ddc45596a19fefa4",
+    "better-dsh/third_party/schemastery/node_modules/@standard-schema/spec/dist/index.cjs": "68eba92bc1637688388d7adc1fe5aa748b27c7101ad40123e64135bb5e9ed8e7",
+    "better-dsh/third_party/schemastery/node_modules/@standard-schema/spec/dist/index.d.cts": "bdd14f07b4eca0b4b5203b85b8dbc4d084c749fa590bee5ea613e1641dcd3b29",
+    "better-dsh/third_party/schemastery/node_modules/@standard-schema/spec/dist/index.d.ts": "bdd14f07b4eca0b4b5203b85b8dbc4d084c749fa590bee5ea613e1641dcd3b29",
+    "better-dsh/third_party/schemastery/node_modules/@standard-schema/spec/dist/index.js": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+  },
+  "outputs": {
+    "file-worker.js": "f84f5b48de915949d85c3d0340a343cc5901218c3bc2dafdf5cecaa244f7b6e3",
+    "plugin.d.ts": "d3d4c66e98bfda9ef29fec639991dc9f7eeab960e915edf042050b5b82c91870",
+    "plugin.js": "91d8903c9ececd4ad6f11d4a7580efb5e68e68221b180646a187baad7a2df99e"
+  }
+}

package/superd-hub/dist/a2a-row.d.ts

@@ -38,14 +38,21 @@
  * (a2a-host.ts), and FEDERATED wire adapters pass through unwrapped.
  */
 import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
 /** Stable Cordis plugin (row) name. */
 export declare const name = "superd-a2a";
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    localExec: z<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    localExec: z<boolean, boolean, "defined">;
+}>>, "plain">;
 /** Zero static injects — the tools/typertGateway legs are dynamic (dormancy). */
 export declare const inject: string[];
 /** Injection seam for tests: a tmpdir home instead of the ambient/prod DSH_HOME (rpc.ts discipline). */
 export interface HubToolRowOptions {
     /** Hub home backing the registries; defaults to `resolveDshHome()` at wiring time. */
     home?: string;
+    localExec?: boolean;
 }
 /**
  * Wire the tool row: build T2+T3's service with ctx0's own gateway injected
@@ -56,10 +63,19 @@ export interface HubToolRowOptions {
  */
 export declare function wireHubToolRow(ctx: Context, opts?: HubToolRowOptions): void;
 /** MUST stay an arrow (RM0/better-dash note: function declarations get `new`-called, disposers lost). */
-export declare const apply: (ctx: Context) => void;
+export declare const apply: (ctx: Context, config?: {
+    localExec?: boolean;
+}) => void;
 declare const _default: {
     name: string;
     inject: string[];
-    apply: (ctx: Context) => void;
+    Config: z<Schemastery.ObjectS<NoInfer<{
+        localExec: z<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        localExec: z<boolean, boolean, "defined">;
+    }>>, "plain">;
+    apply: (ctx: Context, config?: {
+        localExec?: boolean;
+    }) => void;
 };
 export default _default;

package/superd-hub/dist/a2a-row.js

@@ -8,13 +8,10 @@ import { setSweepCollectors } from './mesh-link.js';
 import { consoleA2aLog } from './a2a-log.js';
 import { createA2aService } from './a2a-service.js';
 import { resolveA2aGatewayFor, localA2aInitiator } from './a2a-host.js';
-import { registerA2aRpc, registerExecRpc } from './mesh-rpc.js';
-import { runOneShotExec, postOneShotExec } from './exec.js';
+import { registerA2aRpc } from './mesh-rpc.js';
 import { ensureSelf, listRemotes } from './machines.js';
-import { cookieOf } from './mesh-link.js';
-import { PtyPool } from './exec-pty-session.js';
-import { LocalScriptChannel, WsPtyChannel } from './exec-pty-channel.js';
-import { PTY_EXEC_PATH } from './exec-pty-rpc.js';
+import { createHubExec } from './remote-provider.js';
+import z from '@deepseek-ai/schemastery';
 import { agentLinks } from './agent-roster.js';
 import { foreignAgentHandle, registerForeignHubHost, foreignHubEndpoint } from './foreign-hub.js';
 import { refreshHermesNativeEndpoint } from './foreign-native.js';
@@ -22,6 +19,7 @@ import { refreshClaudeNativeEndpoint } from './foreign-claude.js';
 import { refreshAgyNativeEndpoint } from './foreign-agy.js';
 /** Stable Cordis plugin (row) name. */
 export const name = 'superd-a2a';
+export const Config = z.object({ localExec: z.boolean().default(false) });
 /** Zero static injects — the tools/typertGateway legs are dynamic (dormancy). */
 export const inject = [];
 /**
@@ -87,70 +85,14 @@ export function wireHubToolRow(ctx, opts = {}) {
         // /api fence like the machines route; registered on the same inject scope
         // (they live and die with the typertGateway seam).
         registerA2aRpc(t, ingestRef);
-        // P4: the exec endpoint rides the same shared /api fence (spec §8.1).
-        registerExecRpc(t, alog);
-        // P4 exec face: the local executing side + the wire leg over the pairing
-        // cookie. The initiator-side per-machine knob (execEnabled) is honored
-        // here, before any bytes leave (spec §5).
-        const execFace = {
-            selfM4: () => ensureSelf(home, 'local').id,
-            run: (input) => runOneShotExec(input, alog),
-            post: async (machineId, input) => {
-                const row = listRemotes(home).find((r) => r.id === machineId);
-                if (row === undefined)
-                    throw new Error(`unknown machine "${machineId}" — call agents for the roster`);
-                if (row.execEnabled === false)
-                    throw new Error(`exec is disabled for machine "${machineId}" on this registry row (execEnabled=false)`);
-                alog?.('info', 'exec.remote', { machine: machineId, cmd: input.cmd, timeoutSec: input.timeoutSec ?? 120 });
-                const result = await postOneShotExec(row.origin, input, { cookie: cookieOf(row.id, home) });
-                // F6 (first-person 0.1.7-d finding): the initiator side needs its own
-                // completion line — without it a remote result lives only in the tool
-                // response and the initiator's journal stays blind to the outcome.
-                alog?.('info', 'exec.remote.done', {
-                    machine: machineId,
-                    exit: result.exit ?? 'none',
-                    durationMs: result.durationMs,
-                    ...(result.outcome === 'exited' ? {} : { outcome: result.outcome }),
-                    ...(result.truncated ? { truncated: true } : {}),
-                });
-                return result;
-            },
-        };
-        // P4 §8.2 initiator half: the PTY pool. Session key = (calling DSH
-        // session, machine) — per-agent direct, no central allocation (D12).
-        const ptyPool = new PtyPool({ idleTtlSec: 600 });
-        ctx.effect(() => () => { void ptyPool.disposeAll(); }, 'superd-a2a: pty pool teardown');
-        const execPty = async (sessionKey, machine, cmd, opts = {}) => {
-            const channelOf = () => {
-                if (machine === ensureSelf(home, 'local').id)
-                    return new LocalScriptChannel();
-                const row = listRemotes(home).find((r) => r.id === machine);
-                if (row === undefined)
-                    throw new Error(`unknown machine "${machine}" — call agents for the roster`);
-                if (row.execEnabled === false)
-                    throw new Error(`exec is disabled for machine "${machine}" on this registry row (execEnabled=false)`);
-                alog?.('info', 'exec.pty.dial', { machine, session: sessionKey });
-                return new WsPtyChannel(`${row.origin.replace(/^http/, 'ws')}${PTY_EXEC_PATH}`, { cookie: cookieOf(row.id, home) });
-            };
-            const session = ptyPool.getOrCreate(`${sessionKey}|m:${machine}`, channelOf);
-            const result = await session.dispatch(cmd, { ...(opts.timeoutSec === undefined ? {} : { timeoutSec: opts.timeoutSec }) });
-            alog?.('info', 'exec.pty.run', {
-                machine,
-                cmd: cmd.length > 120 ? `${cmd.slice(0, 117)}...` : cmd,
-                exit: result.exit ?? 'none',
-                ...(result.cwd !== null ? { cwd: result.cwd } : {}),
-                durationMs: result.durationMs,
-                ...(result.reconnected ? { reconnected: true } : {}),
-                ...(result.timedOut ? { timedOut: true } : {}),
-            });
-            return result;
-        };
-        const execFaceFull = { ...execFace, pty: execPty };
+        const exec = createHubExec(home, alog);
+        t.effect(() => () => exec.dispose(), 'superd-a2a: exec initiator cleanup');
         // the a2a endpoints (POST /api/superd/a2a + GET /api/superd/a2a/outbox) ride the shared
         const toolDeps = {
             service,
             delivery,
-            exec: execFaceFull,
+            exec: exec.face,
+            localExec: opts.localExec ?? false,
             // R6: the agent_status leg reads the R5 cache (the sweep's legs fill it)
             status: () => loadAgentStatus(home),
             roster: () => rosterViewOf(home),
@@ -173,7 +115,7 @@ export function wireHubToolRow(ctx, opts = {}) {
     });
 }
 /** MUST stay an arrow (RM0/better-dash note: function declarations get `new`-called, disposers lost). */
-export const apply = (ctx) => {
-    wireHubToolRow(ctx);
+export const apply = (ctx, config = {}) => {
+    wireHubToolRow(ctx, config);
 };
-export default { name, inject, apply };
+export default { name, inject, Config, apply };

package/superd-hub/dist/bundle-setup.d.ts

@@ -1,13 +1,23 @@
+/** Better Dash is installed by the current profile's native Plugin Manager. */
 import type { Context } from '@deepseek-ai/cordis';
-import type { ProfileContext } from '@deepseek-ai/dsh-app-boot';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { BetterDashCompanion } from './companions.js';
+import type { BetterDashStatus } from './companion-contract.js';
+export { BetterDashCompanion } from './companions.js';
+export type { BetterDashStatus } from './companion-contract.js';
 export declare const name = "superd-bundle-setup";
 export declare const inject: string[];
-interface DeliveryResult {
-    installed: string[];
-    restartRequired: boolean;
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        superdCompanions: SuperdCompanions;
+    }
+}
+export declare class SuperdCompanions extends TypertRemoteService {
+    private readonly companion;
+    constructor(ctx: Context, companion: BetterDashCompanion);
+    getBetterDash(): Promise<BetterDashStatus>;
+    installBetterDash(): Promise<BetterDashStatus>;
 }
-/** First registration enables a companion; native reconciliation preserves retained disablement. */
-export declare function reconcileRegistryCompanions(profile: ProfileContext, signal?: AbortSignal): Promise<DeliveryResult>;
 export declare function apply(ctx: Context): void;
 declare const _default: {
     name: string;

package/superd-hub/dist/bundle-setup.js

@@ -1,158 +1,94 @@
-/** Register pack companions through the installed harness's native package operations. */
-import { createHash } from 'node:crypto';
-import { spawn } from 'node:child_process';
-import { readFile, mkdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { withFileLock, writeFileAtomic } from '@deepseek-ai/dsh-atomic-write';
-import * as AppBoot from '@deepseek-ai/dsh-app-boot';
-export const name = 'superd-bundle-setup';
-export const inject = ['profileContext', 'appReady'];
-const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
-// Refresh-capable hosts retain loaded package provenance: promoting the
-// companion from its containing pack to a direct dependency needs a restart.
-// Older hosts without this API keep their first-registration behavior.
-const nativePackages = AppBoot.PluginPackages?.prototype;
-const restartForPromotion = nativePackages !== undefined && typeof Reflect.get(nativePackages, 'refresh') === 'function';
-const json = async (path) => JSON.parse(await readFile(path, 'utf8'));
-async function optionalJson(path) {
-    try {
-        return await json(path);
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
     }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-}
-/** A child process avoids inheriting a running HMR transaction's AsyncLocalStorage. */
-async function installNative(profile, expected, signal) {
-    signal?.throwIfAborted();
-    const childScript = fileURLToPath(new URL('../scripts/register-companion.mjs', import.meta.url));
-    return new Promise((done, fail) => {
-        const child = spawn(process.execPath, [childScript], { stdio: ['pipe', 'pipe', 'pipe'], cwd: profile.dir });
-        let output = '', diagnostic = '';
-        const abort = () => { child.kill('SIGTERM'); };
-        const timeout = setTimeout(abort, 360_000);
-        signal?.addEventListener('abort', abort, { once: true });
-        child.stdout.setEncoding('utf8').on('data', chunk => { output = (output + chunk).slice(-32768); });
-        child.stderr.setEncoding('utf8').on('data', chunk => { diagnostic = (diagnostic + chunk).slice(-4096); });
-        child.on('error', fail);
-        child.on('close', code => {
-            clearTimeout(timeout);
-            signal?.removeEventListener('abort', abort);
-            if (signal?.aborted) {
-                fail(signal.reason);
-                return;
-            }
-            if (code !== 0) {
-                fail(new Error(`Native companion registration failed (${code}): ${diagnostic.trim() || output.trim()}`));
-                return;
-            }
-            try {
-                const result = JSON.parse(output);
-                if (result.exitCode !== 0)
-                    fail(new Error(`Native companion registration failed (${result.exitCode}); diagnostics: ${result.logPath ?? 'unavailable'}`));
-                else if (!['installed', 'owner-changed', 'companion-changed', 'companion-removed'].includes(result.disposition))
-                    fail(new Error('Native companion registration returned an invalid disposition'));
-                else
-                    done(result.disposition);
-            }
-            catch (error) {
-                fail(error);
-            }
-        });
-        child.stdin.on('error', () => { });
-        child.stdin.end(JSON.stringify({ profile, expected }));
-    });
-}
-/** First registration enables a companion; native reconciliation preserves retained disablement. */
-export async function reconcileRegistryCompanions(profile, signal) {
-    const directory = join(profile.home, 'companion-registration');
-    await mkdir(directory, { recursive: true, mode: 0o700 });
-    const key = hash(profile.dir);
-    return withFileLock(join(directory, key + '.delivery'), async () => {
-        signal?.throwIfAborted();
-        const receiptPath = join(directory, key + '.json');
-        const receipts = await optionalJson(receiptPath) ?? {};
-        const manifest = await json(join(profile.dir, 'package.json'));
-        const result = { installed: [], restartRequired: false };
-        for (const owner of Object.keys(manifest.dependencies ?? {})) {
-            const ownerDir = join(profile.dir, 'node_modules', owner);
-            const ownerManifest = await optionalJson(join(ownerDir, 'package.json'));
-            if (owner !== 'super-dsh' || ownerManifest?.name !== owner)
-                continue;
-            const version = ownerManifest.dependencies?.['better-dsh'];
-            if (version === undefined || version !== ownerManifest.version)
-                throw new Error('Super Dash requires its synchronized exact Better registry dependency');
-            const item = { name: 'better-dsh', version };
-            const current = await json(join(profile.dir, 'package.json'));
-            const ownerSpec = current.dependencies?.[owner];
-            if (ownerSpec === undefined)
-                continue;
-            const priorSpec = current.dependencies?.[item.name];
-            const receiptKey = `${owner}:${item.name}`;
-            if (priorSpec === undefined && receipts[receiptKey] === version)
-                continue; // same-version explicit removal
-            const installed = await optionalJson(join(profile.dir, 'node_modules', item.name, 'package.json'));
-            if (priorSpec === version && installed?.name === item.name && installed.version === version) {
-                receipts[receiptKey] = version;
-                await writeFileAtomic(receiptPath, JSON.stringify(receipts) + '\n', { mode: 0o600 });
-                continue;
-            }
-            signal?.throwIfAborted();
-            const disposition = await installNative(profile, { owner, ownerSpec, companion: item, ...priorSpec === undefined ? {} : { priorSpec } }, signal);
-            if (disposition === 'owner-changed' || disposition === 'companion-changed')
-                continue;
-            receipts[receiptKey] = version;
-            await writeFileAtomic(receiptPath, JSON.stringify(receipts) + '\n', { mode: 0o600 });
-            if (disposition === 'companion-removed')
-                continue;
-            result.installed.push(`${item.name}@${item.version}`);
-            result.restartRequired ||= priorSpec !== undefined || restartForPromotion;
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
         }
-        return result;
-    }, { waitMs: 120000 });
-}
-export function apply(ctx) {
-    const signal = new AbortController();
-    let started = false, running = false, again = false;
-    const reconcile = async () => {
-        if (!started || signal.signal.aborted)
-            return;
-        if (running) {
-            again = true;
-            return;
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
         }
-        running = true;
-        try {
-            const result = await reconcileRegistryCompanions(ctx.profileContext, signal.signal);
-            if (result.installed.length) {
-                ctx.logger.info(`Registered ${result.installed.join(', ')} from its installed exact registry dependency${result.restartRequired ? '; restart DSH to use the updated code' : ''}`);
-                ctx.emit('plugin-manager/changed', { reason: 'install' });
-            }
-        }
-        catch (error) {
-            if (!signal.signal.aborted)
-                ctx.logger.error('Offline registry companion registration failed; retry the Super installation before re-enabling the bundle', error);
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { BetterDashCompanion } from './companions.js';
+import { PACK_VERSION } from './pack-version.js';
+export { BetterDashCompanion } from './companions.js';
+export const name = 'superd-bundle-setup';
+export const inject = ['profileContext', 'appReady'];
+let SuperdCompanions = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _getBetterDash_decorators;
+    let _installBetterDash_decorators;
+    return class SuperdCompanions extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _getBetterDash_decorators = [Remote];
+            _installBetterDash_decorators = [Remote];
+            __esDecorate(this, null, _getBetterDash_decorators, { kind: "method", name: "getBetterDash", static: false, private: false, access: { has: obj => "getBetterDash" in obj, get: obj => obj.getBetterDash }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _installBetterDash_decorators, { kind: "method", name: "installBetterDash", static: false, private: false, access: { has: obj => "installBetterDash" in obj, get: obj => obj.installBetterDash }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        finally {
-            running = false;
-            if (again && !signal.signal.aborted) {
-                again = false;
-                void reconcile();
-            }
+        companion = __runInitializers(this, _instanceExtraInitializers);
+        constructor(ctx, companion) {
+            super(ctx, 'superdCompanions');
+            this.companion = companion;
         }
+        getBetterDash() { return this.companion.getBetterDash(); }
+        installBetterDash() { return this.companion.installBetterDash(); }
     };
+})();
+export { SuperdCompanions };
+export function apply(ctx) {
+    const companion = new BetterDashCompanion(ctx.profileContext, PACK_VERSION, () => ctx.get('pluginManager'));
+    new SuperdCompanions(ctx, companion);
     ctx.effect(() => {
-        const offReady = ctx.appReady.onReady(() => { started = true; void reconcile(); });
-        const offChange = ctx.on('plugin-manager/changed', () => { void reconcile(); });
-        return () => {
-            offReady();
-            offChange();
-            signal.abort();
-            // Never await a child here: manager HMR may be holding the profile lock it needs.
+        let ready = false, registering = true;
+        const start = () => {
+            void companion.ensureAutomatic().then(status => {
+                if (status.error !== undefined)
+                    ctx.logger.warn(status.error);
+            }).catch(error => ctx.logger.warn('Better Dash companion status failed', error));
         };
-    }, 'bundle-delivery: native registration');
+        const offReady = ctx.appReady.onReady(() => {
+            ready = true;
+            // Cold readiness occurs after boot, outside HMR. A live mount gets an
+            // immediate callback while its parent HMR transaction is still active:
+            // wait for the native changed notification below instead.
+            if (!registering)
+                start();
+        });
+        registering = false;
+        const offChange = ctx.on('plugin-manager/changed', () => {
+            // Native configure/HMR has finished here, but the parent's profile lock
+            // is still held. Return immediately; child install queues that lock.
+            if (ready)
+                start();
+        });
+        return () => { offReady(); offChange(); companion.dispose(); };
+    }, 'bundle-delivery: native companions');
 }
 export default { name, inject, apply };

package/superd-hub/dist/client/companion-api.d.ts

@@ -0,0 +1,5 @@
+/** Local ctx0 companion management, independent of the selected agent world. */
+import { type FetchLike } from './runtime-settings-api.js';
+import type { BetterDashStatus } from '../companion-contract.js';
+export type CompanionOperation = 'getBetterDash' | 'installBetterDash';
+export declare function callCompanion(operation: CompanionOperation, doFetch?: FetchLike): Promise<BetterDashStatus>;

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

@@ -0,0 +1,30 @@
+/** 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

@@ -0,0 +1,9 @@
+/** 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

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

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

@@ -0,0 +1,30 @@
+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 {};