@lucern/sdk 0.2.0-alpha.6 → 0.2.0-alpha.7

package/src/contextClient.ts

@@ -0,0 +1,130 @@
+import {
+  createGatewayRequestClient,
+  type GatewayClientConfig,
+} from "./coreClient";
+import type {
+  CompileContextInput,
+  PublicCompiledContext,
+} from "./contextTypes";
+import type { JsonObject } from "./types";
+
+/** Configuration for the context client. */
+export type ContextClientConfig = GatewayClientConfig;
+
+/** Alias for the compiled context payload returned by the gateway. */
+export type CompileContextResponse = PublicCompiledContext;
+
+/** Internal request shape for the context compile endpoint. */
+type ContextClientRequest = {
+  path: "/api/platform/v1/context/compile";
+  method: "POST";
+  body: Record<string, unknown>;
+};
+
+function cleanString(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim().length > 0
+    ? value.trim()
+    : undefined;
+}
+
+function cleanNumber(value: unknown): number | undefined {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+
+function cleanBoolean(value: unknown): boolean | undefined {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function buildCompileContextRequest(
+  topicId: string,
+  input: CompileContextInput = {}
+): ContextClientRequest {
+  const payload: Record<string, unknown> = { topicId };
+
+  const query = cleanString(input.query);
+  if (query) {
+    payload.query = query;
+  }
+
+  const budget = cleanNumber(input.budget) ?? cleanNumber(input.tokenBudget);
+  if (budget !== undefined) {
+    payload.budget = budget;
+  }
+
+  const ranking = cleanString(input.ranking) ?? cleanString(input.rankingProfile);
+  if (ranking) {
+    payload.ranking = ranking;
+  }
+
+  const limit = cleanNumber(input.limit);
+  if (limit !== undefined) {
+    payload.limit = limit;
+  }
+
+  const maxDepth = cleanNumber(input.maxDepth);
+  if (maxDepth !== undefined) {
+    payload.maxDepth = maxDepth;
+  }
+
+  const includeEntities = cleanBoolean(input.includeEntities);
+  if (includeEntities !== undefined) {
+    payload.includeEntities = includeEntities;
+  }
+
+  const mode = cleanString(input.mode);
+  if (mode) {
+    payload.mode = mode;
+  }
+
+  const includeFailures = cleanBoolean(input.includeFailures);
+  if (includeFailures !== undefined) {
+    payload.includeFailures = includeFailures;
+  }
+
+  const worktreeId = cleanString(input.worktreeId);
+  if (worktreeId) {
+    payload.worktreeId = worktreeId;
+  }
+
+  const sessionId = cleanString(input.sessionId);
+  if (sessionId) {
+    payload.sessionId = sessionId;
+  }
+
+  if (Array.isArray(input.packWeightOverrides) && input.packWeightOverrides.length > 0) {
+    payload.packWeightOverrides = input.packWeightOverrides;
+  }
+
+  return {
+    path: "/api/platform/v1/context/compile",
+    method: "POST",
+    body: payload,
+  };
+}
+
+/**
+ * Create the context client for compiling reasoning context packs.
+ * @param config - Gateway transport configuration.
+ * @returns An object with a `compile` method for building context packs.
+ */
+export function createContextClient(config: ContextClientConfig = {}) {
+  const gateway = createGatewayRequestClient(config);
+
+  return {
+    /**
+     * Compile a focused reasoning context pack for a topic scope.
+     * @param topicId - The topic to compile context for.
+     * @param input - Optional compile parameters (query, budget, ranking, etc.).
+     * @returns The compiled context payload with beliefs, questions, and evidence.
+     */
+    async compile(topicId: string, input: CompileContextInput = {}) {
+      const request = buildCompileContextRequest(topicId, input);
+      return gateway.request<CompileContextResponse>({
+        ...request,
+        body: request.body as JsonObject,
+      });
+    },
+  };
+}
+
+export type { CompileContextInput, PublicCompiledContext } from "./contextTypes";

package/{dist/lib/platform/sdk/contextFacade.d.ts → src/contextFacade.ts}

@@ -7,4 +7,9 @@
  *
  * Added: EK-16 T7.3.4 (2026-04-18).
  */
-export { createContextFacade, type ContextFacadeConfig, type ContextFacadeTransport, } from "./facade/context";
+
+export {
+  createContextFacade,
+  type ContextFacadeConfig,
+  type ContextFacadeTransport,
+} from "./facade/context";