super-dsh 0.1.5 → 0.1.9

package/superd-hub/dist/wire-endpoints.js

@@ -0,0 +1,180 @@
+/**
+ * Session-plane wire vocabulary (mesh P3 Task 1).
+ *
+ * The hub CALLS the native session-plane RPCs through a GatewayFace
+ * (`CarrierGatewayFace.dispatchRpc` / `.openWireStream`, P2 machinery — local
+ * in-process or remote wire). These endpoint strings are exactly the ones the
+ * official browser UI reaches the Host through: the generated
+ * `ctx.remote.session` namespace emits `connection.rpc.call('/api', endpoint,
+ * { args }, signal)` with `endpoint = '<namespace>/<method>'`, and the native
+ * gateway dispatches that same string.
+ *
+ * Every constant below is extracted from the upstream checkout
+ * (`upstream/deepseek-harness` @ `dsh-v0.1.7-rc.1`, read-only). Each JSDoc
+ * block carries the primary anchor (the `@Remote` declaration on the Host
+ * controller) plus the payload-type anchor. Missing methods are `undefined`
+ * with a comment — names are NEVER invented here.
+ *
+ * Wire-arg convention (how a GatewayFace payload is built):
+ *   payload = { args: { <parameterWireName>: <value> } }
+ * The client gateway builds it at
+ * `packages/api/gateway/src/client/index.ts:445` (`{ args: prepared.args }`,
+ * with `args[parameter.wire] = value` at :525); the Host gateway unpacks it at
+ * `packages/api/gateway/src/index.ts:692–704` (`assertExactArguments` +
+ * `resolveParameter` per declared parameter). For every session-plane method
+ * the single business parameter is named `request` — EXCEPT `session/list`,
+ * whose parameter is declared `_request` (the controller ignores it), so its
+ * args key is `_request`. The trailing `signal` parameter never travels in
+ * `args` (it is carried by the envelope/stream carrier, not the payload).
+ *
+ * Namespace binding: `super(ctx, 'sessionController', { namespace: 'session' })`
+ * — packages/api/session-controller/src/index.ts:136 (Cordis service key
+ * `sessionController`, wire namespace `session`).
+ */
+/**
+ * `session/list` — cold Session list (the sidebar's session rows).
+ *
+ * Upstream anchors:
+ * - `@Remote('list')`: packages/api/session-controller/src/index.ts:251
+ *   (method `list(_request: SessionListRequest, signal)` at :252)
+ * - payload type: packages/api/session-controller/src/types.ts:262
+ *   (`SessionListRequest`), value at :267 (`SessionListValue`)
+ * - generated client string: packages/api/session-controller/lib/typert.remote-client.d.ts:47
+ * - wire-arg key quirk: `_request` (declared name, ignored by the Host) —
+ *   typert.remote-client.js `session/list` descriptor, parameter wire `_request`
+ *
+ * Wire payload: `{ args: { _request: SessionListRequestMirror } }`.
+ */
+export const WIRE_SESSION_LIST = 'session/list';
+/**
+ * `session/create` — create a Session (or adopt an explicit id).
+ *
+ * Upstream anchors:
+ * - `@Remote('create')`: packages/api/session-controller/src/index.ts:272
+ *   (method `create(request: SessionCreateRequest)` at :273)
+ * - payload type: packages/api/session-controller/src/types.ts:283
+ *   (`SessionCreateRequest`), value at :291 (`SessionCreateValue`)
+ * - generated client string: .../typert.remote-client.d.ts:44
+ *
+ * Wire payload: `{ args: { request: SessionCreateRequestMirror } }`.
+ */
+export const WIRE_SESSION_CREATE = 'session/create';
+/**
+ * `session/rename` — set a Session's title (the dedicated title-set RPC).
+ *
+ * Upstream anchors:
+ * - `@Remote('rename')`: packages/api/session-controller/src/index.ts:384
+ *   (method `rename(request: SessionRenameRequest)` at :385)
+ * - payload type: packages/api/session-controller/src/types.ts:307
+ *   (`SessionRenameRequest`), value at :313 (`SessionRenameValue`)
+ * - generated client string: .../typert.remote-client.d.ts:53
+ * - invalid title → typed error `session/title-invalid`
+ *   (types.ts:223, thrown at commands.ts:204)
+ *
+ * Wire payload: `{ args: { request: SessionRenameRequestMirror } }`.
+ */
+export const WIRE_SESSION_TITLE = 'session/rename';
+/**
+ * `session/prompt` — submit one user turn into a Session.
+ *
+ * Upstream anchors:
+ * - `@Remote('prompt')`: packages/api/session-controller/src/index.ts:407
+ *   (method `prompt(request: SessionPromptRequest, signal)` at :408)
+ * - payload type: packages/api/session-controller/src/types.ts:331
+ *   (`SessionPromptRequest`), value at :342 (`SessionPromptValue`)
+ * - generated client string: .../typert.remote-client.d.ts:52
+ * - typed rejections: `session/agent-busy` / `session/attachment-invalid` /
+ *   `session/not-found` (commands.ts:366–398)
+ *
+ * Wire payload: `{ args: { request: SessionPromptRequestMirror } }`.
+ */
+export const WIRE_PROMPT_SUBMIT = 'session/prompt';
+/**
+ * `session/follow` — open the event/log stream the UI renders (logical stream).
+ *
+ * Upstream anchors:
+ * - `@Remote({ mode: 'stream' })`: packages/api/session-controller/src/index.ts:461
+ *   (method `follow(request: SessionFollowRequest, signal): AsyncIterable<SessionFollowFrame>` at :462)
+ * - payload type: packages/api/session-controller/src/types.ts:485
+ *   (`SessionFollowRequest`), frame union at :550 (`SessionFollowFrame`)
+ * - generated client string: .../typert.remote-client.d.ts:45
+ * - UI consumption: packages/api/session-controller/src/client/transport.ts:172
+ *   (`SessionEventStream.follow` → `remote.session.follow({ address, assistantStream: true, ... })`)
+ *
+ * Wire payload: `{ args: { request: SessionFollowRequestMirror } }`, opened
+ * via `openWireStream` (not `dispatchRpc`). The opening frame is
+ * `{ type: 'snapshot', header, cursor, records, hasMore, projections }`; then
+ * ordered `{ type: 'event', event }` entries.
+ */
+export const WIRE_STREAM_OPEN = 'session/follow';
+/**
+ * `session/cancel` — cancel/interrupt the active Agent turn.
+ *
+ * Upstream anchors:
+ * - `@Remote('cancel')`: packages/api/session-controller/src/index.ts:438
+ *   (method `cancel(request: SessionCancelRequest)` at :439)
+ * - payload type: packages/api/session-controller/src/types.ts:371
+ *   (`SessionCancelRequest`), value at :376 (`SessionCancelValue`)
+ * - generated client string: .../typert.remote-client.d.ts:41
+ *
+ * Wire payload: `{ args: { request: SessionCancelRequestMirror } }`.
+ */
+export const WIRE_TURN_CANCEL = 'session/cancel';
+/**
+ * `session/close` / session delete — DOES NOT EXIST upstream.
+ *
+ * The session namespace (packages/api/session-controller/src/index.ts:251–501,
+ * complete `@Remote` set: list, search, create, selectModel, modelCatalog,
+ * canOpenWorkspacePath, openWorkspacePath, workspacePathApplications, rename,
+ * fork, prompt, attachment, updateQueue, cancel, page, follow, projections,
+ * control) has no close/dispose/delete/archive method. Session lifetime is
+ * Host-owned (Agent lifecycle + `session/disposed` events); the browser never
+ * closes a session over the wire. The nearest upstream analogues live on a
+ * DIFFERENT namespace (workspace, not session-plane): `workspace/archiveSession`
+ * (packages/api/workspace-controller/src/index.ts:159) and
+ * `workspace/unarchiveSession` (:169). Kept `undefined` per the no-invention
+ * rule; Task 2 must not route a close through the session plane.
+ */
+export const WIRE_SESSION_CLOSE = undefined;
+/**
+ * The session-plane endpoint vocabulary (mesh P3 Task 1 deliverable).
+ * Undefined keys = no upstream counterpart (see the constant's JSDoc).
+ */
+export const WIRE = {
+    sessionList: WIRE_SESSION_LIST,
+    sessionCreate: WIRE_SESSION_CREATE,
+    sessionTitle: WIRE_SESSION_TITLE,
+    promptSubmit: WIRE_PROMPT_SUBMIT,
+    streamOpen: WIRE_STREAM_OPEN,
+    turnCancel: WIRE_TURN_CANCEL,
+    sessionClose: WIRE_SESSION_CLOSE,
+};
+/**
+ * Wire-arg wrapper keys per endpoint, as the native gateway's
+ * `assertExactArguments`/`resolveParameter` expects them
+ * (packages/api/gateway/src/index.ts:692–704; client builds
+ * `{ args: { [parameter.wire]: value } }` at api/gateway/src/client/index.ts:525).
+ * `session/list` alone uses `_request` (its controller parameter is declared
+ * `_request` and ignored).
+ */
+export const WIRE_ARGS = {
+    [WIRE_SESSION_LIST]: '_request',
+    [WIRE_SESSION_CREATE]: 'request',
+    [WIRE_SESSION_TITLE]: 'request',
+    [WIRE_PROMPT_SUBMIT]: 'request',
+    [WIRE_STREAM_OPEN]: 'request',
+    [WIRE_TURN_CANCEL]: 'request',
+};
+/**
+ * Build the GatewayFace payload (`{ args: { <key>: value } }`) for one
+ * session-plane endpoint.
+ * @param endpoint - one of the defined `WIRE` constants.
+ * @param value - the mirrored request object for that endpoint.
+ * @returns the wire payload accepted by `dispatchRpc`/`openWireStream`.
+ */
+export function wireArgsOf(endpoint, value) {
+    const key = WIRE_ARGS[endpoint];
+    if (key === undefined)
+        throw new Error(`wire-endpoints: no wire-arg key for ${endpoint}`);
+    return { args: { [key]: value } };
+}

