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

package/dist/gatewayFacades.js

@@ -0,0 +1,1953 @@
+// src/coreClient.ts
+var LucernApiError = class extends Error {
+  code;
+  status;
+  invariant;
+  suggestion;
+  details;
+  requestId;
+  correlationId;
+  policyTraceId;
+  constructor(args) {
+    super(args.message);
+    this.name = "LucernApiError";
+    this.code = args.code;
+    this.status = args.status;
+    this.invariant = args.invariant;
+    this.suggestion = args.suggestion;
+    this.details = args.details;
+    this.requestId = args.requestId;
+    this.correlationId = args.correlationId;
+    this.policyTraceId = args.policyTraceId;
+  }
+};
+function toQueryString(scope) {
+  const params = new URLSearchParams();
+  if (scope.tenantId) {
+    params.set("tenantId", scope.tenantId);
+  }
+  if (scope.workspaceId) {
+    params.set("workspaceId", scope.workspaceId);
+  }
+  for (const [key, value] of Object.entries(scope)) {
+    if (key === "tenantId" || key === "workspaceId") {
+      continue;
+    }
+    if (value === void 0) {
+      continue;
+    }
+    params.set(key, String(value));
+  }
+  const serialized = params.toString();
+  return serialized.length > 0 ? `?${serialized}` : "";
+}
+function fillRandomBytes(length) {
+  const bytes = new Uint8Array(length);
+  if (typeof globalThis.crypto?.getRandomValues === "function") {
+    globalThis.crypto.getRandomValues(bytes);
+    return bytes;
+  }
+  for (let index = 0; index < length; index += 1) {
+    bytes[index] = Math.floor(Math.random() * 256);
+  }
+  return bytes;
+}
+function generatePortableRequestId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  const bytes = fillRandomBytes(16);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (value) => value.toString(16).padStart(2, "0"));
+  return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(
+    6,
+    8
+  ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
+}
+function randomIdempotencyKey() {
+  return generatePortableRequestId();
+}
+function isRetryableStatus(status) {
+  return status >= 500 || status === 408 || status === 429;
+}
+function fallbackErrorCode(status) {
+  if (status === 401) {
+    return "AUTHENTICATION_REQUIRED";
+  }
+  if (status === 403) {
+    return "FORBIDDEN";
+  }
+  if (status === 404) {
+    return "NOT_FOUND";
+  }
+  if (status === 408) {
+    return "UPSTREAM_ERROR";
+  }
+  if (status === 409) {
+    return "CONFLICT";
+  }
+  if (status === 429) {
+    return "RATE_LIMIT_EXCEEDED";
+  }
+  if (status >= 500) {
+    return "UPSTREAM_ERROR";
+  }
+  return "INTERNAL_ERROR";
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function parseRetryAfterMs(value) {
+  if (!value) {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  const numeric = Number(trimmed);
+  if (Number.isFinite(numeric)) {
+    return Math.max(0, Math.round(numeric * 1e3));
+  }
+  const parsedDate = Date.parse(trimmed);
+  if (Number.isFinite(parsedDate)) {
+    return Math.max(0, parsedDate - Date.now());
+  }
+  return null;
+}
+function computeRetryDelayMs(args) {
+  const baseDelay = args.status === 429 ? Math.max(
+    args.retryAfterMs ?? 0,
+    Math.min(1e3 * 2 ** args.attempt, 1e4)
+  ) : Math.min(1e3 * 2 ** args.attempt, 4e3);
+  if (args.status !== 429) {
+    return baseDelay;
+  }
+  const jitterWindow = Math.max(250, Math.round(baseDelay * 0.25));
+  return baseDelay + Math.round(Math.random() * jitterWindow);
+}
+function timeoutError(timeoutMs) {
+  const error = new Error(`Request timed out after ${timeoutMs}ms`);
+  error.name = "AbortError";
+  return error;
+}
+function readPolicySummaryFromDetails(details) {
+  if (!details || typeof details !== "object" || Array.isArray(details)) {
+    return null;
+  }
+  const directSummary = details.summary;
+  if (typeof directSummary === "string" && directSummary.trim().length > 0) {
+    return directSummary.trim();
+  }
+  const policy = details.policy;
+  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
+    return null;
+  }
+  const explanation = policy.explanation;
+  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
+    return null;
+  }
+  const nestedSummary = explanation.summary;
+  if (typeof nestedSummary === "string" && nestedSummary.trim().length > 0) {
+    return nestedSummary.trim();
+  }
+  return null;
+}
+function createGatewayRequestClient(config = {}) {
+  const fetchImpl = config.fetchImpl ?? fetch;
+  const baseUrl = config.baseUrl?.replace(/\/+$/, "") ?? "";
+  const maxRetries = config.maxRetries ?? 2;
+  const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
+  async function resolveAuthHeaders() {
+    if (!config.getAuthHeaders) {
+      return {};
+    }
+    return await config.getAuthHeaders();
+  }
+  async function fetchWithTimeout(url, init, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      return await fetchImpl(url, { ...init, signal: controller.signal });
+    } catch (error) {
+      if (controller.signal.aborted) {
+        throw timeoutError(timeoutMs);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async function parsePayload(response) {
+    const text = await response.text();
+    if (!text) {
+      return null;
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      return null;
+    }
+  }
+  function resolveTimeoutMs(method, requestTimeoutMs) {
+    if (typeof requestTimeoutMs === "number") {
+      return requestTimeoutMs;
+    }
+    const methodTimeoutMs = config.timeoutMsByMethod?.[method];
+    if (typeof methodTimeoutMs === "number") {
+      return methodTimeoutMs;
+    }
+    return config.timeoutMs ?? 15e3;
+  }
+  function buildApiError(args) {
+    const failure = args.failure;
+    const legacyError = failure && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
+    const correlationId = failure?.correlationId ?? args.response.headers.get("x-lucern-correlation-id")?.trim() ?? args.requestId;
+    const policyTraceId = failure?.policyTraceId ?? args.response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null;
+    const details = failure?.details ?? legacyError?.details;
+    const policySummary = readPolicySummaryFromDetails(details);
+    return new LucernApiError({
+      code: failure?.code ?? legacyError?.code ?? fallbackErrorCode(args.response.status),
+      message: policySummary ?? (typeof failure?.error === "string" ? failure.error : legacyError?.message ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed.")),
+      status: args.response.status,
+      invariant: failure?.invariant,
+      suggestion: failure?.suggestion,
+      details,
+      requestId: args.requestId,
+      correlationId,
+      policyTraceId
+    });
+  }
+  async function request(args) {
+    const authHeaders = await resolveAuthHeaders();
+    const method = args.method ?? "GET";
+    const timeoutMs = resolveTimeoutMs(method, args.timeoutMs);
+    const headers = new Headers({
+      "content-type": "application/json",
+      ...authHeaders
+    });
+    if (args.idempotencyKey) {
+      headers.set("idempotency-key", args.idempotencyKey);
+    }
+    const requestId = headers.get("x-correlation-id")?.trim() || headers.get("x-request-id")?.trim() || args.requestId || requestIdFactory();
+    if (!headers.has("x-correlation-id") && !headers.has("x-request-id")) {
+      headers.set("x-correlation-id", requestId);
+    }
+    const url = `${baseUrl}${args.path}`;
+    const serializedBody = args.body ? JSON.stringify(args.body) : void 0;
+    const init = {
+      method,
+      headers,
+      body: serializedBody
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      const hookRequestContext = {
+        requestId,
+        attempt,
+        maxRetries,
+        method,
+        path: args.path,
+        url,
+        headers: new Headers(headers),
+        body: serializedBody,
+        timeoutMs
+      };
+      await config.onRequest?.(hookRequestContext);
+      const startedAt = Date.now();
+      try {
+        const response = await fetchWithTimeout(url, init, timeoutMs);
+        const responseClone = response.clone();
+        const payload = await parsePayload(response);
+        const retryAfterMs = parseRetryAfterMs(
+          response.headers.get("Retry-After")
+        );
+        if (!response.ok || !payload?.success) {
+          const failure = payload && !payload.success ? payload : null;
+          const apiError = buildApiError({
+            requestId,
+            response,
+            failure
+          });
+          const willRetry = attempt < maxRetries && isRetryableStatus(response.status);
+          await config.onResponse?.({
+            ...hookRequestContext,
+            durationMs: Date.now() - startedAt,
+            status: response.status,
+            response: responseClone,
+            error: apiError,
+            correlationId: apiError.correlationId ?? requestId,
+            policyTraceId: apiError.policyTraceId ?? null,
+            retryAfterMs,
+            willRetry
+          });
+          if (willRetry) {
+            lastError = apiError;
+            await delay(
+              computeRetryDelayMs({
+                attempt,
+                status: response.status,
+                retryAfterMs
+              })
+            );
+            continue;
+          }
+          throw apiError;
+        }
+        const successPayload = payload;
+        await config.onResponse?.({
+          ...hookRequestContext,
+          durationMs: Date.now() - startedAt,
+          status: response.status,
+          response: responseClone,
+          correlationId: successPayload.correlationId ?? response.headers.get("x-lucern-correlation-id")?.trim() ?? requestId,
+          policyTraceId: successPayload.policyTraceId ?? response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null,
+          idempotentReplay: successPayload.idempotentReplay,
+          retryAfterMs,
+          willRetry: false
+        });
+        return successPayload;
+      } catch (fetchError) {
+        if (fetchError instanceof LucernApiError) {
+          throw fetchError;
+        }
+        const willRetry = attempt < maxRetries;
+        await config.onResponse?.({
+          ...hookRequestContext,
+          durationMs: Date.now() - startedAt,
+          error: fetchError,
+          correlationId: requestId,
+          policyTraceId: null,
+          willRetry
+        });
+        lastError = fetchError;
+        if (willRetry) {
+          await delay(computeRetryDelayMs({ attempt }));
+        }
+      }
+    }
+    throw lastError instanceof Error ? lastError : new Error("Platform API request failed after retries.");
+  }
+  return {
+    request
+  };
+}
+
+// src/sdkSurface.ts
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function cleanString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function normalizeVerificationStatus(value) {
+  const status = cleanString(value);
+  if (!status) {
+    return void 0;
+  }
+  if (status === "verified") {
+    return "human_verified";
+  }
+  if (status === "rejected") {
+    return "contradicted";
+  }
+  return status;
+}
+function cloneWith(value, patch) {
+  return { ...value, ...patch };
+}
+function resolveTopicId(value) {
+  return cleanString(value.topicId);
+}
+function resolveText(value) {
+  return cleanString(value.text) ?? cleanString(value.canonicalText);
+}
+function withTopicAlias(value) {
+  const topicId = cleanString(value.topicId) ?? void 0;
+  if (!topicId) {
+    return value;
+  }
+  return cloneWith(value, { topicId });
+}
+function withTextAlias(value) {
+  const text = cleanString(value.text) ?? cleanString(value.canonicalText) ?? void 0;
+  if (!text) {
+    return value;
+  }
+  return cloneWith(value, { text, canonicalText: text });
+}
+function withSdkAliases(value) {
+  return withTopicAlias(withTextAlias(value));
+}
+function normalizeNodeWriteInput(value) {
+  const topicId = resolveTopicId(value);
+  const text = resolveText(value);
+  const verificationStatus = normalizeVerificationStatus(value.verificationStatus);
+  const next = { ...value };
+  if (topicId) {
+    next.topicId = topicId;
+  }
+  if (text) {
+    next.text = text;
+    next.canonicalText = text;
+  }
+  if (verificationStatus) {
+    next.verificationStatus = verificationStatus;
+  }
+  return next;
+}
+function normalizeNodeVerificationStatus(value) {
+  return normalizeVerificationStatus(value);
+}
+function normalizeTopicQuery(value) {
+  const topicId = cleanString(value.topicId);
+  if (!topicId) {
+    return value;
+  }
+  return { ...value, topicId };
+}
+function asListItems(data, legacyKey) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+  const record = asRecord(data);
+  if (Array.isArray(record.items)) {
+    return record.items;
+  }
+  if (legacyKey && Array.isArray(record[legacyKey])) {
+    return record[legacyKey];
+  }
+  return [];
+}
+function createListResult(items, legacyKey) {
+  const result = {
+    items,
+    total: items.length
+  };
+  if (legacyKey) {
+    result[legacyKey] = items;
+  }
+  return result;
+}
+function mapGatewayData(response, mapper) {
+  return {
+    ...response,
+    data: mapper(response.data)
+  };
+}
+function mapAliasedList(data, legacyKey) {
+  const items = asListItems(data, legacyKey).map(
+    (item) => withSdkAliases(item)
+  );
+  return createListResult(items, legacyKey);
+}
+
+// src/ontologyClient.ts
+function createOntologyClient(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    /**
+     * List ontology definitions matching optional filters.
+     */
+    async list(filters = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies${toQueryString(filters)}`
+      }).then(
+        (response) => mapGatewayData(response, (data) => {
+          const record = data && typeof data === "object" && !Array.isArray(data) ? data : {};
+          const ontologies = Array.isArray(record.ontologies) ? record.ontologies : Array.isArray(record.definitions) ? record.definitions : Array.isArray(data) ? data : [];
+          const total = typeof record.total === "number" && Number.isFinite(record.total) ? record.total : ontologies.length;
+          return {
+            ...record,
+            ...createListResult(ontologies, "definitions"),
+            ontologies,
+            total
+          };
+        })
+      );
+    },
+    /**
+     * Get an ontology definition by identifier.
+     */
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`
+      });
+    },
+    /**
+     * Bind an ontology definition to a topic.
+     */
+    async bind(input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(input.ontologyId)}/bind`,
+        method: "POST",
+        body: {
+          topicId: input.topicId
+        },
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * List ontology definitions.
+     */
+    async listDefinitions(filters = {}) {
+      return this.list(filters);
+    },
+    /**
+     * Get an ontology definition.
+     */
+    async getDefinition(id) {
+      return this.get(id);
+    },
+    /**
+     * Create an ontology definition.
+     */
+    async createDefinition(input, idempotencyKey) {
+      return gateway.request({
+        path: "/api/platform/v1/ontologies",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * Update an ontology definition.
+     */
+    async updateDefinition(id, input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * Archive an ontology definition.
+     */
+    async archiveDefinition(id, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`,
+        method: "DELETE",
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * List versions for an ontology definition.
+     */
+    async listVersions(ontologyId, filters = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(ontologyId)}/versions${toQueryString(filters)}`
+      }).then(
+        (response) => mapGatewayData(
+          response,
+          (data) => createListResult(Array.isArray(data) ? data : [], "versions")
+        )
+      );
+    },
+    /**
+     * Create an ontology version.
+     */
+    async createVersion(ontologyId, input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(ontologyId)}/versions`,
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * Publish an ontology version.
+     */
+    async publishVersion(ontologyId, versionId, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(ontologyId)}/versions/${encodeURIComponent(versionId)}/publish`,
+        method: "POST",
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * Deprecate an ontology version.
+     */
+    async deprecateVersion(ontologyId, versionId, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(ontologyId)}/versions/${encodeURIComponent(versionId)}/deprecate`,
+        method: "POST",
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    /**
+     * List topics directly bound to a specific ontology definition.
+     * Uses the topics gateway with ontologyId filter.
+     */
+    async listTopics(ontologyId) {
+      return gateway.request({
+        path: `/api/platform/v1/topics?ontologyId=${encodeURIComponent(ontologyId)}`
+      }).then(
+        (response) => mapGatewayData(
+          response,
+          (data) => createListResult(Array.isArray(data) ? data : [], "topics")
+        )
+      );
+    },
+    /**
+     * @deprecated Use listTopics.
+     */
+    async listTopicsByOntology(ontologyId) {
+      return this.listTopics(ontologyId);
+    }
+  };
+}
+
+// src/graphClient.ts
+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 : void 0,
+          metric: typeof normalized.metric === "string" ? normalized.metric : void 0,
+          limit: typeof normalized.limit === "number" ? normalized.limit : void 0
+        })}`
+      });
+    },
+    /**
+     * 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 : void 0,
+          threshold: typeof normalized.threshold === "number" ? normalized.threshold : void 0,
+          limit: typeof normalized.limit === "number" ? normalized.limit : void 0
+        })}`
+      });
+    },
+    /**
+     * 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 : void 0,
+          minConfidence: typeof normalized.minConfidence === "number" ? normalized.minConfidence : void 0
+        })}`
+      });
+    },
+    /**
+     * 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)}`
+      });
+    }
+  };
+}
+
+// src/identityClient.ts
+function createIdentityWhoamiClient(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async whoami() {
+      return gateway.request({
+        path: "/api/platform/v1/identity/whoami"
+      });
+    }
+  };
+}
+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 })}`
+      });
+    }
+  };
+}
+
+// src/topicsClient.ts
+function asRecord2(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function cleanString2(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function normalizeTopicRecord(value) {
+  const record = asRecord2(value);
+  const topicId = cleanString2(record.topicId) ?? cleanString2(record.id) ?? cleanString2(record._id);
+  return withTopicAlias({
+    ...record,
+    ...topicId ? { topicId } : {}
+  });
+}
+function normalizeTopicTreeNode(value) {
+  return normalizeTopicRecord(value);
+}
+function createTopicsClient(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async list(query = {}) {
+      const topicId = resolveTopicId(query);
+      return gateway.request({
+        path: `/api/platform/v1/topics${toQueryString({
+          ...topicId ? { topicId } : {},
+          ontologyId: query.ontologyId,
+          parentTopicId: query.parentTopicId,
+          status: query.status,
+          type: query.type
+        })}`
+      }).then(
+        (response) => mapGatewayData(response, (data) => {
+          const record = asRecord2(data);
+          const items = Array.isArray(record.topics) ? record.topics.map(normalizeTopicRecord) : [];
+          return {
+            ...createListResult(items, "topics"),
+            ...record,
+            topics: items,
+            total: typeof record.total === "number" ? record.total : items.length
+          };
+        })
+      );
+    },
+    async get(topicId) {
+      return gateway.request({
+        path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`
+      }).then(
+        (response) => mapGatewayData(
+          response,
+          (data) => normalizeTopicRecord(asRecord2(data).topic ?? data)
+        )
+      );
+    },
+    async create(input, idempotencyKey) {
+      const topicId = resolveTopicId(input);
+      return gateway.request({
+        path: "/api/platform/v1/topics",
+        method: "POST",
+        body: {
+          ...input,
+          ...topicId ? { topicId } : {},
+          type: input.type ?? "theme"
+        },
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(
+        (response) => mapGatewayData(response, (data) => normalizeTopicRecord(data))
+      );
+    },
+    async update(topicId, input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(
+        (response) => mapGatewayData(response, (data) => normalizeTopicRecord(data))
+      );
+    },
+    async getTree(topicId, query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/tree${toQueryString(
+          query
+        )}`
+      }).then(
+        (response) => mapGatewayData(response, (data) => {
+          const record = asRecord2(data);
+          return {
+            tree: Array.isArray(record.tree) ? record.tree.map(normalizeTopicTreeNode) : []
+          };
+        })
+      );
+    },
+    async getCoverage(topicId, query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/coverage${toQueryString(
+          query
+        )}`
+      });
+    },
+    async remove(topicId, idempotencyKey) {
+      return gateway.request({
+        path: "/api/platform/v1/topics/remove",
+        method: "POST",
+        body: { id: topicId },
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    async bulkCreate(input, idempotencyKey) {
+      return gateway.request({
+        path: "/api/platform/v1/topics/bulk",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    }
+  };
+}
+
+// src/gatewayFacades.ts
+function serializeTypes(types) {
+  return Array.isArray(types) && types.length > 0 ? types.join(",") : void 0;
+}
+function createBeliefsFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}`
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs${toQueryString({
+          topicId: query.topicId,
+          status: query.status,
+          worktreeId: query.worktreeId,
+          minConfidence: query.minConfidence,
+          limit: query.limit,
+          cursor: query.cursor
+        })}`
+      });
+    },
+    async refine(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async fork(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/fork`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateConfidence(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/confidence`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateStatus(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/update-status",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateRationale(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/update-rationale",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async linkBeliefs(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/link",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async unlinkEvidence(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/unlink-evidence",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateCriticality(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/update-criticality",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async batchUpdateCriticality(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/batch-update-criticality",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async reassignTopic(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/beliefs/reassign-topic",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async archive(id, input = {}, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}`,
+        method: "DELETE",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async lineage(id) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/lineage`
+      });
+    },
+    async confidenceHistory(id) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/confidence-history`
+      });
+    },
+    async createContract(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/contracts`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async bisect(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/beliefs/${encodeURIComponent(id)}/bisect`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createContradictionsFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async flag(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/contradictions",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/contradictions${toQueryString({
+          topicId: query.topicId,
+          status: query.status,
+          limit: query.limit,
+          cursor: query.cursor
+        })}`
+      });
+    },
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/contradictions/${encodeURIComponent(id)}`
+      });
+    }
+  };
+}
+function createEdgesFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/edges${toQueryString({
+          sourceId: query.sourceId,
+          edgeType: query.edgeType,
+          limit: query.limit,
+          cursor: query.cursor
+        })}`
+      });
+    },
+    async traverse(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/traverse",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async update(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/update",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async remove(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/remove",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async removeBetween(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/remove-between",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async batchCreate(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/batch",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async delete(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/edges/delete",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createEvidenceFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/evidence/${encodeURIComponent(id)}`
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/evidence${toQueryString({
+          topicId: query.topicId,
+          targetId: query.targetId,
+          limit: query.limit,
+          cursor: query.cursor
+        })}`
+      });
+    },
+    async link(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/evidence/${encodeURIComponent(input.evidenceId)}/link`,
+        method: "POST",
+        body: {
+          targetId: input.targetId,
+          targetType: input.targetType,
+          weight: input.weight,
+          rationale: input.rationale
+        },
+        idempotencyKey
+      });
+    },
+    async search(query, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/search",
+        method: "POST",
+        body: query,
+        idempotencyKey
+      });
+    },
+    async updateStatus(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/update-status",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async update(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/update",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async flagIncorrect(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/flag-incorrect",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async remove(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/remove",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateVerificationStatus(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/evidence/update-verification-status",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createEventsFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async list(query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/events${toQueryString({
+          topicId: query.topicId,
+          after: query.after,
+          types: serializeTypes(query.types),
+          startTime: query.startTime,
+          endTime: query.endTime,
+          limit: query.limit
+        })}`
+      });
+    },
+    async replay(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/events/replay",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createGraphFacade(config = {}) {
+  const graphClient = createGraphClient(config);
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async neighborhood(input) {
+      return graphClient.neighborhood({
+        globalId: input.globalId,
+        globalIds: Array.isArray(input.globalIds) ? input.globalIds.join(",") : input.globalIds,
+        maxDepth: input.maxDepth
+      });
+    },
+    async traverse(input) {
+      return graphClient.traverse(input);
+    },
+    async analyze(input = {}) {
+      return graphClient.analyze(input);
+    },
+    async bias(input = {}) {
+      return graphClient.bias(input);
+    },
+    async gaps(input) {
+      return graphClient.gaps(input);
+    },
+    async falsify(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/graph/falsify",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createIdentityFacade(config = {}) {
+  const identityClient = createIdentityClient(config);
+  return {
+    async whoami() {
+      const response = await identityClient.whoami();
+      return Object.assign({}, response, response.data);
+    }
+  };
+}
+function createOntologiesFacade(config = {}) {
+  const ontologyClient = createOntologyClient(config);
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`
+      });
+    },
+    async list(query = {}) {
+      return ontologyClient.list(query);
+    },
+    async bind(input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/ontologies/${encodeURIComponent(input.ontologyId)}/bind`,
+        method: "POST",
+        body: {
+          topicId: input.topicId
+        },
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      });
+    },
+    async match(input, idempotencyKey) {
+      return gateway.request({
+        path: "/api/platform/v1/ontologies/match",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createQuestionsFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/questions/${encodeURIComponent(id)}`
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/questions${toQueryString({
+          topicId: query.topicId,
+          status: query.status,
+          priority: query.priority,
+          worktreeId: query.worktreeId,
+          limit: query.limit,
+          cursor: query.cursor
+        })}`
+      });
+    },
+    async answer(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/questions/${encodeURIComponent(id)}/answer`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async refine(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/questions/${encodeURIComponent(id)}/refine`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async archive(id, input = {}, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/questions/${encodeURIComponent(id)}`,
+        method: "DELETE",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateStatus(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/questions/${encodeURIComponent(id)}/status`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async batchCreate(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/batch",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async add(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/add",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updatePriority(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/update-priority",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async advanceToConviction(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/advance-to-conviction",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async updateConviction(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/update-conviction",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async finalizeConviction(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/finalize-conviction",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async update(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/update",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async delete(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/questions/delete",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+function createSearchFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async query(input) {
+      return gateway.request({
+        path: "/api/platform/v1/search",
+        method: "POST",
+        body: input
+      });
+    }
+  };
+}
+function createTasksFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/tasks",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async update(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/tasks/${encodeURIComponent(input.id)}`,
+        method: "PATCH",
+        body: {
+          title: input.title,
+          description: input.description,
+          priority: input.priority,
+          status: input.status,
+          linkedBeliefId: input.linkedBeliefId,
+          linkedQuestionId: input.linkedQuestionId,
+          linkedWorktreeId: input.linkedWorktreeId,
+          metadata: input.metadata
+        },
+        idempotencyKey
+      });
+    },
+    async complete(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/tasks/${encodeURIComponent(input.id)}/complete`,
+        method: "POST",
+        body: {
+          outputSummary: input.outputSummary
+        },
+        idempotencyKey
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/tasks${toQueryString({
+          topicId: query.topicId,
+          worktreeId: query.worktreeId,
+          status: query.status,
+          limit: query.limit
+        })}`
+      });
+    }
+  };
+}
+function createTopicsFacade(config = {}) {
+  const topicsClient = createTopicsClient(config);
+  return {
+    async create(input, idempotencyKey) {
+      return topicsClient.create(input, idempotencyKey);
+    },
+    async get(id) {
+      return topicsClient.get(id);
+    },
+    async list(query = {}) {
+      return topicsClient.list(query);
+    },
+    async update(input, idempotencyKey) {
+      const { id, ...rest } = input;
+      return topicsClient.update(id, rest, idempotencyKey);
+    },
+    async tree(input) {
+      return topicsClient.getTree(input.id, {
+        maxDepth: input.maxDepth
+      });
+    },
+    async coverage(input) {
+      return topicsClient.getCoverage(input.id, {
+        includeDescendants: input.includeDescendants,
+        maxDepth: input.maxDepth
+      });
+    },
+    async remove(id, idempotencyKey = randomIdempotencyKey()) {
+      return topicsClient.remove(id, idempotencyKey);
+    },
+    async bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
+      return topicsClient.bulkCreate(input, idempotencyKey);
+    }
+  };
+}
+function createWebhooksFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/webhooks",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async list(query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks${toQueryString({
+          topicId: query.topicId
+        })}`
+      });
+    },
+    async get(id) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`
+      });
+    },
+    async update(id, input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async delete(id, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`,
+        method: "DELETE",
+        idempotencyKey
+      });
+    },
+    async test(id, input = {}, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/test`,
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async deliveries(id, query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/deliveries${toQueryString({
+          limit: query.limit
+        })}`
+      });
+    },
+    async health(id) {
+      return gateway.request({
+        path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/health`
+      });
+    }
+  };
+}
+function createWorktreesFacade(config = {}) {
+  const gateway = createGatewayRequestClient(config);
+  return {
+    async create(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async list(query) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees${toQueryString({
+          topicId: query.topicId,
+          status: query.status,
+          limit: query.limit
+        })}`
+      });
+    },
+    async activate(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/activate`,
+        method: "POST",
+        body: {},
+        idempotencyKey
+      });
+    },
+    async update(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}`,
+        method: "PATCH",
+        body: {
+          objective: input.objective,
+          hypothesis: input.hypothesis,
+          rationale: input.rationale,
+          track: input.track,
+          trackPosition: input.trackPosition,
+          executionBand: input.executionBand,
+          executionOrder: input.executionOrder,
+          dependsOn: input.dependsOn,
+          blocks: input.blocks,
+          gate: input.gate,
+          status: input.status,
+          topicId: input.topicId,
+          additionalTopicIds: input.additionalTopicIds,
+          proofArtifacts: input.proofArtifacts,
+          staffingHint: input.staffingHint,
+          lastReconciledAt: input.lastReconciledAt,
+          autoFixPolicy: input.autoFixPolicy,
+          lensId: input.lensId
+        },
+        idempotencyKey
+      });
+    },
+    async merge(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/merge`,
+        method: "POST",
+        body: {
+          summary: input.summary,
+          outcomes: input.outcomes
+        },
+        idempotencyKey
+      });
+    },
+    async updateTargets(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/targets`,
+        method: "POST",
+        body: {
+          addBeliefIds: input.addBeliefIds,
+          addQuestionIds: input.addQuestionIds,
+          removeBeliefIds: input.removeBeliefIds,
+          removeQuestionIds: input.removeQuestionIds
+        },
+        idempotencyKey
+      });
+    },
+    async complete(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees/complete",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async advancePhase(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees/advance-phase",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async setPhase(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees/set-phase",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async patchState(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees/patch-state",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    },
+    async bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
+      return gateway.request({
+        path: "/api/platform/v1/worktrees/bulk",
+        method: "POST",
+        body: input,
+        idempotencyKey
+      });
+    }
+  };
+}
+
+export { createBeliefsFacade, createContradictionsFacade, createEdgesFacade, createEventsFacade, createEvidenceFacade, createGraphFacade, createIdentityFacade, createOntologiesFacade, createQuestionsFacade, createSearchFacade, createTasksFacade, createTopicsFacade, createWebhooksFacade, createWorktreesFacade };
+//# sourceMappingURL=gatewayFacades.js.map
+//# sourceMappingURL=gatewayFacades.js.map