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

package/dist/lib/platform/sdk/graphClient.js

@@ -1,235 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { mapAliasedList, mapGatewayData, normalizeNodeWriteInput, normalizeNodeVerificationStatus, normalizeTopicQuery, withSdkAliases, } from "./sdkSurface.js";
-export { LucernApiError };
-/**
- * Create the low-level graph client for nodes, edges, and graph analytics.
- * @param config - Gateway transport configuration.
- * @returns An object with methods for CRUD on nodes/edges plus analytics, traversal, and search.
- */
-export function createGraphClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List graph nodes matching the provided filters.
-         */
-        async listNodes(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/nodes${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "nodes")));
-        },
-        /**
-         * @deprecated Use listNodes.
-         */
-        async queryNodes(query) {
-            return this.listNodes(query);
-        },
-        /**
-         * Retrieve a single graph node by nodeId or globalId.
-         */
-        async getNode(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/nodes${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Create a graph node.
-         */
-        async createNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes",
-                method: "POST",
-                body: normalizeNodeWriteInput(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Update a graph node.
-         */
-        async updateNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes",
-                method: "PUT",
-                body: normalizeNodeWriteInput(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
-        },
-        /**
-         * Batch create graph nodes through the admin route surface.
-         */
-        async batchCreateNodes(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/batch",
-                method: "POST",
-                body: {
-                    nodes: input.nodes.map((node) => normalizeNodeWriteInput(node)),
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Supersede an existing graph node with a new canonical version.
-         */
-        async supersedeNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/supersede",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a node's verification status.
-         */
-        async verifyNode(input, idempotencyKey) {
-            const verificationStatus = normalizeNodeVerificationStatus(input.verificationStatus) ??
-                input.verificationStatus;
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/verify",
-                method: "POST",
-                body: {
-                    ...input,
-                    verificationStatus,
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Permanently delete a node via the admin-only hard-delete route.
-         */
-        async hardDeleteNode(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/nodes/hard-delete",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List graph edges matching the provided filters.
-         */
-        async listEdges(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/edges${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "edges")));
-        },
-        /**
-         * @deprecated Use listEdges.
-         */
-        async queryEdges(query) {
-            return this.listEdges(query);
-        },
-        /**
-         * Create a graph edge.
-         */
-        async createEdge(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/edges",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Delete one or more edges matching the provided filter.
-         */
-        async deleteEdge(query, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/edges${toQueryString(query)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Retrieve a graph neighborhood around a root node.
-         */
-        async neighborhood(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/neighborhood${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Traverse the graph from a starting node.
-         */
-        async traverse(query) {
-            return gateway.request({
-                path: "/api/platform/v1/graph/traverse",
-                method: "POST",
-                body: normalizeTopicQuery(query),
-            });
-        },
-        /**
-         * Analyze graph structure for a topic.
-         */
-        async analyze(query = {}) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/analyze${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    metric: typeof normalized.metric === "string" ? normalized.metric : undefined,
-                    limit: typeof normalized.limit === "number" ? normalized.limit : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Detect confirmation-bias patterns for a topic graph.
-         */
-        async bias(query = {}) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/bias${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    threshold: typeof normalized.threshold === "number"
-                        ? normalized.threshold
-                        : undefined,
-                    limit: typeof normalized.limit === "number" ? normalized.limit : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Find graph gaps for beliefs that still need testing.
-         */
-        async gaps(query) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/graph/gaps${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
-                    minConfidence: typeof normalized.minConfidence === "number"
-                        ? normalized.minConfidence
-                        : undefined,
-                })}`,
-            });
-        },
-        /**
-         * Search across graph resources within a topic.
-         */
-        async search(query) {
-            return gateway.request({
-                path: "/api/platform/v1/search",
-                method: "POST",
-                body: normalizeTopicQuery(query),
-            });
-        },
-        /**
-         * Retrieve a graph neighborhood around a root node.
-         */
-        async getNeighborhood(query) {
-            return this.neighborhood(query);
-        },
-        /**
-         * Retrieve the shortest known path between two graph nodes.
-         */
-        async getPath(query) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/path${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Retrieve graph analytics for the requested metric.
-         */
-        async getAnalytics(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/graph/analytics${toQueryString(query)}`,
-            });
-        },
-    };
-}

package/dist/lib/platform/sdk/harnessClient.js

@@ -1,219 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurface.js";
-export { LucernApiError };
-/**
- * Create the harness client for agent and tool registry operations.
- */
-export function createHarnessClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List agent definitions.
-         */
-        async listAgentDefinitions(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/agents${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "agents")));
-        },
-        /**
-         * Get an agent definition.
-         */
-        async getAgentDefinition(agentId, scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/agents/${encodeURIComponent(agentId)}${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Create an agent definition.
-         */
-        async createAgentDefinition(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/harness/agents",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use createAgentDefinition.
-         */
-        async registerAgentDefinition(input, idempotencyKey) {
-            return this.createAgentDefinition(input, idempotencyKey);
-        },
-        /**
-         * Update an agent definition.
-         */
-        async updateAgentDefinition(agentId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/agents/${encodeURIComponent(agentId)}`,
-                method: "PUT",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Invoke a managed agent definition.
-         */
-        async invokeManagedAgentDefinition(agentId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/agents/${encodeURIComponent(agentId)}/runs`,
-                method: "POST",
-                body: {
-                    agentDefinitionId: agentId,
-                    ...input,
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List runs for an agent definition.
-         */
-        async listAgentRuns(agentId, scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/agents/${encodeURIComponent(agentId)}/runs${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "runs")));
-        },
-        /**
-         * @deprecated Use listAgentRuns.
-         */
-        async listRunsForAgent(agentId, scope = {}) {
-            return this.listAgentRuns(agentId, scope);
-        },
-        /**
-         * List tool definitions.
-         */
-        async listToolDefinitions(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/tools${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "tools")));
-        },
-        /**
-         * Get a tool definition.
-         */
-        async getToolDefinition(toolId, scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/tools/${encodeURIComponent(toolId)}${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Create a tool definition.
-         */
-        async createToolDefinition(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/harness/tools",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use createToolDefinition.
-         */
-        async registerToolDefinition(input, idempotencyKey) {
-            return this.createToolDefinition(input, idempotencyKey);
-        },
-        /**
-         * Update a tool definition.
-         */
-        async updateToolDefinition(toolId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/tools/${encodeURIComponent(toolId)}`,
-                method: "PUT",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Execute a tool definition.
-         */
-        async executeToolDefinition(toolId, input = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/tools/${encodeURIComponent(toolId)}/execute`,
-                method: "POST",
-                body: input,
-            });
-        },
-        /**
-         * List run ledger entries.
-         */
-        async listRunEntries(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/runs${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "runs")));
-        },
-        /**
-         * @deprecated Use listRunEntries.
-         */
-        async listRunLedgerEntries(scope = {}) {
-            return this.listRunEntries(scope);
-        },
-        /**
-         * Create a harness run.
-         */
-        async startHarnessRun(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/harness/runs",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Get a run ledger entry.
-         */
-        async getRunLedgerEntry(runId) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/runs/${encodeURIComponent(runId)}`,
-            });
-        },
-        /**
-         * Update a harness run with a ledger event.
-         */
-        async reportHarnessRunEvent(runId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/runs/${encodeURIComponent(runId)}/report`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a harness run heartbeat.
-         */
-        async heartbeatHarnessRun(runId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/runs/${encodeURIComponent(runId)}/heartbeat`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Complete a harness run.
-         */
-        async completeHarnessRun(runId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/runs/${encodeURIComponent(runId)}/complete`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List prompt resolutions.
-         */
-        async listPromptResolutions(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/harness/prompts${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "prompts")));
-        },
-        /**
-         * Get the harness scope taxonomy.
-         */
-        async getScopeTaxonomy() {
-            return gateway.request({
-                path: "/api/platform/v1/harness/scopes",
-            });
-        },
-    };
-}

package/dist/lib/platform/sdk/identityClient.js

@@ -1,131 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData } from "./sdkSurface.js";
-function createIdentityWhoamiClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        async whoami() {
-            return gateway.request({
-                path: "/api/platform/v1/identity/whoami",
-            });
-        },
-    };
-}
-export { LucernApiError };
-/**
- * Create the identity client for principals and API keys.
- * @param config - Gateway transport configuration.
- * @returns An object with methods for whoami, principal management, and key management.
- */
-export function createIdentityClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    const whoamiClient = createIdentityWhoamiClient(config);
-    const requestPrincipalWrite = (method, input, idempotencyKey) => gateway.request({
-        path: "/api/platform/v1/identity/principals",
-        method,
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-    });
-    return {
-        /**
-         * Resolve the current authenticated identity summary.
-         */
-        async whoami() {
-            return whoamiClient.whoami().then((response) => mapGatewayData(response, (data) => ({
-                principalId: data.principalId,
-                principalType: data.principalType,
-                tenantId: data.tenantId ?? null,
-                workspaceId: data.workspaceId ?? null,
-                scopes: Array.isArray(data.scopes) ? data.scopes : [],
-                roles: Array.isArray(data.roles) ? data.roles : [],
-                isPlatformAdmin: data.isPlatformAdmin === true,
-                isTenantAdmin: data.isTenantAdmin === true,
-                isWorkspaceAdmin: data.isWorkspaceAdmin === true,
-                authMode: data.authMode,
-                sessionId: data.sessionId,
-                delegatedBy: data.delegatedBy,
-                expiresAt: data.expiresAt,
-            })));
-        },
-        /**
-         * List principals in the current identity scope.
-         */
-        async listPrincipals(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/identity/principals${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "principals")));
-        },
-        /**
-         * Create a principal.
-         */
-        async createPrincipal(input, idempotencyKey) {
-            return requestPrincipalWrite("POST", input, idempotencyKey);
-        },
-        /**
-         * Update a principal.
-         */
-        async updatePrincipal(input, idempotencyKey) {
-            return requestPrincipalWrite("PATCH", input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use createPrincipal or updatePrincipal.
-         */
-        async upsertPrincipal(input, idempotencyKey) {
-            return requestPrincipalWrite("PATCH", input, idempotencyKey);
-        },
-        /**
-         * List keys in the current identity scope.
-         */
-        async listKeys(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/identity/keys${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "keys")));
-        },
-        /**
-         * Create an API key.
-         */
-        async createKey(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/identity/keys",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Rotate an API key.
-         */
-        async rotateKey(keyId, input = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/rotate`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Delete an API key by revoking it.
-         */
-        async deleteKey(keyId, input = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/revoke`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use deleteKey.
-         */
-        async revokeKey(keyId, input = {}, idempotencyKey) {
-            return this.deleteKey(keyId, input, idempotencyKey);
-        },
-        /**
-         * Search Clerk users by email or display attributes.
-         */
-        async searchClerkUsers(q) {
-            return gateway.request({
-                path: `/api/platform/v1/identity/clerk-users${toQueryString({ q })}`,
-            });
-        },
-    };
-}

