package PBS references and expose paginated MCP reads

This commit is contained in:
2026-09-29 08:48:33 +01:00
parent 58f11a8123
commit feb57c5298
23 changed files with 738 additions and 21 deletions
@@ -12,4 +12,8 @@ public interface FrontendProvider {
default Optional<FrontendLanguageService> languageService() {
return Optional.empty();
}
default Optional<FrontendReferenceProvider> documentation() {
return Optional.empty();
}
}
@@ -0,0 +1,21 @@
package p.studio.compiler.services;
import p.studio.AppMode;
import java.util.List;
import java.util.Objects;
/** Owner-maintained, installed reference texts. This is not a filesystem or network reader. */
public interface FrontendReferenceProvider {
List<Reference> references(int stdlibVersion, AppMode target);
enum Kind { QUICKSTART, SYNTAX, SEMANTICS, EXAMPLE, SDK, LIBRARY }
record Reference(String id, String title, Kind kind, String version, String versionSource, String text) {
public Reference {
Objects.requireNonNull(id); Objects.requireNonNull(title); Objects.requireNonNull(kind);
Objects.requireNonNull(versionSource); Objects.requireNonNull(text);
if (id.isBlank() || title.isBlank() || versionSource.isBlank() || version != null && version.isBlank())
throw new IllegalArgumentException("Blank reference metadata");
}
}
}