@lucern/sdk 0.2.0-alpha.1

package/dist/lucern/packages/sdk-typescript/src/index.d.ts

@@ -0,0 +1,28 @@
+export * from "./facade/beliefs";
+export * from "./facade/contradictions";
+export * from "./facade/edges";
+export * from "./facade/events";
+export * from "./facade/identity";
+export * from "./facade/evidence";
+export * from "./facade/graph";
+export * from "./facade/ontologies";
+export * from "./facade/questions";
+export * from "./facade/search";
+export * from "./facade/tasks";
+export * from "./facade/topics";
+export * from "./facade/webhooks";
+export * from "./facade/worktrees";
+export * from "@/lucern/packages/domain-beliefs/src/beliefs";
+export * from "@/lucern/packages/domain-edges/src/contradictions";
+export * from "@/lucern/packages/domain-edges/src/edges";
+export * from "@/lucern/packages/domain-evidence/src/evidence";
+export * from "@/lucern/packages/domain-graph/src/graph";
+export * from "@/lucern/packages/domain-identity/src/whoami";
+export * from "@/lucern/packages/domain-ontologies/src/ontologies";
+export * from "@/lucern/packages/domain-questions/src/questions";
+export * from "@/lucern/packages/domain-search/src/search";
+export * from "@/lucern/packages/domain-tasks/src/tasks";
+export * from "@/lucern/packages/domain-topics/src/topics";
+export * from "@/lucern/packages/domain-worktrees/src/worktrees";
+export * from "@/lucern/packages/events/src/types";
+export * from "./facade/context";

package/dist/packages/sdk/src/adminClient.d.ts

