@lucern/sdk 0.2.0-alpha.4 → 0.2.0-alpha.5

package/README.md

@@ -10,6 +10,37 @@ Lucern gives your agents a reasoning graph that accumulates understanding across
 npm install @lucern/sdk
 ```
 
+## Canonical Interface
+
+`@lucern/sdk` is the canonical public interface for Lucern.
+
+- Build applications, automations, and backend integrations against the SDK first.
+- Treat `/api/platform/v1/*` as the transport mirror of the SDK surface.
+- Treat MCP as an agent-facing client of the same surface, not as a privileged bypass around SDK or HTTP semantics.
+
+IA-7 closes the remaining SDK surface gaps needed for SDK-first clients:
+
+- Kernel mutations that previously only existed behind route or MCP adapters now have SDK wrappers across beliefs, evidence, questions, edges, topics, worktrees, and nodes.
+- `lucern.identity.whoami()` exposes resolved principal context for service principals, tenant API keys, and interactive users.
+- Public SDK types now export `SdkPrincipalContext` plus the `Platform*Record` and `Workflow*Record` families for typed client code.
+
+```typescript
+import {
+  createLucernClient,
+  type PlatformBeliefRecord,
+  type SdkPrincipalContext,
+  type WorkflowWorktreeRecord,
+} from "@lucern/sdk";
+
+const lucern = createLucernClient({
+  apiKey: process.env.LUCERN_API_KEY,
+  baseUrl: "https://api.lucern.ai",
+});
+
+const identity = await lucern.identity.whoami();
+const principal: SdkPrincipalContext = identity.data;
+```
+
 ## The Full Developer Journey
 
 This walkthrough mirrors what a developer building an AI-powered code review system would experience in a real coding session. Every API call is something you would actually use.

package/dist/.generated

@@ -0,0 +1,2 @@
+generated-by:scripts/build-sdk-package.ts
+package:@lucern/sdk

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./lib/platform/sdk/index";
+export { createLucernClient, type LucernClientConfig } from "./lib/platform/sdk/client";
+export { LUCERN_SDK_VERSION } from "./lib/platform/sdk/version";