ds-harness-remote 0.3.8

package/dist/control-runtime.js

@@ -0,0 +1,265 @@
+import { hostname } from 'node:os';
+import { resolveConfig } from './config.js';
+import { ClientModeError, } from './client-runtime.js';
+import { IdentityStore, serverStorageDirectory } from './identity-store.js';
+import { ClientServerApi, HostServerApi } from './server-api.js';
+import { ServerCredentialStore } from './server-credentials.js';
+/** Loopback-only control plane shared by Local/Remote switching and plugin setup. */
+export class PluginControlRuntime {
+    config;
+    identityDirectory;
+    settings;
+    client;
+    host;
+    constructor(config, identityDirectory, settings, client, host) {
+        this.config = config;
+        this.identityDirectory = identityDirectory;
+        this.settings = settings;
+        this.client = client;
+        this.host = host;
+    }
+    register(connection) {
+        return connection.rpc.handle('/remote', (endpoint, payload, signal) => this.handle(endpoint, payload, signal), {
+            authority: 'loopback',
+        });
+    }
+    async handle(endpoint, payload, signal) {
+        try {
+            if (endpoint === 'settings.get')
+                return ok(await this.settingsView());
+            if (endpoint === 'settings.configure')
+                return ok(await this.configure(payload));
+            if (endpoint === 'settings.server.set')
+                return ok(await this.setServer(payload));
+            if (endpoint === 'settings.role.set')
+                return ok(await this.setRole(payload));
+            if (endpoint === 'settings.logout')
+                return ok(await this.logout());
+            if (endpoint === 'host.reconnect') {
+                if (this.host === undefined)
+                    throw new ClientModeError('METHOD_NOT_ALLOWED', 'This plugin is not running as a Host.');
+                this.host.reconnectHost();
+                return ok(this.hostOnlyStatus());
+            }
+            if (this.client !== undefined)
+                return this.client.handleControl(endpoint, payload, signal);
+            if (endpoint === 'status')
+                return ok(this.hostOnlyStatus());
+            if (endpoint === 'devices')
+                return ok([]);
+            if (endpoint === 'host.account.login') {
+                if (this.host === undefined)
+                    throw new ClientModeError('METHOD_NOT_ALLOWED', 'This plugin is not running as a Host.');
+                const value = record(payload);
+                if (typeof value.email !== 'string' || typeof value.password !== 'string') {
+                    throw new ClientModeError('INVALID_MESSAGE', 'Email and password are required.');
+                }
+                return ok(await this.host.authorizeHostWithAccount(value.email, value.password));
+            }
+            if (endpoint === 'host.registration-code.submit') {
+                if (this.host === undefined)
+                    throw new ClientModeError('METHOD_NOT_ALLOWED', 'This plugin is not running as a Host.');
+                const value = record(payload);
+                if (typeof value.code !== 'string' || value.code.trim() === '') {
+                    throw new ClientModeError('INVALID_MESSAGE', 'A Host registration code is required.');
+                }
+                return ok(await this.host.authorizeHostWithCode(value.code));
+            }
+            if (endpoint === 'mode.set' && record(payload).mode === 'local')
+                return ok(this.hostOnlyStatus());
+            throw new ClientModeError('METHOD_NOT_ALLOWED', 'Remote Client mode is disabled by the plugin role.');
+        }
+        catch (error) {
+            return fail(error);
+        }
+    }
+    async configure(payload) {
+        if (this.settings === undefined) {
+            throw new ClientModeError('SETTINGS_UNAVAILABLE', 'DSH user settings are unavailable in this profile.');
+        }
+        const value = record(payload);
+        if (value.role !== 'host' && value.role !== 'client') {
+            throw new ClientModeError('INVALID_MESSAGE', 'Role must be Host or Client.');
+        }
+        if (typeof value.serverUrl !== 'string') {
+            throw new ClientModeError('INVALID_MESSAGE', 'Server URL is required.');
+        }
+        const current = editableConfig(resolveConfig(this.settings.get()));
+        const next = resolveConfig({ ...current, role: value.role, serverUrl: value.serverUrl });
+        const identities = new IdentityStore({
+            directory: serverStorageDirectory(this.identityDirectory, next.serverUrl, value.role),
+        });
+        const identity = await identities.loadOrCreate(hostname());
+        const api = value.role === 'host'
+            ? new HostServerApi(next.serverUrl, new ServerCredentialStore(identities.directory))
+            : new ClientServerApi(next.serverUrl, new ServerCredentialStore(identities.directory));
+        let authorization;
+        if (value.role === 'host' && typeof value.registrationCode === 'string' && value.registrationCode.trim() !== '') {
+            authorization = await api.authorizeHostWithCode(identity, value.registrationCode);
+        }
+        else {
+            if (typeof value.email !== 'string' || typeof value.password !== 'string') {
+                throw new ClientModeError('INVALID_MESSAGE', 'Email and password are required for account authorization.');
+            }
+            authorization = await api.authorizeWithAccount(identity, value.email, value.password);
+        }
+        await this.settings.replace(editableConfig(next));
+        return {
+            status: 'authorized',
+            role: value.role,
+            ...(authorization.account === undefined ? {} : { account: authorization.account }),
+            settings: await this.settingsView(),
+        };
+    }
+    async setServer(payload) {
+        if (this.settings === undefined) {
+            throw new ClientModeError('SETTINGS_UNAVAILABLE', 'DSH user settings are unavailable in this profile.');
+        }
+        const value = record(payload);
+        if (typeof value.serverUrl !== 'string') {
+            throw new ClientModeError('INVALID_MESSAGE', 'Server URL is required.');
+        }
+        const current = editableConfig(resolveConfig(this.settings.get()));
+        const next = resolveConfig({ ...current, serverUrl: value.serverUrl });
+        await this.settings.replace(editableConfig(next));
+        return this.settingsView();
+    }
+    async setRole(payload) {
+        if (this.settings === undefined) {
+            throw new ClientModeError('SETTINGS_UNAVAILABLE', 'DSH user settings are unavailable in this profile.');
+        }
+        const role = record(payload).role;
+        if (role !== 'host' && role !== 'client') {
+            throw new ClientModeError('INVALID_MESSAGE', 'Role must be Host or Client.');
+        }
+        const current = editableConfig(resolveConfig(this.settings.get()));
+        const currentRole = current.role === 'client' ? 'client' : 'host';
+        if (role !== currentRole && current.serverUrl !== undefined
+            && await this.association(current.serverUrl, role) === undefined) {
+            await this.authorizeOwnedRole(current.serverUrl, currentRole, role);
+        }
+        await this.settings.replace({ ...current, role });
+        return this.settingsView();
+    }
+    async authorizeOwnedRole(serverUrl, sourceRole, targetRole) {
+        const sourceDirectory = serverStorageDirectory(this.identityDirectory, serverUrl, sourceRole);
+        const sourceIdentity = await new IdentityStore({ directory: sourceDirectory }).loadOrCreate(hostname());
+        const sourceStore = new ServerCredentialStore(sourceDirectory);
+        if (await sourceStore.load(serverUrl, sourceIdentity.deviceId) === undefined)
+            return;
+        const sourceApi = sourceRole === 'host'
+            ? new HostServerApi(serverUrl, sourceStore)
+            : new ClientServerApi(serverUrl, sourceStore);
+        const sourceCredentials = await sourceApi.authenticate(sourceIdentity);
+        const targetDirectory = serverStorageDirectory(this.identityDirectory, serverUrl, targetRole);
+        const targetIdentity = await new IdentityStore({ directory: targetDirectory }).loadOrCreate(hostname());
+        const targetApi = targetRole === 'host'
+            ? new HostServerApi(serverUrl, new ServerCredentialStore(targetDirectory))
+            : new ClientServerApi(serverUrl, new ServerCredentialStore(targetDirectory));
+        await targetApi.authorizeOwnedRole(targetIdentity, sourceCredentials.accessToken, sourceCredentials.account);
+    }
+    async logout() {
+        if (this.settings === undefined) {
+            throw new ClientModeError('SETTINGS_UNAVAILABLE', 'DSH user settings are unavailable in this profile.');
+        }
+        const config = resolveConfig(this.settings.get());
+        if (config.serverUrl !== undefined) {
+            await Promise.all([
+                this.client?.clearClientAuthorization(),
+                this.host?.clearHostAuthorization(),
+            ]);
+            await Promise.all(['host', 'client'].map(async (role) => {
+                const directory = serverStorageDirectory(this.identityDirectory, config.serverUrl, role);
+                await new ServerCredentialStore(directory).clear();
+            }));
+        }
+        return this.settingsView();
+    }
+    async settingsView() {
+        const config = this.settings === undefined ? editableConfig(this.config) : editableConfig(resolveConfig(this.settings.get()));
+        const associations = await this.associations(config);
+        const role = config.role === 'client' ? 'client' : 'host';
+        const association = associations[role];
+        return {
+            config,
+            deviceName: hostname(),
+            writable: this.settings !== undefined,
+            applies: 'restart',
+            associations,
+            ...(association === undefined ? {} : { association }),
+        };
+    }
+    async associations(config) {
+        if (config.serverUrl === undefined)
+            return {};
+        const [host, client] = await Promise.all([
+            this.association(config.serverUrl, 'host'),
+            this.association(config.serverUrl, 'client'),
+        ]);
+        return {
+            ...(host === undefined ? {} : { host }),
+            ...(client === undefined ? {} : { client }),
+        };
+    }
+    async association(serverUrl, role) {
+        const identities = new IdentityStore({
+            directory: serverStorageDirectory(this.identityDirectory, serverUrl, role),
+        });
+        const identity = await identities.loadOrCreate(hostname());
+        const credentials = await new ServerCredentialStore(identities.directory).load(serverUrl, identity.deviceId);
+        if (credentials === undefined)
+            return undefined;
+        return {
+            method: credentials.authorizationMethod,
+            ...(credentials.account === undefined ? {} : { account: credentials.account }),
+        };
+    }
+    hostOnlyStatus() {
+        return {
+            mode: 'local',
+            available: false,
+            hostAuthorizationAvailable: this.host !== undefined,
+            ...(this.host === undefined ? {} : { host: this.host.hostStatus() }),
+        };
+    }
+}
+function editableConfig(config) {
+    return {
+        enabled: config.enabled,
+        role: config.role,
+        ...(config.serverUrl === undefined ? {} : { serverUrl: config.serverUrl }),
+        forceRelay: config.forceRelay,
+        logLevel: config.logLevel,
+        reconnect: config.reconnect.enabled
+            ? {
+                initialDelayMs: config.reconnect.initialDelayMs,
+                maxDelayMs: config.reconnect.maxDelayMs,
+                jitter: config.reconnect.jitter,
+            }
+            : false,
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function record(value) {
+    if (!isRecord(value))
+        throw new ClientModeError('INVALID_MESSAGE', 'The control request payload is invalid.');
+    return value;
+}
+function ok(value) { return { ok: true, value }; }
+function fail(error) {
+    const source = error instanceof Error ? error : undefined;
+    const remoteCode = source !== undefined && 'code' in source && typeof source.code === 'string'
+        ? source.code
+        : source instanceof ClientModeError ? source.code : undefined;
+    return {
+        ok: false,
+        error: {
+            code: 'internal',
+            message: source?.message ?? 'The plugin control operation failed.',
+            details: remoteCode === undefined ? {} : { remoteCode },
+        },
+    };
+}
+//# sourceMappingURL=control-runtime.js.map

package/dist/control-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-runtime.js","sourceRoot":"","sources":["../src/control-runtime.ts"],"names":[],"mappings":"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"}

package/dist/event-sequencer.d.ts

@@ -0,0 +1,23 @@
+import { type EventPayload, type RemoteEventName, type RemoteMessage } from '@dsh-remote/protocol';
+export interface ReplayResult {
+    events: RemoteMessage<EventPayload>[];
+    lastSeq: number;
+    hasMore: boolean;
+}
+export declare class FullResyncRequiredError extends Error {
+    readonly currentSeq: number;
+    readonly code = "FULL_RESYNC_REQUIRED";
+    constructor(currentSeq: number);
+}
+export declare class EventSequencer {
+    private readonly maxEvents;
+    private readonly maxAgeMs;
+    private seq;
+    private readonly events;
+    constructor(maxEvents?: number, maxAgeMs?: number);
+    currentSeq(): number;
+    publish<TData>(event: RemoteEventName, data: TData, sessionId?: string): RemoteMessage<EventPayload<TData>>;
+    replay(afterSeq: number, limit?: number): ReplayResult;
+    private trim;
+}
+//# sourceMappingURL=event-sequencer.d.ts.map

package/dist/event-sequencer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sequencer.d.ts","sourceRoot":"","sources":["../src/event-sequencer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE/G,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAEpC,QAAQ,CAAC,UAAU,EAAE,MAAM;IADvC,QAAQ,CAAC,IAAI,0BAAyB;gBACjB,UAAU,EAAE,MAAM;CAGxC;AAED,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAW,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAH1E,OAAO,CAAC,GAAG,CAAI;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAE9B,SAAS,SAAS,EAAmB,QAAQ,SAAc;IAKxF,UAAU,IAAI,MAAM;IAEpB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAU3G,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAQ,GAAG,YAAY;IAYrD,OAAO,CAAC,IAAI;CAIb"}

package/dist/event-sequencer.js

@@ -0,0 +1,54 @@
+import { createEvent } from '@dsh-remote/protocol';
+export class FullResyncRequiredError extends Error {
+    currentSeq;
+    code = 'FULL_RESYNC_REQUIRED';
+    constructor(currentSeq) {
+        super('The requested event replay window is no longer available.');
+        this.currentSeq = currentSeq;
+    }
+}
+export class EventSequencer {
+    maxEvents;
+    maxAgeMs;
+    seq = 0;
+    events = [];
+    constructor(maxEvents = 10_000, maxAgeMs = 15 * 60_000) {
+        this.maxEvents = maxEvents;
+        this.maxAgeMs = maxAgeMs;
+        if (!Number.isSafeInteger(maxEvents) || maxEvents < 1)
+            throw new TypeError('maxEvents must be a positive safe integer');
+        if (!Number.isSafeInteger(maxAgeMs) || maxAgeMs < 1)
+            throw new TypeError('maxAgeMs must be a positive safe integer');
+    }
+    currentSeq() { return this.seq; }
+    publish(event, data, sessionId) {
+        const message = createEvent(event, data, {
+            seq: ++this.seq,
+            ...(sessionId === undefined ? {} : { sessionId }),
+        });
+        this.events.push(message);
+        this.trim(message.timestamp);
+        return message;
+    }
+    replay(afterSeq, limit = 1_000) {
+        if (!Number.isSafeInteger(afterSeq) || afterSeq < 0)
+            throw new TypeError('afterSeq must be a non-negative safe integer');
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1_000)
+            throw new TypeError('limit must be between 1 and 1000');
+        this.trim(Date.now());
+        if (afterSeq >= this.seq)
+            return { events: [], lastSeq: this.seq, hasMore: false };
+        const firstSeq = this.events[0]?.payload.seq;
+        if (firstSeq === undefined || firstSeq > afterSeq + 1)
+            throw new FullResyncRequiredError(this.seq);
+        const events = this.events.filter(event => event.payload.seq > afterSeq).slice(0, limit);
+        const lastReturned = events.at(-1)?.payload.seq ?? afterSeq;
+        return { events, lastSeq: this.seq, hasMore: lastReturned < this.seq };
+    }
+    trim(now) {
+        const oldest = now - this.maxAgeMs;
+        while (this.events.length > this.maxEvents || (this.events[0]?.timestamp ?? now) < oldest)
+            this.events.shift();
+    }
+}
+//# sourceMappingURL=event-sequencer.js.map

package/dist/event-sequencer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sequencer.js","sourceRoot":"","sources":["../src/event-sequencer.ts"],"names":[],"mappings":"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"}

package/dist/harness-api-bridge.d.ts

@@ -0,0 +1,55 @@
+import type { ApiProxy, RpcResponse } from '@deepseek-ai/dsh-host-apiproxy/api';
+import type { HarnessApiFrameData, HarnessApiStreamClosedData } from '@dsh-remote/protocol';
+import type { SafeLogger } from './logging.js';
+type PublishFrame = (event: 'harness.api.frame' | 'harness.api.stream.closed', data: HarnessApiFrameData | HarnessApiStreamClosedData) => Promise<void>;
+/**
+ * Harness API methods that are safe to expose to an authenticated remote UI.
+ * Settings, credentials, native open/picker calls, directory mutation, file
+ * contents, downloads, and attachment upload intentionally remain outside
+ * this bridge. Directory listing exposes metadata only for workspace picking.
+ */
+export declare const HARNESS_API_ALLOWLIST: readonly ["session.list", "session.search", "session.create", "session.history", "session.models", "session.selectModel", "session.rename", "session.fork", "session.prompt", "session.updateQueue", "session.cancel", "subagent.list", "subagent.history", "subagent.prompt", "subagent.interrupt", "host.describe", "host.listDirectory", "workspace.list", "workspace.create", "workspace.rename", "workspace.delete", "workspace.insertBefore", "workspace.insertSessionBefore", "workspace.archiveSession", "skill.list", "agentPreset.list", "agentPreset.select", "agentPreset.read", "goal.create", "goal.edit", "goal.pause", "goal.resume", "goal.complete", "goal.clear", "commands.execute", "llm.providers", "llm.models"];
+export type AllowedHarnessApiMethod = typeof HARNESS_API_ALLOWLIST[number];
+/**
+ * The official Typert gateway surface (`typertGateway` service from
+ * `dsh-api-gateway`) used to dispatch Harness command endpoints. The ApiProxy
+ * has no `commands` domain — commands live behind the Typert registry, which
+ * is exactly the path the official Web UI exercises via `/api/commands/*`.
+ */
+export interface TypertGatewayLike {
+    invoke(request: {
+        namespace: string;
+        method: string;
+        args: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+}
+export declare class HarnessApiBridge {
+    private readonly api;
+    private readonly publish;
+    private readonly maxStreams;
+    private readonly logger?;
+    private readonly methods;
+    private readonly streams;
+    private readonly respondable;
+    private readonly mux;
+    private readonly host;
+    private readonly answer;
+    constructor(api: ApiProxy, publish: PublishFrame, maxStreams?: number, logger?: SafeLogger | undefined, typertGateway?: TypertGatewayLike);
+    call(input: unknown): Promise<RpcResponse<unknown>>;
+    respond(input: unknown): Promise<unknown>;
+    openStream(input: unknown): {
+        opened: true;
+        streamId: string;
+    };
+    closeStream(input: unknown): {
+        closed: boolean;
+        streamId: string;
+    };
+    closeAll(reason?: HarnessApiStreamClosedData['reason']): Promise<void>;
+    private pump;
+    private trackRespondable;
+    private deleteRespondable;
+}
+export {};
+//# sourceMappingURL=harness-api-bridge.d.ts.map

package/dist/harness-api-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-api-bridge.d.ts","sourceRoot":"","sources":["../src/harness-api-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAKR,WAAW,EACZ,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAEV,mBAAmB,EAEnB,0BAA0B,EAE3B,MAAM,sBAAsB,CAAA;AAO7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAM9C,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,mBAAmB,GAAG,2BAA2B,EAAE,IAAI,EAAE,mBAAmB,GAAG,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAoCvJ;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,ysBAsCxB,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAA;AAoB1E;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,OAAO,EAAE;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,CAAC,EAAE,WAAW,CAAA;KACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrB;AAED,qBAAa,gBAAgB;IASzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAX1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAGzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,YAAY,EACrB,UAAU,SAAI,EACd,MAAM,CAAC,EAAE,UAAU,YAAA,EACpC,aAAa,CAAC,EAAE,iBAAiB;IAQ7B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IA6CnD,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/C,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAoB9D,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAgB5D,QAAQ,CAAC,MAAM,GAAE,0BAA0B,CAAC,QAAQ,CAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAYnF,IAAI;IA4BlB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,iBAAiB;CAK1B"}