Skip to content

feat(desktop): integrate Server discovery and operation compatibility #2101

Open

Description

@knqiufan

Goal

Connect Desktop to existing and locally provisioned Servers through the public discovery contract, enable only compatible qualified operations, and keep deployment/Principal changes isolated from private results and submitted writes.

Parent: #2099. First-wave delivery: #2099. Work item: F1-01.

PR breakdown

  • PR 01-A — Integrate existing Server discovery. Add the reviewed get_server_info operation, generated models, native adapter, and explicit compatibility results. Handle supported versions, missing handshake, authorization denial, unavailable service, and unknown required contracts. Preserve transport constraints and explicit qualified legacy-profile selection.

  • PR 01-B — Apply identity isolation and qualify operations. Integrate deployment identity with existing Principal/context checks. Invalidate stale selections, cursors, and responses when identity changes; keep submitted writes bound to their original targets. Record independently verified product qualifications for the delivered operation set and reuse applicable feat(desktop): add macOS native preview support #2056 evidence without rewriting historical records.

Dependencies and coordination

Acceptance criteria

  • Validate the actual endpoint and deployment/Principal after setup or repair; stale pre-repair identities cannot be reused. Personal loopback/no-token behavior follows RFC docs(rfc): define usability and agent workflows #1733 with reviewed profile qualification; remote authorization rules remain intact.

  • Explicit setup consent may include the initial connection activation, with its effect disclosed. Normal application reopen/refresh never silently restores a private session or invokes model readiness.

  • Supported discovery, handshake absence, 401/403/503, unknown product/required major, and missing optional features produce distinct actionable results. Successful health probes do not establish compatibility.

  • Observation denial does not disable independently authorized Memory/statistics when compatibility can still be established through an explicitly supported policy. There is no anonymous downgrade or unverified fallback.

  • Deployment or Principal changes invalidate private context and late responses; submitted writes are never silently retargeted or replayed.

  • Incidental page refreshes and ordinary Memory actions do not silently trigger model/dependency readiness probes. Preserve identity/authorization checks; identify any public-contract gap before exposing the promised behavior.

  • Normal product builds have matching qualification evidence for their supported operations; CI-fixture qualification remains separate. Exercise relevant real-Server flows and record Desktop/Server/contract identities.

  • Existing transport, credential, TLS, endpoint allowlist, cancellation, and uncertain-write protections remain intact.

Delivery priority

Windows 11 x64 and macOS Apple Silicon/Intel are required for #2099. Linux #2110 and #2111 are optional, owner-driven work under #1428; missing Linux implementation, packaging, or qualification does not block this issue's first-wave acceptance or the Windows/macOS release. Any advertised Linux support requires its own actual qualification.

Non-goals

Do not redesign the Server handshake, add Desktop-private APIs, infer compatibility with every future Server, or introduce automatic connection/Scope restoration.

References and delivery rules

Activity

  1. added
    desktopDesktop application, native platform integration, and packaging
    on Oct 20, 2026
  2. jackie-cqz commented on Oct 20, 2026

    @jackie-cqz
    Contributor

    Hi maintainers, I'd like to take #2101 and coordinate it with #2103 as one connection-to-Scope workflow. Please assign this issue to me if that fits the current ownership plan.

    I reviewed the current Desktop connection manager and the public discovery contract. My plan is to:

    I'll follow the proposed 01-A/01-B split and keep #2103's UI work independently reviewable. Validation will distinguish focused regression tests, actual Server execution, and installed-platform qualification.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

desktopDesktop application, native platform integration, and packaging

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions