Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

feat(sdk): expose curated gateway resource capabilities

Geschlossen
  • Stimmt etwas nicht?
#3,011 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
52/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
go, python, rust, typescript
Bereich
api, backend-api-design, documentation, testing

Rechercherichtung

Beginnen Sie mit der kuratierten Rust-SDK-Oberfläche und vergleichen Sie sie mit den Gateway-APIs der TypeScript-, Python- und Go-SDKs; der Rohzugriff ist über OpenShellClient::raw_grpc() und openshell_sdk::raw::proto verfügbar. Prüfen Sie, wie die protobuf-Bindings aus dem proto/-Baum durch openshell-core neu generiert werden. Als abgeschlossen gilt die Arbeit, wenn gleichwertige Fähigkeitsinformationen, Tests für befüllte und nicht vorhandene Felder sowie eine Dokumentation der statischen Semantik und des raw-protobuf-Fallbacks vorhanden sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

state:stale

User Story

As an OpenShell SDK user, I want a curated gateway-capabilities API so that I can determine which portable CPU, memory, and GPU requests a gateway’s compute drivers support without depending on generated protobuf types.

Problem Statement

Issue #2902 adds static resource capability fields to the compute-driver and gateway protobuf APIs. Rust callers can already access them through OpenShellClient::raw_grpc() and openshell_sdk::raw::proto, but the curated SDK surface has no typed gateway-info method or capability models.

Impact / Why This Matters

Consumers that need an idiomatic SDK API must currently use generated wire types and direct gRPC calls. That is workable but makes application code depend on protobuf details and produces inconsistent ergonomics across SDKs.

Proposed Design

Expose gateway information and per-driver resource capabilities through each curated SDK surface. Preserve absence when a driver does not report capabilities, and document that capability flags describe static implementation support rather than live inventory or available capacity.

Acceptance Criteria

  • The Rust SDK exposes a curated gateway-info method and types for CPU, memory, and GPU resource capabilities.
  • The TypeScript, Python, and Go SDKs expose equivalent capability information where they provide curated gateway APIs.
  • SDK tests cover populated capability fields and unreported capabilities.
  • SDK documentation explains the static semantics and raw-protobuf fallback.

Alternatives Considered

Keep the new fields available only through generated protobuf clients. This preserves wire-level access but leaves users to manage generated types directly and does not provide a consistent SDK-level experience.

Agent Investigation

The Rust SDK re-exports generated protobufs through openshell_sdk::raw::proto; protobuf bindings are regenerated from the full proto/ tree by openshell-core during Rust builds. This follow-up is therefore curated API work rather than a prerequisite for protocol access.

Related to #2902 and draft PR #3010.

Vorherrschende Sprache
Rust
Sterne
16.3k
Forks
1.8k
Ø Merge
2 T. 6 Std.
Gemergte PRs (30 T.)
397

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus NVIDIA/OpenShell

Alle Issues in NVIDIA/OpenShell

Ähnliche Issues

Weitere Issues zu Rust

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.