package/superd-hub/dist/world-join.js

@@ -32,7 +32,7 @@
 import { mkdirSync } from 'node:fs';
 import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
-import { registerAgent, setReady } from './roster.js';
+import { registerAgent, setFailed, setReady } from './roster.js';
 import { registerForeignTarget } from './targets.js';
 import { spawnWorld } from './spawn-world.js';
 import { provisionWorldProfile, resolveInstallAnchor } from './world-provision.js';
@@ -92,9 +92,14 @@ export function apply(ctx, config) {
         }, `superd-join: ${key} mount`);
         return ctxW;
     })().catch((cause) => {
-        // A failed world degrades to a not-ready roster row; a rejected provided
-        // promise would fail the entire host boot (loader entry apply).
+        // A failed world degrades to a FAILED roster row (mount stays for
+        // diagnosis; ready stays false); a rejected provided promise would fail
+        // the entire host boot (loader entry apply).
         console.error(`[super-dsh] ${key} world failed:`, cause);
+        try {
+            setFailed(key, true);
+        }
+        catch { /* roster row already gone */ }
         return null;
     });
     ctx.provide(`superd.world.${key}`, world);

package/superd-hub/dist/world-mount.d.ts

@@ -79,4 +79,31 @@ export type WorldPatchLayer = {
  * @param key - runtime key (`omp`, `codex`, …) — the mount label.
  * @returns patch layers to append to the world's composition.
  */
+/**
+ * Wave-1 of world composition minimization (spec
+ * docs/specs/world-composition-minimization): native-agent machinery the
+ * foreign runtimes replace. Dependency-cleared 2026-09-27 against the KEEP
+ * set (api controllers, session core, adapters' agents/sessions/llm/
+ * agentDefaultModel/settings/agentPresets). Wave-2 candidates (client-ui
+ * family, tools, bash-sandbox, terminal-controller, …) live in the spec,
+ * NOT here.
+ */
+export declare const WORLD_WAVE1_DISABLED_ROWS: readonly string[];
+/**
+ * Wave-2 of world composition minimization: the CLIENT lane. The
+ * multi-ctx-multi-ui → native-ui-only transition (0.1.5 / T-D) retired the
+ * world's own web UI (webserver/hmr/web-runtime/client-hmr above); wave-2
+ * completes it by stripping the browser-half rows of the web-app bundle —
+ * every dsh-client-* row plus the cordis client runner. In a world these
+ * only registered modules into a table no browser ever reads.
+ *
+ * Dependency-cleared 2026-09-27: the KEEP side (api controllers, gateway,
+ * session core, adapters) injects none of their services with ONE
+ * exceptions — `connection` (dsh-client-connection: the world's typert
+ * gateway injects it) and `modules` (dsh-client-modules: its activation
+ * work fails in world trees ("client bundles not found") and at least one
+ * fiber treats it as required — the load-bearing parking restatement
+ * `inject: [webServer]` keeps it waiting forever, superseding a disable).
+ */
+export declare const WORLD_WAVE2_DISABLED_ROWS: readonly string[];
 export declare function worldMountPatches(key: string): readonly WorldPatchLayer[];

package/superd-hub/dist/world-mount.js

@@ -68,6 +68,63 @@ export function superdTrustedHosts(value) {
  * @param key - runtime key (`omp`, `codex`, …) — the mount label.
  * @returns patch layers to append to the world's composition.
  */
+/**
+ * Wave-1 of world composition minimization (spec
+ * docs/specs/world-composition-minimization): native-agent machinery the
+ * foreign runtimes replace. Dependency-cleared 2026-09-27 against the KEEP
+ * set (api controllers, session core, adapters' agents/sessions/llm/
+ * agentDefaultModel/settings/agentPresets). Wave-2 candidates (client-ui
+ * family, tools, bash-sandbox, terminal-controller, …) live in the spec,
+ * NOT here.
+ */
+export const WORLD_WAVE1_DISABLED_ROWS = [
+    'agent-loop',
+    'mcp-resources',
+    // skills
+    'skill', 'skill-filesystem', 'skill-badge', 'tool-skill', 'ui-skill',
+    // jobs
+    'jobs', 'tool-jobs', 'ui-jobs', 'job-controller',
+    // subagents
+    'subagent', 'subagent-spawn-in-process', 'subagent-fork-in-process',
+    'tool-subagent-control', 'tool-subagent-list-agents', 'tool-subagent',
+    'tool-subagent-fork', 'tool-subagent-codex', 'tool-subagent-claude-code',
+    'subagent-model-selection-settings', 'ui-subagent', 'ui-settings-subagent',
+    'ui-settings-agent-loop',
+];
+/**
+ * Wave-2 of world composition minimization: the CLIENT lane. The
+ * multi-ctx-multi-ui → native-ui-only transition (0.1.5 / T-D) retired the
+ * world's own web UI (webserver/hmr/web-runtime/client-hmr above); wave-2
+ * completes it by stripping the browser-half rows of the web-app bundle —
+ * every dsh-client-* row plus the cordis client runner. In a world these
+ * only registered modules into a table no browser ever reads.
+ *
+ * Dependency-cleared 2026-09-27: the KEEP side (api controllers, gateway,
+ * session core, adapters) injects none of their services with ONE
+ * exceptions — `connection` (dsh-client-connection: the world's typert
+ * gateway injects it) and `modules` (dsh-client-modules: its activation
+ * work fails in world trees ("client bundles not found") and at least one
+ * fiber treats it as required — the load-bearing parking restatement
+ * `inject: [webServer]` keeps it waiting forever, superseding a disable).
+ */
+export const WORLD_WAVE2_DISABLED_ROWS = [
+    'cordis-client-runner',
+    'directory-picker-browse-surface',
+    'file-upload',
+    'locale',
+    'resources',
+    'ui-agent-preset', 'ui-approval', 'ui-attachment', 'ui-brand-official',
+    'ui-chat', 'ui-commands', 'ui-conversation', 'ui-cordis', 'ui-deliverables',
+    'ui-goal', 'ui-input-trigger', 'ui-layout', 'ui-message-feedback',
+    'ui-model-selection', 'ui-open-in-app', 'ui-permission', 'ui-plan',
+    'ui-plugin-manager', 'ui-reference', 'ui-renderer', 'ui-session',
+    'ui-settings', 'ui-settings-account', 'ui-settings-general',
+    'ui-settings-models', 'ui-settings-plugin-inventory', 'ui-settings-plugins',
+    'ui-settings-shell', 'ui-settings-web-search', 'ui-sidebar',
+    'ui-sidebar-browser', 'ui-sidebar-documentpreview', 'ui-sidebar-files',
+    'ui-sidebar-right', 'ui-sidebar-terminal', 'ui-theme', 'ui-tool',
+    'ui-trajectory', 'ui-user-questions', 'ui-workflow-run', 'ui-workspace',
+];
 export function worldMountPatches(key) {
     if (typeof key !== 'string' || key === '' || key.includes('/')) {
         throw new Error(`world-mount: invalid key ${JSON.stringify(key)}`);
@@ -96,10 +153,20 @@ export function worldMountPatches(key) {
         // literals; the deploy-level trusted-host extras ride along).
         { id: 'web-runtime', disabled: true },
         { id: 'client-hmr', disabled: true },
+        // PARKED, not disabled: the modules row's activation work fails in world
+        // trees (no built client bundles) and the omp fiber treats it as
+        // required — waiting on the never-provided webServer keeps it inert
+        // without a startup failure (2026-09-27 wave-2 rig evidence).
         { id: 'modules', inject: ['webServer'] },
         { insert: [
                 { id: WORLD_MOUNT_ROW_ID, name: WORLD_MOUNT_PLUGIN, config: { key } },
                 { id: WORLD_HUB_ROW_ID, name: WORLD_HUB_PLUGIN },
             ] },
+        // Wave-1 minimization: the foreign runtimes replace the native agent
+        // machinery — these rows never mount in a world tree.
+        ...WORLD_WAVE1_DISABLED_ROWS.map((id) => ({ id, disabled: true })),
+        // Wave-2 minimization: the client lane (native-ui-only completion) —
+        // no browser ever reads a world's module table.
+        ...WORLD_WAVE2_DISABLED_ROWS.map((id) => ({ id, disabled: true })),
     ];
 }