package/dist/lib/platform/sdk/index.d.ts

@@ -1,49 +0,0 @@
-/**
- * @lucern/sdk — The reasoning operating system for AI-native applications.
- *
- * This is the main entry point. It re-exports all client factories,
- * types, contracts, and utilities from domain modules.
- *
- * @packageDocumentation
- */
-export * from "./adminClient";
-export * from "./answersClient";
-export * from "./audiencesClient";
-export * from "./auditClient";
-export * from "./beliefsClient";
-export * from "./client";
-export * from "./contextFacade";
-export * from "./contextPackCompiler";
-export * from "./controlObjectOwnership";
-export * from "./coreClient";
-export * from "./contextClient";
-export * from "./contracts/api-enums.contract";
-export * from "./contracts/auth-session.contract";
-export { MAX_ENTITY_LIMIT } from "./contracts/contextPack";
-export * from "./contracts/lensFilter";
-export * from "./contracts/lensWorkflow";
-export * from "./contracts/mcpTools";
-export * from "./contracts/prompt";
-export * from "./contracts/workflowRuntime";
-export * from "./domainContext";
-export * from "./customTools";
-export * from "./decisionsClient";
-export * from "./events";
-export * from "./eventsCore";
-export * from "./graphClient";
-export * from "./harnessClient";
-export * from "./identityClient";
-export * from "./learningClient";
-export * from "./mcpParityClient";
-export * from "./mcpParitySurface";
-export * from "./ontologyClient";
-export * from "./packRuntime";
-export * from "./packsClient";
-export * from "./policyClient";
-export * from "./reportsClient";
-export * from "./schemaClient";
-export * from "./sdkSurface";
-export * from "./topicsClient";
-export * from "./types";
-export * from "./version";
-export * from "./workflowClient";

