@gmickel/gno 2.4.0 → 2.5.1

package/src/sdk/client.ts

@@ -1,13 +1,16 @@
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+
+import type { Config } from "../config/types";
 /**
  * GNO SDK client.
  *
  * @module src/sdk/client
  */
-
-import { mkdir } from "node:fs/promises";
-import { dirname } from "node:path";
-
-import type { Config } from "../config/types";
+import type {
+  CompiledContextPreviewInput,
+  CompiledContextCheckInput,
+} from "../core/compiled-context";
 import type { DownloadPolicy } from "../llm/policy";
 import type { EmbeddingPort, GenerationPort, RerankPort } from "../llm/types";
 import type { AskResult, SearchResults } from "../pipeline/types";
@@ -59,6 +62,15 @@ import type {
   SectionTargetV1,
 } from "./types";
 
+import {
+  previewCompiledContext,
+  checkCompiledContext,
+} from "../app/compiled-context";
+import {
+  compileContextFile,
+  checkContextFile,
+  refreshContextFile,
+} from "../app/compiled-context-files";
 import {
   decorateUriForIndex,
   DEFAULT_INDEX_NAME,
@@ -1255,6 +1267,61 @@ class GnoClientImpl implements GnoClient {
     }
   }
 
+  compiledContextPreview(
+    input: CompiledContextPreviewInput
+  ): ReturnType<typeof previewCompiledContext> {
+    this.assertOpen();
+    return previewCompiledContext(input, {
+      store: this.store,
+      config: this.config,
+      indexName: this.indexName,
+    });
+  }
+
+  compiledContextCheck(
+    input: CompiledContextCheckInput
+  ): ReturnType<typeof checkCompiledContext> {
+    this.assertOpen();
+    return checkCompiledContext(input, {
+      store: this.store,
+      config: this.config,
+      indexName: this.indexName,
+    });
+  }
+
+  compileContextFile(
+    input: Parameters<typeof compileContextFile>[0]
+  ): ReturnType<typeof compileContextFile> {
+    this.assertOpen();
+    return compileContextFile(input, {
+      store: this.store,
+      config: this.config,
+      indexName: this.indexName,
+    });
+  }
+
+  checkContextFile(
+    input: Parameters<typeof checkContextFile>[0]
+  ): ReturnType<typeof checkContextFile> {
+    this.assertOpen();
+    return checkContextFile(input, {
+      store: this.store,
+      config: this.config,
+      indexName: this.indexName,
+    });
+  }
+
+  refreshContextFile(
+    input: Parameters<typeof refreshContextFile>[0]
+  ): ReturnType<typeof refreshContextFile> {
+    this.assertOpen();
+    return refreshContextFile(
+      input,
+      { store: this.store, config: this.config, indexName: this.indexName },
+      (request) => this.context(request)
+    );
+  }
+
   async verifyContext(
     capsule: GnoContextResult
   ): Promise<GnoContextVerificationResult> {

package/src/sdk/index.ts

@@ -128,3 +128,10 @@ export type {
   RetrievalTracePurgeResult,
   RetrievalTraceSummary,
 } from "../core/retrieval-trace-management";
+
+export type {
+  CompiledContextPreviewInput,
+  CompiledContextCheckInput,
+  CompiledContextPreview,
+  CompiledContextCheck,
+} from "../core/compiled-context";

package/src/sdk/types.ts

@@ -1,9 +1,17 @@
+import type {
+  previewCompiledContext,
+  checkCompiledContext,
+} from "../app/compiled-context";
+import type {
+  compileContextFile,
+  checkContextFile,
+  refreshContextFile,
+} from "../app/compiled-context-files";
 /**
  * Public SDK types.
  *
  * @module src/sdk/types
  */
-
 import type {
   ContextCapsuleBuildInput,
   ContextRuntimeErrorCode,
@@ -18,6 +26,10 @@ import type {
   CollectionEgressPolicyState,
   EgressRelaxationConfirmation,
 } from "../core/collection-egress-policy-service";
+import type {
+  CompiledContextPreviewInput,
+  CompiledContextCheckInput,
+} from "../core/compiled-context";
 import type {
   ContextCapsuleErrorCode,
   ContextCapsuleV1,
@@ -328,6 +340,21 @@ export interface GnoClient {
   query(query: string, options?: GnoQueryOptions): Promise<SearchResults>;
   ask(query: string, options?: GnoAskOptions): Promise<AskResult>;
   context(input: GnoContextInput): Promise<GnoContextResult>;
+  compiledContextPreview(
+    input: CompiledContextPreviewInput
+  ): ReturnType<typeof previewCompiledContext>;
+  compiledContextCheck(
+    input: CompiledContextCheckInput
+  ): ReturnType<typeof checkCompiledContext>;
+  compileContextFile(
+    input: Parameters<typeof compileContextFile>[0]
+  ): ReturnType<typeof compileContextFile>;
+  checkContextFile(
+    input: Parameters<typeof checkContextFile>[0]
+  ): ReturnType<typeof checkContextFile>;
+  refreshContextFile(
+    input: Parameters<typeof refreshContextFile>[0]
+  ): ReturnType<typeof refreshContextFile>;
   verifyContext(
     capsule: ContextCapsuleV1
   ): Promise<GnoContextVerificationResult>;

package/src/serve/compiled-context.ts

@@ -0,0 +1,84 @@
+import type { ServerContext } from "./context";
+
+/** Read-only compiled context adapters; caller authority comes from the socket. */
+import {
+  previewCompiledContext,
+  checkCompiledContext,
+} from "../app/compiled-context";
+import {
+  compiledContextPreviewInputSchema,
+  compiledContextCheckInputSchema,
+} from "../core/compiled-context";
+import {
+  isLocalClientRequest,
+  type RequestPeerServer,
+} from "./request-locality";
+
+export async function handleCompiledContext(
+  context: ServerContext,
+  request: Request,
+  server: RequestPeerServer | undefined,
+  operation: "preview" | "check"
+): Promise<Response> {
+  try {
+    // Bound bytes before JSON parsing, even when Content-Length is absent.
+    const reader = request.body?.getReader();
+    if (!reader)
+      return Response.json(
+        { error: { code: "invalid_input", message: "JSON body required" } },
+        { status: 400 }
+      );
+    const chunks: Uint8Array[] = [];
+    let size = 0;
+    while (true) {
+      const part = await reader.read();
+      if (part.done) break;
+      size += part.value.byteLength;
+      if (size > 8 * 1024 * 1024 + 65536) {
+        await reader.cancel();
+        return Response.json(
+          {
+            error: {
+              code: "invalid_input",
+              message: "Compiled context request exceeds byte limit",
+            },
+          },
+          { status: 413 }
+        );
+      }
+      chunks.push(part.value);
+    }
+    const raw: unknown = JSON.parse(
+      await new Blob(chunks.map((chunk) => new Uint8Array(chunk))).text()
+    );
+    const input =
+      operation === "preview"
+        ? compiledContextPreviewInputSchema.parse(raw)
+        : compiledContextCheckInputSchema.parse(raw);
+    const local = isLocalClientRequest(request, server);
+    const deps = {
+      store: context.store,
+      config: context.config,
+      indexName: context.indexName,
+      destinationZone: local ? ("local_process" as const) : ("remote" as const),
+      caller: { authenticated: local, operationAuthorized: true },
+    };
+    const result =
+      operation === "preview"
+        ? await previewCompiledContext(input, deps)
+        : await checkCompiledContext(input, deps);
+    return Response.json(result);
+  } catch {
+    // Supplied Capsules may contain private metadata; errors never echo inputs.
+    return Response.json(
+      {
+        error: {
+          code: "compiled_context_unavailable",
+          message:
+            "Compiled context is invalid, stale, or unavailable for this caller",
+        },
+      },
+      { status: 400 }
+    );
+  }
+}

package/src/serve/public/app.tsx

@@ -47,6 +47,7 @@ const Collections = lazy(() => import("./pages/Collections"));
 const Connectors = lazy(() => import("./pages/Connectors"));
 const Ask = lazy(() => import("./pages/Ask"));
 const GraphView = lazy(() => import("./pages/GraphView"));
+const CompiledContext = lazy(() => import("./pages/CompiledContext"));
 const TraceHistory = lazy(() => import("./pages/TraceHistory"));
 
 type Route =
@@ -59,6 +60,7 @@ type Route =
   | "/collections"
   | "/graph"
   | "/connectors"
+  | "/context/compiled"
   | "/traces";
 type Navigate = (to: string | number) => void;
 
@@ -78,6 +80,7 @@ const routes: Record<Route, React.ComponentType<RoutePageProps>> = {
   "/ask": Ask,
   "/graph": GraphView,
   "/traces": TraceHistory,
+  "/context/compiled": CompiledContext,
 };
 
 interface AppContentProps {
@@ -196,6 +199,14 @@ function AppContent({
               Trace history
             </button>
             <span className="text-border/30">—</span>
+            <button
+              className="transition-colors duration-300 hover:text-primary"
+              onClick={() => navigate("/context/compiled")}
+              type="button"
+            >
+              Compiled context
+            </button>
+            <span className="text-border/30">—</span>
             <a
               className="transition-colors duration-300 hover:text-primary"
               href="https://github.com/gmickel/gno"