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

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

@@ -0,0 +1,219 @@
+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/{packages/sdk/src → lib/platform/sdk}/identityClient.d.ts

@@ -1,19 +1,45 @@
-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";
+import { type GatewayClientConfig, type GatewayScope, type PlatformGatewaySuccess, LucernApiError } from "./coreClient";
+import type { JsonObject, SdkPrincipalContext } from "./types";
+/** Summary of the currently authenticated principal and their scopes. */
+export type IdentitySummary = SdkPrincipalContext;
+/** Gateway response wrapping an identity summary payload. */
+export type IdentityWhoamiResponse = PlatformGatewaySuccess<IdentitySummary>;
 export { LucernApiError };
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
+/** Configuration for the identity client. */
 export type IdentityClientConfig = GatewayClientConfig;
-export type { IdentityWhoamiResponse };
+export type ClerkUserSearchResult = {
+    clerkId: string;
+    email: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    displayName: string | null;
+    imageUrl: string | null;
+};
 /**
  * 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 declare function createIdentityClient(config?: IdentityClientConfig): {
     /**
      * Resolve the current authenticated identity summary.
      */
-    whoami(): Promise<IdentityWhoamiResponse>;
+    whoami(): Promise<PlatformGatewaySuccess<{
+        principalId: string;
+        principalType: "user" | "human" | "service" | "group" | "external_viewer" | "agent";
+        tenantId: string | null;
+        workspaceId: string | null;
+        scopes: string[];
+        roles: string[];
+        isPlatformAdmin: boolean;
+        isTenantAdmin: boolean;
+        isWorkspaceAdmin: boolean;
+        authMode: string | undefined;
+        sessionId: string | undefined;
+        delegatedBy: string | undefined;
+        expiresAt: number | undefined;
+    }>>;
     /**
      * List principals in the current identity scope.
      */
@@ -22,7 +48,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         principalType?: string;
         query?: string;
         limit?: number;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "principals">>>;
+    }): Promise<PlatformGatewaySuccess<import("./types").ListResult<any, "principals">>>;
     /**
      * Create a principal.
      */
@@ -34,7 +60,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         displayName?: string;
         status?: "active" | "disabled" | "revoked";
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * Update a principal.
      */
@@ -46,7 +72,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         displayName?: string;
         status?: "active" | "disabled" | "revoked";
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * @deprecated Use createPrincipal or updatePrincipal.
      */
@@ -58,7 +84,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         displayName?: string;
         status?: "active" | "disabled" | "revoked";
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * List keys in the current identity scope.
      */
@@ -66,7 +92,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         principalId?: string;
         status?: string;
         limit?: number;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "keys">>>;
+    }): Promise<PlatformGatewaySuccess<import("./types").ListResult<any, "keys">>>;
     /**
      * Create an API key.
      */
@@ -79,7 +105,7 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         expiresInDays?: number;
         rateLimitTier?: "free" | "developer" | "partner";
         metadata?: JsonObject;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * Rotate an API key.
      */
@@ -88,17 +114,21 @@ export declare function createIdentityClient(config?: IdentityClientConfig): {
         replacementToken?: string;
         replacementExpiresInDays?: number;
         gracePeriodHours?: number;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * Delete an API key by revoking it.
      */
     deleteKey(keyId: string, input?: {
         reason?: string;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
     /**
      * @deprecated Use deleteKey.
      */
     revokeKey(keyId: string, input?: {
         reason?: string;
-    }, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<unknown>>;
+    /**
+     * Search Clerk users by email or display attributes.
+     */
+    searchClerkUsers(q: string): Promise<PlatformGatewaySuccess<ClerkUserSearchResult[]>>;
 };

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

@@ -0,0 +1,131 @@
+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/{packages/sdk/src → lib/platform/sdk}/index.d.ts

@@ -1,27 +1,48 @@
+/**
+ * @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 "./contracts/api-enums.contract";
-export * from "@lucern/contracts/mcp-tools.contract";
-export * from "@lucern/contracts/workflow-runtime.contract";
+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";

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

@@ -0,0 +1,49 @@
+/**
+ * @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";

package/dist/{packages/sdk/src → lib/platform/sdk}/learningClient.d.ts

@@ -1,8 +1,11 @@
 import { type GatewayClientConfig } from "./coreClient";
 import type { TopicIdentifierInput } from "./types";
+/** Configuration for the learning client. */
 export type LearningClientConfig = GatewayClientConfig;
 /**
  * Create the learning client for execution telemetry reads.
+ * @param config - Gateway transport configuration.
+ * @returns An object with methods to list executions and retrieve stats.
  */
 export declare function createLearningClient(config?: LearningClientConfig): {
     /**

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

@@ -0,0 +1,53 @@
+import { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
+import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurface.js";
+/**
+ * Create the learning client for execution telemetry reads.
+ * @param config - Gateway transport configuration.
+ * @returns An object with methods to list executions and retrieve stats.
+ */
+export function createLearningClient(config = {}) {
+    const gateway = createGatewayRequestClient(config);
+    return {
+        /**
+         * List recent execution records.
+         */
+        async listRecentExecutions(args = {}) {
+            return gateway.request({
+                path: `/api/platform/v1/learning/executions/recent${toQueryString({
+                    ...normalizeTopicQuery(args),
+                    namespace: args.namespace,
+                    audienceMode: args.audienceMode,
+                    success: typeof args.success === "boolean"
+                        ? args.success
+                            ? "true"
+                            : "false"
+                        : undefined,
+                    limit: typeof args.limit === "number" && Number.isFinite(args.limit)
+                        ? String(args.limit)
+                        : undefined,
+                })}`,
+            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "executions")));
+        },
+        /**
+         * @deprecated Use listRecentExecutions.
+         */
+        async getRecentExecutions(args = {}) {
+            return this.listRecentExecutions(args);
+        },
+        /**
+         * Get aggregate execution statistics.
+         */
+        async getExecutionStats(args = {}) {
+            return gateway.request({
+                path: `/api/platform/v1/learning/executions/stats${toQueryString({
+                    ...normalizeTopicQuery(args),
+                    namespace: args.namespace,
+                    audienceMode: args.audienceMode,
+                    hours: typeof args.hours === "number" && Number.isFinite(args.hours)
+                        ? String(args.hours)
+                        : undefined,
+                })}`,
+            });
+        },
+    };
+}

package/dist/{packages/sdk/src → lib/platform/sdk}/mcpParityClient.d.ts

@@ -1,5 +1,6 @@
 import { type GatewayClientConfig, type PlatformGatewaySuccess } from "./coreClient";
 import type { JsonObject } from "./types";
+/** Configuration for the MCP parity client. Inherits gateway transport settings. */
 export type McpParityClientConfig = GatewayClientConfig;
 type ToolArgs = JsonObject;
 type ToolResult<T = unknown> = Promise<PlatformGatewaySuccess<T>>;