@lucern/sdk 0.2.0-alpha.1

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

@@ -0,0 +1,209 @@
+import { type GatewayClientConfig, LucernApiError } from "./coreClient";
+import type { DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, JsonObject, ListResult, PlatformGraphEdge, PlatformGraphNode, TextAliasInput, TopicIdentifierInput } from "./types";
+export { LucernApiError };
+export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export type { CreateEdgeResponse, CreateNodeResponse, DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, ListResult, QueryEdgesResponse, QueryNodesResponse, UpdateNodeResponse, } from "./types";
+export type GraphClientConfig = GatewayClientConfig;
+export type ListNodesInput = {
+    nodeId?: string;
+    globalId?: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    nodeType?: string;
+    limit?: number;
+} & TopicIdentifierInput;
+export type ListNodesResponse = ListResult<PlatformGraphNode, "nodes">;
+export type QueryNodesInput = ListNodesInput;
+export type CreateNodeInput = {
+    text?: string;
+    /** @deprecated Use text. */
+    canonicalText?: string;
+    nodeType: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    content?: string;
+    contentHash?: string;
+    globalId?: string;
+    sourceType?: string;
+    subtype?: string;
+    title?: string;
+    confidence?: number;
+    status?: string;
+    tags?: string[];
+    metadata?: JsonObject;
+    verificationStatus?: string;
+} & TextAliasInput & TopicIdentifierInput;
+export type UpdateNodeInput = {
+    nodeId: string;
+    text?: string;
+    canonicalText?: string;
+    content?: string;
+    contentHash?: string;
+    title?: string;
+    subtype?: string;
+    confidence?: number;
+    status?: string;
+    tags?: string[];
+    metadata?: JsonObject;
+    verificationStatus?: string;
+} & TextAliasInput;
+export type ListEdgesInput = {
+    edgeId?: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    fromNodeId?: string;
+    toNodeId?: string;
+    edgeType?: string;
+    limit?: number;
+} & TopicIdentifierInput;
+export type ListEdgesResponse = ListResult<PlatformGraphEdge, "edges">;
+export type QueryEdgesInput = ListEdgesInput;
+export type CreateEdgeInput = {
+    fromNodeId: string;
+    toNodeId: string;
+    edgeType: string;
+    globalId?: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    confidence?: number;
+    weight?: number;
+    context?: string;
+    derivationType?: string;
+} & TopicIdentifierInput;
+export type DeleteEdgeInput = {
+    edgeId?: string;
+    fromNodeId?: string;
+    toNodeId?: string;
+    edgeType?: string;
+};
+export type NeighborhoodInput = {
+    globalId?: string;
+    globalIds?: string;
+    maxDepth?: number;
+};
+export type PathInput = {
+    fromGlobalId: string;
+    toGlobalId: string;
+    maxDepth?: number;
+};
+export type AnalyticsInput = {
+    metric?: GraphAnalyticsMetric;
+    limit?: number;
+};
+export type TraverseInput = {
+    startNode: string;
+    direction?: string;
+    maxDepth?: number;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+} & TopicIdentifierInput;
+export type AnalyzeInput = {
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    metric?: GraphAnalyticsMetric;
+    limit?: number;
+} & TopicIdentifierInput;
+export type BiasInput = {
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    threshold?: number;
+    limit?: number;
+} & TopicIdentifierInput;
+export type GapsInput = {
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    minConfidence?: number;
+} & TopicIdentifierInput;
+export type SearchInput = {
+    q?: string;
+    query?: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    types?: string[];
+    status?: string;
+    minConfidence?: number;
+    limit?: number;
+    cursor?: string;
+} & TopicIdentifierInput;
+/**
+ * Create the low-level graph client for nodes, edges, and graph analytics.
+ */
+export declare function createGraphClient(config?: GraphClientConfig): {
+    /**
+     * List graph nodes matching the provided filters.
+     */
+    listNodes(query: ListNodesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
+    /**
+     * @deprecated Use listNodes.
+     */
+    queryNodes(query: QueryNodesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
+    /**
+     * Create a graph node.
+     */
+    createNode(input: CreateNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphNode>>;
+    /**
+     * Update a graph node.
+     */
+    updateNode(input: UpdateNodeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphNode>>;
+    /**
+     * List graph edges matching the provided filters.
+     */
+    listEdges(query: ListEdgesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
+    /**
+     * @deprecated Use listEdges.
+     */
+    queryEdges(query: QueryEdgesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;
+    /**
+     * Create a graph edge.
+     */
+    createEdge(input: CreateEdgeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<PlatformGraphEdge>>;
+    /**
+     * Delete one or more edges matching the provided filter.
+     */
+    deleteEdge(query: DeleteEdgeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<DeleteEdgeResponse>>;
+    /**
+     * Retrieve a graph neighborhood around a root node.
+     */
+    neighborhood(query: NeighborhoodInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
+    /**
+     * Traverse the graph from a starting node.
+     */
+    traverse(query: TraverseInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Analyze graph structure for a topic.
+     */
+    analyze(query?: AnalyzeInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Detect confirmation-bias patterns for a topic graph.
+     */
+    bias(query?: BiasInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Find graph gaps for beliefs that still need testing.
+     */
+    gaps(query: GapsInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Search across graph resources within a topic.
+     */
+    search(query: SearchInput): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Retrieve a graph neighborhood around a root node.
+     */
+    getNeighborhood(query: NeighborhoodInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphNeighborhoodResponse>>;
+    /**
+     * Retrieve the shortest known path between two graph nodes.
+     */
+    getPath(query: PathInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphPathResponse>>;
+    /**
+     * Retrieve graph analytics for the requested metric.
+     */
+    getAnalytics(query?: AnalyticsInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalyticsResponse>>;
+};

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

@@ -0,0 +1,222 @@
+import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
+import type { JsonObject, JsonValue, TopicIdentifierInput } from "./types";
+export { LucernApiError };
+export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export type HarnessClientConfig = GatewayClientConfig;
+export type HarnessAgentWriteInput = GatewayScope & {
+    agentDefinitionId?: string;
+    agentKey: string;
+    displayName: string;
+    description: string;
+    version: string;
+    status?: "active" | "deprecated" | "disabled";
+    executionAdapter: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+    scopeRequirements?: string[];
+    promptReleaseChannel?: "dev" | "staging" | "prod";
+    parameterSchema?: JsonObject;
+    exampleInvocations?: Array<{
+        input: JsonObject;
+        expectedOutput?: JsonValue;
+    }>;
+    metadata?: JsonObject;
+};
+export type HarnessToolWriteInput = GatewayScope & {
+    toolId?: string;
+    toolName: string;
+    description: string;
+    version: string;
+    status?: "draft" | "active" | "deprecated" | "disabled";
+    executionAdapter: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+    gateClassification?: "core" | "shimmed";
+    scopeRequirements?: string[];
+    requiredRole?: string;
+    requiredAction?: string;
+    surfaces?: string[];
+    category?: string;
+    parameterSchema?: JsonObject;
+    returnSchema?: JsonObject;
+    handlerRef?: string;
+    callbackUrl?: string;
+    safetyMetadata: {
+        readOnly?: boolean;
+        idempotent?: boolean;
+        sideEffectLevel: "none" | "low" | "high";
+    };
+    exampleInvocations?: Array<{
+        input: JsonObject;
+        expectedOutput?: JsonValue;
+    }>;
+    metadata?: JsonObject;
+};
+export type HarnessStartRunInput = GatewayScope & {
+    agentDefinitionId: string;
+    agentVersion: string;
+    executionAdapter: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+    promptReleaseChannel?: "dev" | "staging" | "prod";
+    chatId?: string;
+    sprintId?: string;
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    langfuseTraceId?: string;
+    metadata?: JsonObject;
+} & TopicIdentifierInput;
+export type HarnessRunReportInput = {
+    reportingToken: string;
+    type: "tool_call" | "prompt_resolution" | "policy_decision";
+    metadata?: JsonObject;
+    toolCallId?: string;
+    toolName?: string;
+    executionAdapter?: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+    policyDecisionId?: string;
+    requiredScopes?: string[];
+    policyResult?: "allowed" | "denied";
+    policyReasonCode?: string;
+    inputHash?: string;
+    outputHash?: string;
+    durationMs?: number;
+    success?: boolean;
+    startedAt?: number;
+    completedAt?: number;
+    input?: JsonObject;
+    result?: JsonValue;
+    promptKey?: string;
+    promptVersion?: string;
+    decision?: string;
+    reasonCode?: string;
+    latencyMs?: number;
+    error?: string | {
+        code?: string;
+        message: string;
+        details?: JsonValue;
+    };
+};
+export type HarnessCompleteRunInput = {
+    reportingToken: string;
+    status: "completed" | "failed" | "timeout";
+    error?: {
+        category: "policy_denied" | "tool_execution" | "prompt_resolution" | "model_error" | "timeout" | "heartbeat_timeout" | "input_validation" | "internal" | "external_service";
+        message: string;
+        code?: string;
+    };
+};
+/**
+ * Create the harness client for agent and tool registry operations.
+ */
+export declare function createHarnessClient(config?: HarnessClientConfig): {
+    /**
+     * List agent definitions.
+     */
+    listAgentDefinitions(scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "agents">>>;
+    /**
+     * Get an agent definition.
+     */
+    getAgentDefinition(agentId: string, scope?: GatewayScope): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Create an agent definition.
+     */
+    createAgentDefinition(input: HarnessAgentWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createAgentDefinition.
+     */
+    registerAgentDefinition(input: HarnessAgentWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update an agent definition.
+     */
+    updateAgentDefinition(agentId: string, input: HarnessAgentWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List runs for an agent definition.
+     */
+    listAgentRuns(agentId: string, scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "runs">>>;
+    /**
+     * @deprecated Use listAgentRuns.
+     */
+    listRunsForAgent(agentId: string, scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "runs">>>;
+    /**
+     * List tool definitions.
+     */
+    listToolDefinitions(scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+        gateClassification?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "tools">>>;
+    /**
+     * Get a tool definition.
+     */
+    getToolDefinition(toolId: string, scope?: GatewayScope): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Create a tool definition.
+     */
+    createToolDefinition(input: HarnessToolWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createToolDefinition.
+     */
+    registerToolDefinition(input: HarnessToolWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update a tool definition.
+     */
+    updateToolDefinition(toolId: string, input: HarnessToolWriteInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List run ledger entries.
+     */
+    listRunEntries(scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "runs">>>;
+    /**
+     * @deprecated Use listRunEntries.
+     */
+    listRunLedgerEntries(scope?: GatewayScope & {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "runs">>>;
+    /**
+     * Create a harness run.
+     */
+    startHarnessRun(input: HarnessStartRunInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Get a run ledger entry.
+     */
+    getRunLedgerEntry(runId: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update a harness run with a ledger event.
+     */
+    reportHarnessRunEvent(runId: string, input: HarnessRunReportInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update a harness run heartbeat.
+     */
+    heartbeatHarnessRun(runId: string, input: {
+        reportingToken: string;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Complete a harness run.
+     */
+    completeHarnessRun(runId: string, input: HarnessCompleteRunInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List prompt resolutions.
+     */
+    listPromptResolutions(query?: {
+        runId?: string;
+        promptName?: string;
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "prompts">>>;
+    /**
+     * Get the harness scope taxonomy.
+     */
+    getScopeTaxonomy(): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+};

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

@@ -0,0 +1,104 @@
+import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
+import type { JsonObject } from "./types";
+import { type IdentityWhoamiResponse } from "@/lucern/packages/client-core/src/identity";
+export type { IdentitySummary } from "@/lucern/packages/domain-identity/src/whoami";
+export { LucernApiError };
+export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export type IdentityClientConfig = GatewayClientConfig;
+export type { IdentityWhoamiResponse };
+/**
+ * Create the identity client for principals and API keys.
+ */
+export declare function createIdentityClient(config?: IdentityClientConfig): {
+    /**
+     * Resolve the current authenticated identity summary.
+     */
+    whoami(): Promise<IdentityWhoamiResponse>;
+    /**
+     * List principals in the current identity scope.
+     */
+    listPrincipals(query?: GatewayScope & {
+        status?: string;
+        principalType?: string;
+        query?: string;
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "principals">>>;
+    /**
+     * Create a principal.
+     */
+    createPrincipal(input: GatewayScope & {
+        principalId: string;
+        principalType: "user" | "group" | "service" | "external_viewer";
+        clerkId?: string;
+        email?: string;
+        displayName?: string;
+        status?: "active" | "disabled" | "revoked";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Update a principal.
+     */
+    updatePrincipal(input: GatewayScope & {
+        principalId: string;
+        principalType: "user" | "group" | "service" | "external_viewer";
+        clerkId?: string;
+        email?: string;
+        displayName?: string;
+        status?: "active" | "disabled" | "revoked";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use createPrincipal or updatePrincipal.
+     */
+    upsertPrincipal(input: GatewayScope & {
+        principalId: string;
+        principalType: "user" | "group" | "service" | "external_viewer";
+        clerkId?: string;
+        email?: string;
+        displayName?: string;
+        status?: "active" | "disabled" | "revoked";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * List keys in the current identity scope.
+     */
+    listKeys(query?: GatewayScope & {
+        principalId?: string;
+        status?: string;
+        limit?: number;
+    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "keys">>>;
+    /**
+     * Create an API key.
+     */
+    createKey(input: GatewayScope & {
+        principalId: string;
+        keyId?: string;
+        token?: string;
+        scopes?: string[];
+        environment?: "sandbox" | "production";
+        expiresInDays?: number;
+        rateLimitTier?: "free" | "developer" | "partner";
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Rotate an API key.
+     */
+    rotateKey(keyId: string, input?: {
+        replacementKeyId?: string;
+        replacementToken?: string;
+        replacementExpiresInDays?: number;
+        gracePeriodHours?: number;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * Delete an API key by revoking it.
+     */
+    deleteKey(keyId: string, input?: {
+        reason?: string;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    /**
+     * @deprecated Use deleteKey.
+     */
+    revokeKey(keyId: string, input?: {
+        reason?: string;
+    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+};

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

@@ -0,0 +1,28 @@
+export * from "./adminClient";
+export * from "./answersClient";
+export * from "./audiencesClient";
+export * from "./auditClient";
+export * from "./beliefsClient";
+export * from "./client";
+export * from "./contracts/api-enums.contract";
+export * from "@lucern/contracts/mcp-tools.contract";
+export * from "@lucern/contracts/workflow-runtime.contract";
+export * from "./controlObjectOwnership";
+export * from "./coreClient";
+export * from "./contextClient";
+export * from "./customTools";
+export * from "./decisionsClient";
+export * from "./graphClient";
+export * from "./harnessClient";
+export * from "./identityClient";
+export * from "./learningClient";
+export * from "./mcpParityClient";
+export * from "./ontologyClient";
+export * from "./packsClient";
+export * from "./policyClient";
+export * from "./reportsClient";
+export * from "./schemaClient";
+export * from "./topicsClient";
+export * from "./types";
+export * from "./version";
+export * from "./workflowClient";

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

@@ -0,0 +1,43 @@
+import { type GatewayClientConfig } from "./coreClient";
+import type { TopicIdentifierInput } from "./types";
+export type LearningClientConfig = GatewayClientConfig;
+/**
+ * Create the learning client for execution telemetry reads.
+ */
+export declare function createLearningClient(config?: LearningClientConfig): {
+    /**
+     * List recent execution records.
+     */
+    listRecentExecutions(args?: {
+        namespace?: string;
+        topicId?: string;
+        /** @deprecated Use topicId. */
+        projectId?: string;
+        audienceMode?: string;
+        success?: boolean;
+        limit?: number;
+    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "executions">>>;
+    /**
+     * @deprecated Use listRecentExecutions.
+     */
+    getRecentExecutions(args?: {
+        namespace?: string;
+        topicId?: string;
+        /** @deprecated Use topicId. */
+        projectId?: string;
+        audienceMode?: string;
+        success?: boolean;
+        limit?: number;
+    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "executions">>>;
+    /**
+     * Get aggregate execution statistics.
+     */
+    getExecutionStats(args?: {
+        namespace?: string;
+        topicId?: string;
+        /** @deprecated Use topicId. */
+        projectId?: string;
+        audienceMode?: string;
+        hours?: number;
+    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+};

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

@@ -0,0 +1,68 @@
+import { type GatewayClientConfig, type PlatformGatewaySuccess } from "./coreClient";
+import type { JsonObject } from "./types";
+export type McpParityClientConfig = GatewayClientConfig;
+type ToolArgs = JsonObject;
+type ToolResult<T = unknown> = Promise<PlatformGatewaySuccess<T>>;
+/**
+ * Thin typed bridge for MCP-only SDK parity methods.
+ *
+ * These methods map 1:1 to the Lucern MCP handlers and execute through the
+ * platform gateway so the SDK can cover the full control-plane surface.
+ */
+export declare function createMcpParityClient(config?: McpParityClientConfig): {
+    sessionId: `${string}-${string}-${string}-${string}-${string}`;
+    listTopics(args?: ToolArgs): ToolResult<unknown>;
+    createTopic(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getTopic(args: ToolArgs): ToolResult<unknown>;
+    getTopicTree(args: ToolArgs): ToolResult<unknown>;
+    activateWorktree(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    updateWorktreeMetadata(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    updateWorktreeTargets(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    listAllWorktrees(args?: ToolArgs): ToolResult<unknown>;
+    pipelineSnapshot(args: ToolArgs): ToolResult<unknown>;
+    recordScopeLearning(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    discover(args: ToolArgs): ToolResult<unknown>;
+    analyzeTopicDensity(args: ToolArgs): ToolResult<unknown>;
+    applyAutoBranching(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    seedBeliefLattice(args?: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getLatticeCoverage(args?: ToolArgs): ToolResult<unknown>;
+    matchEntityType(args: ToolArgs): ToolResult<unknown>;
+    discoverEntityConnections(args: ToolArgs): ToolResult<unknown>;
+    triggerBeliefReview(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    listOntologies(args?: ToolArgs): ToolResult<unknown>;
+    getOntology(args: ToolArgs): ToolResult<unknown>;
+    applyOntology(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    createOntology(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    updateOntology(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    archiveOntology(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    createOntologyVersion(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    publishOntologyVersion(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    deprecateOntologyVersion(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    resolveEffectiveOntology(args: ToolArgs): ToolResult<unknown>;
+    registerSession(args?: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    heartbeatSession(args?: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    endSession(args?: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    listActiveSessions(args?: ToolArgs): ToolResult<unknown>;
+    sendAgentMessage(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    broadcastMessage(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getAgentInbox(args?: ToolArgs): ToolResult<unknown>;
+    claimFiles(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    listTasks(args: ToolArgs): ToolResult<unknown>;
+    createAnswer(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getAnswer(args: ToolArgs): ToolResult<unknown>;
+    flagContradiction(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    ingestObservation(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getObservationContext(args: ToolArgs): ToolResult<unknown>;
+    getCodeContext(args: ToolArgs): ToolResult<unknown>;
+    getChangeHistory(args: ToolArgs): ToolResult<unknown>;
+    recordAttempt(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getFailureLog(args: ToolArgs): ToolResult<unknown>;
+    createEpistemicContract(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    evaluateContract(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    getContractStatus(args: ToolArgs): ToolResult<unknown>;
+    checkPermission(args: ToolArgs): ToolResult<unknown>;
+    filterByPermission(args: ToolArgs): ToolResult<unknown>;
+    manageWritePolicy(args: ToolArgs, idempotencyKey?: string): ToolResult<unknown>;
+    generateSessionHandoff(args: ToolArgs): ToolResult<unknown>;
+};
+export {};