@lucern/sdk 1.0.29 → 1.0.31

package/dist/graphClient.js

@@ -1,5 +1,8 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { mapAliasedList, mapGatewayData, normalizeNodeWriteInput, normalizeNodeVerificationStatus, normalizeTopicQuery, withSdkAliases, } from "./sdkSurface.js";
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
+import { createGatewayRequestClient, 
+// biome-ignore lint/style/noExportedImports: graphClient preserves this legacy compatibility re-export while package root also exports coreClient.
+LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
+import { mapAliasedList, mapGatewayData, normalizeNodeVerificationStatus, normalizeNodeWriteInput, normalizeTopicQuery, withSdkAliases, } from "./sdkSurface.js";
 export { LucernApiError };
 /**
  * Create the low-level graph client for nodes, edges, and graph analytics.
@@ -12,45 +15,53 @@ export function createGraphClient(config = {}) {
         /**
          * List graph nodes matching the provided filters.
          */
-        async listNodes(query) {
-            return gateway.request({
+        listNodes(query) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph/nodes${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "nodes")));
+            })
+                .then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "nodes")));
         },
         /**
          * Retrieve a single graph node by nodeId or globalId.
          */
-        async getNode(query) {
-            return gateway.request({
+        getNode(query) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph/nodes${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
         },
         /**
          * Create a graph node.
          */
-        async createNode(input, idempotencyKey) {
-            return gateway.request({
+        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)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
         },
         /**
          * Update a graph node.
          */
-        async updateNode(input, idempotencyKey) {
-            return gateway.request({
+        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)));
+            })
+                .then((response) => mapGatewayData(response, (data) => withSdkAliases(data)));
         },
         /**
          * Batch create graph nodes through the admin route surface.
          */
-        async batchCreateNodes(input, idempotencyKey) {
+        batchCreateNodes(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/graph/nodes/batch",
                 method: "POST",
@@ -63,7 +74,7 @@ export function createGraphClient(config = {}) {
         /**
          * Supersede an existing graph node with a new canonical version.
          */
-        async supersedeNode(input, idempotencyKey) {
+        supersedeNode(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/graph/nodes/supersede",
                 method: "POST",
@@ -74,7 +85,7 @@ export function createGraphClient(config = {}) {
         /**
          * Update a node's verification status.
          */
-        async verifyNode(input, idempotencyKey) {
+        verifyNode(input, idempotencyKey) {
             const verificationStatus = normalizeNodeVerificationStatus(input.verificationStatus) ??
                 input.verificationStatus;
             return gateway.request({
@@ -90,7 +101,7 @@ export function createGraphClient(config = {}) {
         /**
          * Permanently delete a node via the admin-only hard-delete route.
          */
-        async hardDeleteNode(input, idempotencyKey) {
+        hardDeleteNode(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/graph/nodes/hard-delete",
                 method: "POST",
@@ -101,15 +112,17 @@ export function createGraphClient(config = {}) {
         /**
          * List graph edges matching the provided filters.
          */
-        async listEdges(query) {
-            return gateway.request({
+        listEdges(query) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph/edges${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "edges")));
+            })
+                .then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "edges")));
         },
         /**
          * Create a graph edge.
          */
-        async createEdge(input, idempotencyKey) {
+        createEdge(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/graph/edges",
                 method: "POST",
@@ -120,7 +133,7 @@ export function createGraphClient(config = {}) {
         /**
          * Delete one or more edges matching the provided filter.
          */
-        async deleteEdge(query, idempotencyKey) {
+        deleteEdge(query, idempotencyKey) {
             return gateway.request({
                 path: `/api/platform/v1/graph/edges${toQueryString(query)}`,
                 method: "DELETE",
@@ -130,7 +143,7 @@ export function createGraphClient(config = {}) {
         /**
          * Retrieve a graph neighborhood around a root node.
          */
-        async neighborhood(query) {
+        neighborhood(query) {
             return gateway.request({
                 path: `/api/platform/v1/graph/neighborhood${toQueryString(query)}`,
             });
@@ -138,7 +151,7 @@ export function createGraphClient(config = {}) {
         /**
          * Traverse the graph from a starting node.
          */
-        async traverse(query) {
+        traverse(query) {
             return gateway.request({
                 path: "/api/platform/v1/graph/traverse",
                 method: "POST",
@@ -148,12 +161,16 @@ export function createGraphClient(config = {}) {
         /**
          * Analyze graph structure for a topic.
          */
-        async analyze(query = {}) {
+        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,
+                    topicId: typeof normalized.topicId === "string"
+                        ? normalized.topicId
+                        : undefined,
+                    metric: typeof normalized.metric === "string"
+                        ? normalized.metric
+                        : undefined,
                     limit: typeof normalized.limit === "number" ? normalized.limit : undefined,
                 })}`,
             });
@@ -161,11 +178,13 @@ export function createGraphClient(config = {}) {
         /**
          * Detect confirmation-bias patterns for a topic graph.
          */
-        async bias(query = {}) {
+        bias(query = {}) {
             const normalized = normalizeTopicQuery(query);
             return gateway.request({
                 path: `/api/platform/v1/graph/bias${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
+                    topicId: typeof normalized.topicId === "string"
+                        ? normalized.topicId
+                        : undefined,
                     threshold: typeof normalized.threshold === "number"
                         ? normalized.threshold
                         : undefined,
@@ -176,11 +195,13 @@ export function createGraphClient(config = {}) {
         /**
          * Find graph gaps for beliefs that still need testing.
          */
-        async gaps(query) {
+        gaps(query) {
             const normalized = normalizeTopicQuery(query);
             return gateway.request({
                 path: `/api/platform/v1/graph/gaps${toQueryString({
-                    topicId: typeof normalized.topicId === "string" ? normalized.topicId : undefined,
+                    topicId: typeof normalized.topicId === "string"
+                        ? normalized.topicId
+                        : undefined,
                     minConfidence: typeof normalized.minConfidence === "number"
                         ? normalized.minConfidence
                         : undefined,
@@ -190,7 +211,7 @@ export function createGraphClient(config = {}) {
         /**
          * Search across graph resources within a topic.
          */
-        async search(query) {
+        search(query) {
             return gateway.request({
                 path: "/api/platform/v1/search",
                 method: "POST",
@@ -200,7 +221,7 @@ export function createGraphClient(config = {}) {
         /**
          * Retrieve the shortest known path between two graph nodes.
          */
-        async getPath(query) {
+        getPath(query) {
             return gateway.request({
                 path: `/api/platform/v1/graph/path${toQueryString(query)}`,
             });
@@ -208,7 +229,7 @@ export function createGraphClient(config = {}) {
         /**
          * Retrieve graph analytics for the requested metric.
          */
-        async getAnalytics(query = {}) {
+        getAnalytics(query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/graph/analytics${toQueryString(query)}`,
             });

package/dist/graphIntel.js

@@ -1,2 +1,4 @@
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
+// biome-ignore-all lint/performance/noBarrelFile: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the facade/barrel export is intentional.
 export * from "@lucern/reasoning-kernel/graphIntel";
 //# sourceMappingURL=graphIntel.js.map

package/dist/graphIntelligence.d.ts

@@ -1,4 +1,4 @@
-export * from "./graphIntel.js";
-export { fillGraphIntelligencePromptTemplate, getGraphIntelligenceQuery, GRAPH_INTELLIGENCE_MODE_TOOL_NAMES, GRAPH_INTELLIGENCE_PUBLIC_TOOL_NAMES, GRAPH_INTELLIGENCE_QUERIES, GRAPH_INTELLIGENCE_QUERIES_WITH_TOOLS, GRAPH_INTELLIGENCE_QUERY_CATALOG_VERSION, GRAPH_INTELLIGENCE_QUERY_CATEGORIES, GRAPH_INTELLIGENCE_QUERY_MODES, GRAPH_INTELLIGENCE_QUICK_QUERIES, isGraphIntelligenceQueryMode, listGraphIntelligenceQueries, } from "@lucern/contracts/graph-intelligence.contract";
 export type { GraphIntelligenceCatalogFilter, GraphIntelligencePublicToolName, GraphIntelligenceQueryCategory, GraphIntelligenceQueryDefinition, GraphIntelligenceQueryId, GraphIntelligenceQueryInputType, GraphIntelligenceQueryMode, GraphIntelligenceQueryWithTools, GraphIntelligenceQuickQuery, } from "@lucern/contracts/graph-intelligence.contract";
+export { fillGraphIntelligencePromptTemplate, GRAPH_INTELLIGENCE_MODE_TOOL_NAMES, GRAPH_INTELLIGENCE_PUBLIC_TOOL_NAMES, GRAPH_INTELLIGENCE_QUERIES, GRAPH_INTELLIGENCE_QUERIES_WITH_TOOLS, GRAPH_INTELLIGENCE_QUERY_CATALOG_VERSION, GRAPH_INTELLIGENCE_QUERY_CATEGORIES, GRAPH_INTELLIGENCE_QUERY_MODES, GRAPH_INTELLIGENCE_QUICK_QUERIES, getGraphIntelligenceQuery, isGraphIntelligenceQueryMode, listGraphIntelligenceQueries, } from "@lucern/contracts/graph-intelligence.contract";
+export * from "./graphIntel.js";
 //# sourceMappingURL=graphIntelligence.d.ts.map

package/dist/graphIntelligence.js

@@ -1,3 +1,3 @@
+export { fillGraphIntelligencePromptTemplate, GRAPH_INTELLIGENCE_MODE_TOOL_NAMES, GRAPH_INTELLIGENCE_PUBLIC_TOOL_NAMES, GRAPH_INTELLIGENCE_QUERIES, GRAPH_INTELLIGENCE_QUERIES_WITH_TOOLS, GRAPH_INTELLIGENCE_QUERY_CATALOG_VERSION, GRAPH_INTELLIGENCE_QUERY_CATEGORIES, GRAPH_INTELLIGENCE_QUERY_MODES, GRAPH_INTELLIGENCE_QUICK_QUERIES, getGraphIntelligenceQuery, isGraphIntelligenceQueryMode, listGraphIntelligenceQueries, } from "@lucern/contracts/graph-intelligence.contract";
 export * from "./graphIntel.js";
-export { fillGraphIntelligencePromptTemplate, getGraphIntelligenceQuery, GRAPH_INTELLIGENCE_MODE_TOOL_NAMES, GRAPH_INTELLIGENCE_PUBLIC_TOOL_NAMES, GRAPH_INTELLIGENCE_QUERIES, GRAPH_INTELLIGENCE_QUERIES_WITH_TOOLS, GRAPH_INTELLIGENCE_QUERY_CATALOG_VERSION, GRAPH_INTELLIGENCE_QUERY_CATEGORIES, GRAPH_INTELLIGENCE_QUERY_MODES, GRAPH_INTELLIGENCE_QUICK_QUERIES, isGraphIntelligenceQueryMode, listGraphIntelligenceQueries, } from "@lucern/contracts/graph-intelligence.contract";
 //# sourceMappingURL=graphIntelligence.js.map

package/dist/graphRecommendationsClient.d.ts

@@ -4,45 +4,45 @@ export type GraphRecommendationsClientConfig = GatewayClientConfig;
 export declare const GRAPH_RECOMMENDATION_FIELDS: readonly ["topicId", "projectId", "workspaceId", "limit", "cursor", "status", "findingId", "actionType", "targetNodeIds", "priority", "rationale", "healthScore", "metadata"];
 export type GraphRecommendationStatus = "open" | "accepted" | "dismissed" | "applied" | "superseded";
 export type GraphRecommendationPriority = "P0" | "P1" | "P2" | "P3" | "critical" | "high" | "medium" | "low";
-export type GraphRecommendationRecord = {
-    recommendationId: string;
-    topicId?: string;
-    workspaceId?: string;
-    findingId?: string;
+export interface GraphRecommendationRecord {
     actionType: string;
-    targetNodeIds?: string[];
+    createdAt?: number;
+    findingId?: string;
+    healthScore?: number;
+    metadata?: JsonObject | null;
     priority?: GraphRecommendationPriority | string;
     rationale?: string;
-    healthScore?: number;
+    recommendationId: string;
     status?: GraphRecommendationStatus;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-};
-export type GraphRecommendationListInput = {
+    targetNodeIds?: string[];
     topicId?: string;
-    /** @deprecated Use topicId. */
-    projectId?: string;
+    updatedAt?: number;
     workspaceId?: string;
-    limit?: number;
+}
+export interface GraphRecommendationListInput {
+    actionType?: string;
     cursor?: string;
-    status?: GraphRecommendationStatus;
     findingId?: string;
-    actionType?: string;
+    healthScore?: number;
+    limit?: number;
+    metadata?: JsonObject;
     priority?: GraphRecommendationPriority | string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+    status?: GraphRecommendationStatus;
     targetNodeIds?: string[];
-    healthScore?: number;
+    topicId?: string;
+    workspaceId?: string;
+}
+export interface MarkGraphRecommendationStatusInput {
     metadata?: JsonObject;
-};
-export type MarkGraphRecommendationStatusInput = {
+    rationale?: string;
     recommendationId: string;
     status: GraphRecommendationStatus;
-    rationale?: string;
-    metadata?: JsonObject;
-};
+}
 export type GraphRecommendationListResponse = ListResult<GraphRecommendationRecord, "recommendations">;
 export declare function createGraphRecommendationsClient(config?: GraphRecommendationsClientConfig): {
-    listForTopic(input: GraphRecommendationListInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<any, "recommendations">>>;
+    listForTopic(input: GraphRecommendationListInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<GraphRecommendationRecord, "recommendations">>>;
     getRecommendation(recommendationId: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphRecommendationRecord>>;
     markRecommendationStatus(input: MarkGraphRecommendationStatusInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphRecommendationRecord>>;
 };

package/dist/graphRecommendationsClient.js

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
 import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { createListResult, mapGatewayData } from "./sdkSurface.js";
 export const GRAPH_RECOMMENDATION_FIELDS = [
@@ -49,16 +50,20 @@ function listQuery(input) {
 }
 export function createGraphRecommendationsClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
+    function recommendationRows(data) {
+        const record = data;
+        if (Array.isArray(record.recommendations)) {
+            return record.recommendations;
+        }
+        return Array.isArray(data) ? data : [];
+    }
     return {
         listForTopic(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph-recommendations${toQueryString(listQuery(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data.recommendations)
-                ? data
-                    .recommendations
-                : Array.isArray(data)
-                    ? data
-                    : [], "recommendations")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(recommendationRows(data), "recommendations")));
         },
         getRecommendation(recommendationId) {
             return gateway.request({

package/dist/graphStateClassifierClient.d.ts

@@ -1,26 +1,26 @@
+import { type TopicProjectAliasInput } from "./boundary-client-surface";
 import { type GatewayClientConfig } from "./coreClient";
-import { type TopicProjectAliasInput } from "./boundaryClientSurface";
 import type { JsonObject, ListResult } from "./types";
 export type GraphStateClassifierClientConfig = GatewayClientConfig;
 export declare const GRAPH_STATE_CLASSIFIER_FIELDS: readonly ["topicId", "projectId", "workspaceId", "nodeId", "epistemicStatus", "beliefMaturity", "answerQuality", "evidenceNetwork", "logicalRole", "questionPriority", "layer", "modelVersion", "limit", "cursor", "metadata"];
-export type GraphStateClassification = {
+export interface GraphStateClassification {
+    answerQuality?: string;
+    beliefMaturity?: string;
     classificationId?: string;
-    topicId: string;
-    workspaceId?: string;
-    nodeId?: string;
+    confidence?: number;
+    createdAt?: number;
     epistemicStatus?: string;
-    beliefMaturity?: string;
-    answerQuality?: string;
     evidenceNetwork?: string;
-    logicalRole?: string;
-    questionPriority?: string;
     layer?: string;
-    modelVersion?: string;
-    confidence?: number;
+    logicalRole?: string;
     metadata?: JsonObject | null;
-    createdAt?: number;
+    modelVersion?: string;
+    nodeId?: string;
+    questionPriority?: string;
+    topicId: string;
     updatedAt?: number;
-};
+    workspaceId?: string;
+}
 export type ClassifyNodeInput = TopicProjectAliasInput & {
     workspaceId: string;
     nodeId: string;

package/dist/graphStateClassifierClient.js

@@ -1,5 +1,6 @@
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
+import { cleanRequiredString, listResultFromEnvelope, requireTopicId, topicPayload, } from "./boundary-client-surface.js";
 import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { cleanRequiredString, listResultFromEnvelope, requireTopicId, topicPayload, } from "./boundaryClientSurface.js";
 import { mapGatewayData } from "./sdkSurface.js";
 export const GRAPH_STATE_CLASSIFIER_FIELDS = [
     "topicId",
@@ -38,15 +39,18 @@ export function createGraphStateClassifierClient(config = {}) {
         },
         classifyTopic(input, idempotencyKey) {
             cleanRequiredString(input.workspaceId, "workspaceId");
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/graph-state-classifier/classify-topic",
                 method: "POST",
                 body: topicPayload(input, GRAPH_STATE_CLASSIFIER_FIELDS, "graphStateClassifier.classifyTopic"),
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "classifications")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "classifications")));
         },
         listClassifications(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph-state-classifier/classifications${toQueryString({
                     topicId: requireTopicId(input),
                     workspaceId: input.workspaceId,
@@ -57,7 +61,8 @@ export function createGraphStateClassifierClient(config = {}) {
                     limit: input.limit,
                     cursor: input.cursor,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "classifications")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "classifications")));
         },
         recordClassification(input, idempotencyKey) {
             return gateway.request({

package/dist/harnessClient.d.ts

@@ -1,23 +1,23 @@
 import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
 import type { JsonObject, JsonValue, TopicIdentifierInput } from "./types";
-export { LucernApiError };
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+export { LucernApiError };
 /** Configuration for the harness client. Inherits gateway transport settings. */
 export type HarnessClientConfig = GatewayClientConfig;
-export type HarnessAgentGuardrails = {
+export interface HarnessAgentGuardrails {
+    allowedOrigins?: string[];
+    allowNetworkEgress?: boolean;
+    heartbeatIntervalMs?: number;
     isolationMode?: "direct" | "sandbox";
     maxExecutionMs?: number;
-    heartbeatIntervalMs?: number;
     maxToolCalls?: number;
-    allowNetworkEgress?: boolean;
-    allowedOrigins?: string[];
-};
-export type HarnessAgentRuntimeConfig = {
-    entryPoint?: string;
+}
+export interface HarnessAgentRuntimeConfig {
+    auditMode?: "harness" | "master_control";
     callbackUrl?: string;
+    entryPoint?: string;
     modelRouting?: "model_machine" | "tenant_proxy" | "bring_your_own";
-    auditMode?: "harness" | "master_control";
-};
+}
 /** Input for creating or updating an agent definition in the harness registry. */
 export type HarnessAgentWriteInput = GatewayScope & {
     agentDefinitionId?: string;
@@ -78,29 +78,7 @@ export type HarnessExecuteToolInput = GatewayScope & {
     version?: string;
     transportKind?: string;
 };
-export type HarnessExecuteToolResult = {
-    tool: {
-        toolId: string;
-        toolName: string;
-        version: string;
-        status: "active" | "deprecated" | "disabled";
-        executionAdapter: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
-        gateClassification: "core" | "shimmed";
-        scopeRequirements: string[];
-        safetyMetadata: {
-            readOnly: boolean;
-            idempotent: boolean;
-            sideEffectLevel: "none" | "low" | "high";
-        };
-    };
-    execution: {
-        input: JsonObject;
-        transportKind: string;
-        startedAt: number;
-        completedAt: number;
-        durationMs: number;
-    };
-    envelope: JsonObject | null;
+export interface HarnessExecuteToolResult {
     audit: {
         toolName: string;
         contractName: string;
@@ -115,12 +93,34 @@ export type HarnessExecuteToolResult = {
         policyTraceId?: string | null;
         invariant?: string | null;
     } | null;
+    envelope: JsonObject | null;
+    execution: {
+        input: JsonObject;
+        transportKind: string;
+        startedAt: number;
+        completedAt: number;
+        durationMs: number;
+    };
     output: {
         isError: boolean;
         parsed: JsonValue;
         raw: JsonValue;
     };
-};
+    tool: {
+        toolId: string;
+        toolName: string;
+        version: string;
+        status: "active" | "deprecated" | "disabled";
+        executionAdapter: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+        gateClassification: "core" | "shimmed";
+        scopeRequirements: string[];
+        safetyMetadata: {
+            readOnly: boolean;
+            idempotent: boolean;
+            sideEffectLevel: "none" | "low" | "high";
+        };
+    };
+}
 /** Input for starting a new harness run (agent execution session). */
 export type HarnessStartRunInput = GatewayScope & {
     agentDefinitionId: string;
@@ -139,46 +139,46 @@ export type HarnessInvokeManagedAgentInput = GatewayScope & {
     metadata?: JsonObject;
 };
 /** Input for reporting a ledger event (tool call, prompt resolution, or policy decision) within a run. */
-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;
+export interface HarnessRunReportInput {
     completedAt?: number;
-    input?: JsonObject;
-    result?: JsonValue;
-    promptKey?: string;
-    promptVersion?: string;
     decision?: string;
-    reasonCode?: string;
-    latencyMs?: number;
+    durationMs?: number;
     error?: string | {
         code?: string;
         message: string;
         details?: JsonValue;
     };
-};
-/** Input for completing a harness run with a terminal status. */
-export type HarnessCompleteRunInput = {
+    executionAdapter?: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed";
+    input?: JsonObject;
+    inputHash?: string;
+    latencyMs?: number;
+    metadata?: JsonObject;
+    outputHash?: string;
+    policyDecisionId?: string;
+    policyReasonCode?: string;
+    policyResult?: "allowed" | "denied";
+    promptKey?: string;
+    promptVersion?: string;
+    reasonCode?: string;
     reportingToken: string;
-    status: "completed" | "failed" | "timeout";
+    requiredScopes?: string[];
+    result?: JsonValue;
+    startedAt?: number;
+    success?: boolean;
+    toolCallId?: string;
+    toolName?: string;
+    type: "tool_call" | "prompt_resolution" | "policy_decision";
+}
+/** Input for completing a harness run with a terminal status. */
+export interface HarnessCompleteRunInput {
     error?: {
         category: "policy_denied" | "tool_execution" | "prompt_resolution" | "model_error" | "timeout" | "heartbeat_timeout" | "input_validation" | "internal" | "external_service";
         message: string;
         code?: string;
     };
-};
+    reportingToken: string;
+    status: "completed" | "failed" | "timeout";
+}
 /**
  * Create the harness client for agent and tool registry operations.
  */