@@ -0,0 +1,89 @@
+import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
+import type { ControlObjectOwnershipContract } from "./controlObjectOwnership";
+import type { JsonObject } from "./types";
+export { LucernApiError };
+export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export type AdminClientConfig = GatewayClientConfig;
+/**
+ * Create the admin client for tenant, workspace, and membership administration.
+ */
+export declare function createAdminClient(config?: AdminClientConfig): {
+    /**
+     * List tenants visible to the current principal.
+     */
+    listTenants(query?: {
+        status?: "active" | "disabled" | "archived";
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "tenants">>>;
+    /**
+     * Create a tenant.
+     */
+    createTenant(input: {
+        key: string;
+        slug?: string;
+        name: string;
+        status?: "active" | "disabled" | "archived";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Get the control-object ownership contract.
+     */
+    getControlObjectOwnership(): Promise<import("./coreClient").PlatformGatewaySuccess<ControlObjectOwnershipContract>>;
+    /**
+     * @deprecated Use getControlObjectOwnership.
+     */
+    getControlObjectOwnershipContract(): Promise<import("./coreClient").PlatformGatewaySuccess<ControlObjectOwnershipContract>>;
+    /**
+     * List workspaces for the current admin scope.
+     */
+    listWorkspaces(query?: GatewayScope & {
+        status?: "active" | "archived";
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "workspaces">>>;
+    /**
+     * Create a workspace.
+     */
+    createWorkspace(input: GatewayScope & {
+        key: string;
+        slug?: string;
+        name: string;
+        status?: "active" | "archived";
+        defaultProjectVisibility?: "private" | "firm" | "public";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List memberships for the current admin scope.
+     */
+    listMemberships(query?: GatewayScope & {
+        principalId?: string;
+        status?: "active" | "revoked" | "expired";
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "memberships">>>;
+    /**
+     * Create a membership.
+     */
+    createMembership(input: GatewayScope & {
+        principalId: string;
+        role: "platform_admin" | "tenant_admin" | "workspace_admin" | "editor" | "viewer" | "auditor" | "service_agent";
+        status?: "active" | "revoked" | "expired";
+        source?: "bootstrap" | "manual" | "sync" | "invitation";
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update a membership.
+     */
+    updateMembership(input: GatewayScope & {
+        principalId: string;
+        role: "platform_admin" | "tenant_admin" | "workspace_admin" | "editor" | "viewer" | "auditor" | "service_agent";
+        status?: "active" | "revoked" | "expired";
+        source?: "bootstrap" | "manual" | "sync" | "invitation";
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createMembership or updateMembership.
+     */
+    upsertMembership(input: GatewayScope & {
+        principalId: string;
+        role: "platform_admin" | "tenant_admin" | "workspace_admin" | "editor" | "viewer" | "auditor" | "service_agent";
+        status?: "active" | "revoked" | "expired";
+        source?: "bootstrap" | "manual" | "sync" | "invitation";
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+};

package/dist/packages/sdk/src/answersClient.d.ts

@@ -0,0 +1,5 @@
+import { type GatewayClientConfig } from "./coreClient";
+export type AnswersClientConfig = GatewayClientConfig;
+export declare function createAnswersClient(config?: AnswersClientConfig): {
+    get(questionId: string): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+};

package/dist/packages/sdk/src/audiencesClient.d.ts

@@ -0,0 +1,87 @@
+import { type GatewayClientConfig, type GatewayScope } from "./coreClient";
+import type { JsonObject } from "./types";
+export type AudiencesClientConfig = GatewayClientConfig;
+export type AudienceRegistryInput = GatewayScope & {
+    audienceKey: string;
+    audienceLabel: string;
+    audienceClass: "internal" | "restricted_external" | "public";
+    status?: "active" | "disabled" | "archived";
+    description?: string;
+    metadata?: JsonObject;
+};
+export type AudienceGrantInput = GatewayScope & {
+    audienceKey: string;
+    audienceClass?: "internal" | "restricted_external" | "public";
+    principalId?: string;
+    groupId?: string;
+    expiresAt?: number;
+    metadata?: JsonObject;
+};
+export type AudienceGrantRevokeInput = GatewayScope & {
+    grantId: string;
+};
+/**
+ * Create the audiences client for registry entries and grants.
+ */
+export declare function createAudiencesClient(config?: AudiencesClientConfig): {
+    /**
+     * List audience registry entries.
+     */
+    listRegistry(query?: GatewayScope & {
+        effective?: boolean;
+        status?: "active" | "disabled" | "archived";
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "registryEntries">>>;
+    /**
+     * @deprecated Use listRegistry.
+     */
+    getRegistry(query?: GatewayScope & {
+        effective?: boolean;
+        status?: "active" | "disabled" | "archived";
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "registryEntries">>>;
+    /**
+     * Create an audience registry entry.
+     */
+    createRegistryEntry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update an audience registry entry.
+     */
+    updateRegistryEntry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createRegistryEntry or updateRegistryEntry.
+     */
+    upsertRegistry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List audience grants.
+     */
+    listGrants(query?: GatewayScope & {
+        audienceKey?: string;
+        principalId?: string;
+        groupId?: string;
+        status?: "active" | "revoked" | "expired";
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "grants">>>;
+    /**
+     * @deprecated Use listGrants.
+     */
+    getGrants(query?: GatewayScope & {
+        audienceKey?: string;
+        principalId?: string;
+        groupId?: string;
+        status?: "active" | "revoked" | "expired";
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "grants">>>;
+    /**
+     * Create an audience grant.
+     */
+    createGrant(input: AudienceGrantInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createGrant.
+     */
+    grant(input: AudienceGrantInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Delete an audience grant by revoking it.
+     */
+    deleteGrant(input: AudienceGrantRevokeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use deleteGrant.
+     */
+    revokeGrant(input: AudienceGrantRevokeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+};

package/dist/packages/sdk/src/auditClient.d.ts

@@ -0,0 +1,23 @@
+import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
+import type { TopicIdentifierInput } from "./types";
+export { LucernApiError };
+export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export type AuditClientConfig = GatewayClientConfig;
+/**
+ * Create the audit client for transport-level audit event reads.
+ */
+export declare function createAuditClient(config?: AuditClientConfig): {
+    /**
+     * List audit events for the current scope.
+     */
+    listEvents(query?: GatewayScope & {
+        action?: string;
+        decision?: string;
+        traceId?: string;
+        principalId?: string;
+        topicId?: string;
+        /** @deprecated Use topicId. */
+        projectId?: string;
+        limit?: number;
+    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "events">>>;
+};

package/dist/packages/sdk/src/beliefsClient.d.ts

@@ -0,0 +1,54 @@
+import { type GatewayClientConfig, LucernApiError } from "./coreClient";
+import type { ForkBeliefResponse, JsonObject, ModulateConfidenceResponse, TextAliasInput, TopicIdentifierInput } from "./types";
+export { LucernApiError };
+export type { PlatformGatewaySuccess } from "./coreClient";
+export type { CreateBeliefResponse, ForkBeliefResponse, ModulateConfidenceResponse, } from "./types";
+export type BeliefsClientConfig = GatewayClientConfig;
+export type CreateBeliefInput = {
+    topicId?: string;
+    /** @deprecated Use text. */
+    canonicalText?: string;
+    text?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    layer?: "L1" | "L2" | "L3" | "L4";
+    domain?: string;
+    sourceType?: "human" | "ai" | "agent" | "imported";
+    content?: string;
+    contentHash?: string;
+    globalId?: string;
+    title?: string;
+    subtype?: string;
+    confidence?: number;
+    tags?: string[];
+    metadata?: JsonObject;
+    verificationStatus?: "unverified" | "verified" | "rejected";
+} & TopicIdentifierInput & TextAliasInput;
+export type ModulateConfidenceInput = {
+    confidence: number;
+    trigger?: "evidence_added" | "evidence_removed" | "contradiction_detected" | "contradiction_resolved" | "manual" | "decay" | "agent_assessment" | "merge_outcome" | "sprint_outcome" | "sprint_completed";
+    rationale: string;
+    certainty?: number;
+};
+export type ForkBeliefInput = {
+    newFormulation: string;
+    forkReason?: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse" | "manual";
+    rationale?: string;
+};
+/**
+ * Create the beliefs client for belief lifecycle operations.
+ */
+export declare function createBeliefsClient(config?: BeliefsClientConfig): {
+    /**
+     * Create a belief within a topic scope.
+     */
+    createBelief(input: CreateBeliefInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").PlatformBeliefRecord>>;
+    /**
+     * Record a confidence change for an existing belief.
+     */
+    modulateConfidence(beliefId: string, input: ModulateConfidenceInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<ModulateConfidenceResponse>>;
+    /**
+     * Fork a scored belief into a new formulation.
+     */
+    forkBelief(beliefId: string, input: ForkBeliefInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<ForkBeliefResponse>>;
+};