diff --git a/packages/plugin/src/client-capabilities.ts b/packages/plugin/src/client-capabilities.ts new file mode 100644 index 0000000..9c90150 --- /dev/null +++ b/packages/plugin/src/client-capabilities.ts @@ -0,0 +1,77 @@ +import { RemoteClientCore, remoteWorkspaceTypeAvailable } from '@dsh-remote/client-core' +import { MAX_REMOTE_CAPABILITY_ENTRIES, parseRemoteWorkspaceTypes } from '@dsh-remote/protocol' +import type { RemoteHostFeatures } from './client-runtime-contract.js' +import { ClientModeError, isRecord } from './client-runtime-contract.js' + +/** Empty profile before authenticated capability discovery. */ +export function remoteHostFeatures(clientVersion?: string): RemoteHostFeatures { + return { + commandList: false, + fileViewer: false, + terminal: false, + remoteGateway: false, + codex: false, + cursor: false, + antigravity: false, + opencode: false, + pluginRoute: false, + } +} + +export async function probeRemoteHostFeatures( + client: RemoteClientCore, + clientVersion?: string, +): Promise { + let value: unknown + try { + value = await client.rpc('harness.transport.describe', {}) + } catch (error) { + if (error instanceof Error && 'code' in error && error.code === 'METHOD_NOT_FOUND') { + throw new ClientModeError('FEATURE_NOT_SUPPORTED', 'This Host predates Typert Remote capability discovery. Upgrade the Host.') + } + throw error + } + if (!isRecord(value) || !Array.isArray(value.capabilities) + || value.capabilities.length > MAX_REMOTE_CAPABILITY_ENTRIES + || value.capabilities.some(capability => typeof capability !== 'string')) { + throw new ClientModeError('INVALID_MESSAGE', 'The remote Host returned invalid transport capabilities.') + } + const capabilities = new Set(value.capabilities as string[]) + const remoteV1 = capabilities.has('harness.remote.v1') + const remoteV3 = capabilities.has('harness.remote.v3') + const terminal = capabilities.has('harness.terminal.v1') + const workspaceTypes = 'workspaceTypes' in value ? parseRemoteWorkspaceTypes(value.workspaceTypes) : undefined + const available = (id: string, capability: string) => remoteWorkspaceTypeAvailable(value.capabilities as string[], workspaceTypes, id, capability) + const codex = available('codex', 'codex.appserver.v1') + const cursor = available('cursor', 'agent.acp.cursor.v1') + const antigravity = available('antigravity', 'agent.acp.antigravity.v1') + const pi = available('pi', 'agent.acp.pi.v1') + const claude = available('claude', 'agent.acp.claude.v1') + const opencode = available('opencode', 'agent.acp.opencode.v1') + const hermes = available('hermes', 'agent.acp.hermes.v1') + if (remoteV1 && remoteV3) { + throw new ClientModeError('INVALID_MESSAGE', 'The remote Host advertised conflicting Harness Session formats.') + } + const sessionFormat = remoteV3 ? 3 as const : undefined + const remoteGateway = remoteV3 || remoteV1 + if (!remoteGateway && !codex && !cursor && !antigravity && !pi && !opencode && !claude && !hermes) { + throw new ClientModeError('FEATURE_NOT_SUPPORTED', 'The remote Host exposes no supported Harness transport.') + } + return { + commandList: remoteGateway, + fileViewer: capabilities.has('fileviewer.read.v1'), + terminal, + remoteGateway, + ...(sessionFormat === undefined ? {} : { sessionFormat }), + codex, + cursor, + antigravity, + ...(pi ? { pi: true } : {}), + opencode, + claude, + ...(hermes ? { hermes: true } : {}), + ...(capabilities.has('agent.acp.antigravity.model-load.v1') ? { acpModelLoadsSession: true } : {}), + ...(workspaceTypes === undefined ? {} : { workspaceTypes }), + pluginRoute: capabilities.has('plugin.route.v1'), + } +}