package/dist/lib/platform/sdk/index.js

@@ -1,49 +0,0 @@
-/**
- * @lucern/sdk — The reasoning operating system for AI-native applications.
- *
- * This is the main entry point. It re-exports all client factories,
- * types, contracts, and utilities from domain modules.
- *
- * @packageDocumentation
- */
-export * from "./adminClient.js";
-export * from "./answersClient.js";
-export * from "./audiencesClient.js";
-export * from "./auditClient.js";
-export * from "./beliefsClient.js";
-export * from "./client.js";
-export * from "./contextFacade.js";
-export * from "./contextPackCompiler.js";
-export * from "./controlObjectOwnership.js";
-export * from "./coreClient.js";
-export * from "./contextClient.js";
-export * from "./contracts/api-enums.contract.js";
-export * from "./contracts/auth-session.contract.js";
-export { MAX_ENTITY_LIMIT } from "./contracts/contextPack.js";
-export * from "./contracts/lensFilter.js";
-export * from "./contracts/lensWorkflow.js";
-export * from "./contracts/mcpTools.js";
-export * from "./contracts/prompt.js";
-export * from "./contracts/workflowRuntime.js";
-export * from "./domainContext.js";
-export * from "./customTools.js";
-export * from "./decisionsClient.js";
-export * from "./events.js";
-export * from "./eventsCore.js";
-export * from "./graphClient.js";
-export * from "./harnessClient.js";
-export * from "./identityClient.js";
-export * from "./learningClient.js";
-export * from "./mcpParityClient.js";
-export * from "./mcpParitySurface.js";
-export * from "./ontologyClient.js";
-export * from "./packRuntime.js";
-export * from "./packsClient.js";
-export * from "./policyClient.js";
-export * from "./reportsClient.js";
-export * from "./schemaClient.js";
-export * from "./sdkSurface.js";
-export * from "./topicsClient.js";
-export * from "./types.js";
-export * from "./version.js";
-export * from "./workflowClient.js";