@lucern/mcp 0.3.0-alpha.6 → 0.3.0-alpha.8

package/dist/hosted-route.js

@@ -370,6 +370,7 @@ __export(src_exports, {
   WORKTREE_PHASES: () => WORKTREE_PHASES,
   applyInfisicalRuntimeEnv: () => applyInfisicalRuntimeEnv,
   asListItems: () => asListItems,
+  asRecord: () => asRecord,
   assertValidWebhookSecret: () => assertValidWebhookSecret,
   assertValidWebhookUrl: () => assertValidWebhookUrl,
   buildDeprecatedBranchMetadata: () => buildDeprecatedBranchMetadata,
@@ -441,6 +442,7 @@ __export(src_exports, {
   isLensFilterCriteria: () => isLensFilterCriteria,
   isLucernPrompt: () => isLucernPrompt,
   isMcpToolAllowed: () => isMcpToolAllowed,
+  isRecord: () => isRecord2,
   isTaxonomyFilterCriteriaV1: () => isTaxonomyFilterCriteriaV1,
   lastDelegator: () => lastDelegator,
   listControlObjectOwnershipCases: () => listControlObjectOwnershipCases,
@@ -750,9 +752,7 @@ function generatePortableRequestId() {
     8
   ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
 }
-function randomIdempotencyKey() {
-  return generatePortableRequestId();
-}
+var randomIdempotencyKey = generatePortableRequestId;
 function isRetryableStatus(status) {
   return status >= 500 || status === 408 || status === 429;
 }
@@ -817,8 +817,11 @@ function timeoutError(timeoutMs) {
   error.name = "AbortError";
   return error;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function readPolicySummaryFromDetails(details) {
-  if (!details || typeof details !== "object" || Array.isArray(details)) {
+  if (!isRecord(details)) {
     return null;
   }
   const directSummary = details.summary;
@@ -826,11 +829,11 @@ function readPolicySummaryFromDetails(details) {
     return directSummary.trim();
   }
   const policy = details.policy;
-  if (!policy || typeof policy !== "object" || Array.isArray(policy)) {
+  if (!isRecord(policy)) {
     return null;
   }
   const explanation = policy.explanation;
-  if (!explanation || typeof explanation !== "object" || Array.isArray(explanation)) {
+  if (!isRecord(explanation)) {
     return null;
   }
   const nestedSummary = explanation.summary;
@@ -894,11 +897,11 @@ function createGatewayRequestClient(config = {}) {
     if (!text) {
       return null;
     }
-    try {
-      return JSON.parse(text);
-    } catch {
+    const parsed = tryParseGatewayEnvelopeJson(text);
+    if (!parsed.ok) {
       return null;
     }
+    return isRecord(parsed.value) ? parsed.value : null;
   }
   function resolveTimeoutMs(method, requestTimeoutMs) {
     if (typeof requestTimeoutMs === "number") {
@@ -910,16 +913,31 @@ function createGatewayRequestClient(config = {}) {
     }
     return config.timeoutMs ?? 15e3;
   }
+  function tryParseGatewayEnvelopeJson(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
+      return { ok: false, reason: "non-json" };
+    }
+    try {
+      return { ok: true, value: JSON.parse(trimmed) };
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        return { ok: false, reason: "invalid-json", error };
+      }
+      throw error;
+    }
+  }
   function buildApiError(args) {
     const failure = args.failure;
-    const legacyError = failure && typeof failure.error === "object" && failure.error !== null ? failure.error : failure?.legacyError;
+    const legacyError = failure && isRecord(failure.error) ? 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);
+    const failureMessage = typeof failure?.error === "string" ? failure.error : legacyError?.message;
     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.")),
+      message: policySummary ?? failureMessage ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed."),
       status: args.response.status,
       invariant: failure?.invariant,
       suggestion: failure?.suggestion,
@@ -1045,8 +1063,11 @@ function createGatewayRequestClient(config = {}) {
 }
 
 // ../sdk/src/sdkSurface.ts
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
+  return isRecord2(value) ? value : {};
 }
 function cleanString2(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
@@ -1107,9 +1128,7 @@ function normalizeNodeWriteInput(value) {
   }
   return next;
 }
-function normalizeNodeVerificationStatus(value) {
-  return normalizeVerificationStatus(value);
-}
+var normalizeNodeVerificationStatus = normalizeVerificationStatus;
 function normalizeTopicQuery(value) {
   const topicId = cleanString2(value.topicId);
   if (!topicId) {
@@ -1136,7 +1155,10 @@ function createListResult(items, legacyKey) {
     total: items.length
   };
   if (legacyKey) {
-    result[legacyKey] = items;
+    return {
+      ...result,
+      [legacyKey]: items
+    };
   }
   return result;
 }
@@ -1180,6 +1202,17 @@ function asTenantVaultSecretArray(data) {
 }
 function createAdminClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
+  const getControlObjectOwnership = async () => gateway.request({
+    path: "/api/platform/v1/admin/control-ownership"
+  });
+  const createMembership = async (input, idempotencyKey) => gateway.request({
+    path: "/api/platform/v1/memberships",
+    method: "POST",
+    body: input,
+    idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+  });
+  const updateMembership = createMembership;
+  const upsertMembership = createMembership;
   return {
     /**
      * List tenants visible to the current principal.
@@ -1211,19 +1244,11 @@ function createAdminClient(config = {}) {
     /**
      * Get the control-object ownership contract.
      */
-    async getControlObjectOwnership() {
-      return gateway.request({
-        path: "/api/platform/v1/admin/control-ownership"
-      });
-    },
+    getControlObjectOwnership,
     /**
      * @deprecated Use getControlObjectOwnership.
      */
-    async getControlObjectOwnershipContract() {
-      return gateway.request({
-        path: "/api/platform/v1/admin/control-ownership"
-      });
-    },
+    getControlObjectOwnershipContract: getControlObjectOwnership,
     /**
      * List workspaces for the current admin scope.
      */
@@ -1270,26 +1295,15 @@ function createAdminClient(config = {}) {
     /**
      * Create a membership.
      */
-    async createMembership(input, idempotencyKey) {
-      return gateway.request({
-        path: "/api/platform/v1/memberships",
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    createMembership,
     /**
      * Update a membership.
      */
-    async updateMembership(input, idempotencyKey) {
-      return this.createMembership(input, idempotencyKey);
-    },
+    updateMembership,
     /**
      * @deprecated Use createMembership or updateMembership.
      */
-    async upsertMembership(input, idempotencyKey) {
-      return this.createMembership(input, idempotencyKey);
-    },
+    upsertMembership,
     /**
      * List tenant API keys in the current admin scope.
      */
@@ -1571,115 +1585,111 @@ function createAnswersClient(config = {}) {
 // ../sdk/src/audiencesClient.ts
 function createAudiencesClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
+  const listRegistry = async (query5 = {}) => {
+    return gateway.request({
+      path: `/api/platform/v1/audiences/registry${toQueryString({
+        ...query5,
+        effective: typeof query5.effective === "boolean" ? query5.effective ? "true" : "false" : void 0,
+        status: query5.status
+      })}`
+    }).then(
+      (response) => mapGatewayData(
+        response,
+        (data) => createListResult(Array.isArray(data) ? data : [], "registryEntries")
+      )
+    );
+  };
+  const createRegistryEntry = async (input, idempotencyKey) => {
+    return gateway.request({
+      path: "/api/platform/v1/audiences/registry",
+      method: "POST",
+      body: input,
+      idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+    });
+  };
+  const updateRegistryEntry = createRegistryEntry;
+  const upsertRegistry = createRegistryEntry;
+  const getRegistry = listRegistry;
+  const listGrants = async (query5 = {}) => {
+    return gateway.request({
+      path: `/api/platform/v1/audiences/grants${toQueryString({
+        ...query5,
+        audienceKey: query5.audienceKey,
+        principalId: query5.principalId,
+        groupId: query5.groupId,
+        status: query5.status
+      })}`
+    }).then(
+      (response) => mapGatewayData(
+        response,
+        (data) => createListResult(Array.isArray(data) ? data : [], "grants")
+      )
+    );
+  };
+  const createGrant = async (input, idempotencyKey) => {
+    return gateway.request({
+      path: "/api/platform/v1/audiences/grants",
+      method: "POST",
+      body: input,
+      idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+    });
+  };
+  const getGrants = listGrants;
+  const grant = createGrant;
+  const deleteGrant = async (input, idempotencyKey) => {
+    return gateway.request({
+      path: "/api/platform/v1/audiences/grants/revoke",
+      method: "POST",
+      body: input,
+      idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+    });
+  };
+  const revokeGrant = deleteGrant;
   return {
     /**
      * List audience registry entries.
      */
-    async listRegistry(query5 = {}) {
-      return gateway.request({
-        path: `/api/platform/v1/audiences/registry${toQueryString({
-          ...query5,
-          effective: typeof query5.effective === "boolean" ? query5.effective ? "true" : "false" : void 0,
-          status: query5.status
-        })}`
-      }).then(
-        (response) => mapGatewayData(
-          response,
-          (data) => createListResult(
-            Array.isArray(data) ? data : [],
-            "registryEntries"
-          )
-        )
-      );
-    },
+    listRegistry,
     /**
      * @deprecated Use listRegistry.
      */
-    async getRegistry(query5 = {}) {
-      return this.listRegistry(query5);
-    },
+    getRegistry,
     /**
      * Create an audience registry entry.
      */
-    async createRegistryEntry(input, idempotencyKey) {
-      return gateway.request({
-        path: "/api/platform/v1/audiences/registry",
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    createRegistryEntry,
     /**
      * Update an audience registry entry.
      */
-    async updateRegistryEntry(input, idempotencyKey) {
-      return this.createRegistryEntry(input, idempotencyKey);
-    },
+    updateRegistryEntry,
     /**
      * @deprecated Use createRegistryEntry or updateRegistryEntry.
      */
-    async upsertRegistry(input, idempotencyKey) {
-      return this.createRegistryEntry(input, idempotencyKey);
-    },
+    upsertRegistry,
     /**
      * List audience grants.
      */
-    async listGrants(query5 = {}) {
-      return gateway.request({
-        path: `/api/platform/v1/audiences/grants${toQueryString({
-          ...query5,
-          audienceKey: query5.audienceKey,
-          principalId: query5.principalId,
-          groupId: query5.groupId,
-          status: query5.status
-        })}`
-      }).then(
-        (response) => mapGatewayData(
-          response,
-          (data) => createListResult(Array.isArray(data) ? data : [], "grants")
-        )
-      );
-    },
+    listGrants,
     /**
      * @deprecated Use listGrants.
      */
-    async getGrants(query5 = {}) {
-      return this.listGrants(query5);
-    },
+    getGrants,
     /**
      * Create an audience grant.
      */
-    async createGrant(input, idempotencyKey) {
-      return gateway.request({
-        path: "/api/platform/v1/audiences/grants",
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    createGrant,
     /**
      * @deprecated Use createGrant.
      */
-    async grant(input, idempotencyKey) {
-      return this.createGrant(input, idempotencyKey);
-    },
+    grant,
     /**
      * Delete an audience grant by revoking it.
      */
-    async deleteGrant(input, idempotencyKey) {
-      return gateway.request({
-        path: "/api/platform/v1/audiences/grants/revoke",
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    deleteGrant,
     /**
      * @deprecated Use deleteGrant.
      */
-    async revokeGrant(input, idempotencyKey) {
-      return this.deleteGrant(input, idempotencyKey);
-    }
+    revokeGrant
   };
 }
 
@@ -1720,8 +1730,18 @@ function authBaseUrl(config) {
   return config.baseUrl?.replace(/\/+$/, "") ?? "";
 }
 async function readJson(response) {
-  const payload = await response.json().catch(() => ({}));
-  return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  try {
+    const payload = await response.json();
+    return isRecord3(payload) ? payload : {};
+  } catch (error) {
+    return unreadableJsonBodyFallback();
+  }
+}
+function unreadableJsonBodyFallback(_error) {
+  return {};
+}
+function isRecord3(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function readString(value) {
   const normalized = typeof value === "string" ? value.trim() : "";
@@ -1763,7 +1783,10 @@ function assertDeviceTokenResponse(payload) {
     tenant_id: tenantId,
     workspace_id: readString(payload.workspace_id),
     principal_id: principalId,
-    user: payload.user && typeof payload.user === "object" && !Array.isArray(payload.user) ? payload.user : void 0
+    user: isRecord3(payload.user) && typeof payload.user.id === "string" && typeof payload.user.principalId === "string" ? {
+      id: payload.user.id,
+      principalId: payload.user.principalId
+    } : void 0
   };
 }
 function maybeThrowDeviceError(payload) {
@@ -1911,12 +1934,12 @@ function createBeliefsClient(config = {}) {
     body: normalizeModulateConfidenceInput(input),
     idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
   });
-  async function getOpinionHistory(beliefId) {
+  const getOpinionHistory = async (beliefId) => {
     const response = await gateway.request({
       path: `/api/platform/v1/beliefs/${encodeURIComponent(beliefId)}/confidence-history`
     });
     return mapOpinionHistoryEntriesFromGatewayData(response.data);
-  }
+  };
   return {
     /**
      * Create a belief within a topic scope.
@@ -1961,13 +1984,9 @@ function createBeliefsClient(config = {}) {
      *   trigger = cause of the score change
      *   triggeringRef = optional pointer to the evidence or worktree that drove the change
      */
-    async getOpinionHistory(beliefId) {
-      return getOpinionHistory(beliefId);
-    },
+    getOpinionHistory,
     /** @deprecated Use getOpinionHistory(). */
-    async getConfidenceHistory(beliefId) {
-      return getOpinionHistory(beliefId);
-    },
+    getConfidenceHistory: getOpinionHistory,
     /**
      * Fork a scored belief into a new formulation.
      */
@@ -2115,6 +2134,9 @@ function cleanOptionalString(value) {
   const normalized = value?.trim();
   return normalized ? normalized : void 0;
 }
+function isRecord4(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function cleanRequiredString(value, label) {
   const normalized = cleanOptionalString(value);
   if (!normalized) {
@@ -2154,9 +2176,10 @@ function topicPayload(input, allowed, operation) {
   };
 }
 function listResultFromEnvelope(data, legacyKey) {
-  const record = data && typeof data === "object" ? data : {};
+  const record = isRecord4(data) ? data : {};
+  const legacyItems = record[legacyKey];
   return createListResult(
-    Array.isArray(record[legacyKey]) ? record[legacyKey] : Array.isArray(data) ? data : [],
+    Array.isArray(legacyItems) ? legacyItems : Array.isArray(data) ? data : [],
     legacyKey
   );
 }
@@ -2528,7 +2551,7 @@ async function invokeRegisteredCustomTool(fullName, params, context) {
 // ../sdk/src/ontologyClient.ts
 function createOntologyClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List ontology definitions matching optional filters.
      */
@@ -2537,13 +2560,14 @@ function createOntologyClient(config = {}) {
         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;
+          const record = asRecord(data);
+          const ontologies = asListItems(data, "ontologies");
+          const definitions = ontologies.length > 0 ? ontologies : asListItems(data, "definitions");
+          const total = typeof record.total === "number" && Number.isFinite(record.total) ? record.total : definitions.length;
           return {
             ...record,
-            ...createListResult(ontologies, "definitions"),
-            ontologies,
+            ...createListResult(definitions, "definitions"),
+            ontologies: definitions,
             total
           };
         })
@@ -2570,18 +2594,6 @@ function createOntologyClient(config = {}) {
         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.
      */
@@ -2623,7 +2635,7 @@ function createOntologyClient(config = {}) {
       }).then(
         (response) => mapGatewayData(
           response,
-          (data) => createListResult(Array.isArray(data) ? data : [], "versions")
+          (data) => createListResult(asListItems(data, "versions"), "versions")
         )
       );
     },
@@ -2671,20 +2683,19 @@ function createOntologyClient(config = {}) {
           (data) => createListResult(Array.isArray(data) ? data : [], "topics")
         )
       );
-    },
-    /**
-     * @deprecated Use listTopics.
-     */
-    async listTopicsByOntology(ontologyId) {
-      return this.listTopics(ontologyId);
     }
   };
+  return Object.assign(client, {
+    listDefinitions: client.list,
+    getDefinition: client.get,
+    listTopicsByOntology: client.listTopics
+  });
 }
 
 // ../sdk/src/graphClient.ts
 function createGraphClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List graph nodes matching the provided filters.
      */
@@ -2697,12 +2708,6 @@ function createGraphClient(config = {}) {
         (response) => mapGatewayData(response, (data) => mapAliasedList(data, "nodes"))
       );
     },
-    /**
-     * @deprecated Use listNodes.
-     */
-    async queryNodes(query5) {
-      return this.listNodes(query5);
-    },
     /**
      * Retrieve a single graph node by nodeId or globalId.
      */
@@ -2813,12 +2818,6 @@ function createGraphClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listEdges.
-     */
-    async queryEdges(query5) {
-      return this.listEdges(query5);
-    },
     /**
      * Create a graph edge.
      */
@@ -2906,12 +2905,6 @@ function createGraphClient(config = {}) {
         body: normalizeTopicQuery(query5)
       });
     },
-    /**
-     * Retrieve a graph neighborhood around a root node.
-     */
-    async getNeighborhood(query5) {
-      return this.neighborhood(query5);
-    },
     /**
      * Retrieve the shortest known path between two graph nodes.
      */
@@ -2929,6 +2922,11 @@ function createGraphClient(config = {}) {
       });
     }
   };
+  return Object.assign(client, {
+    queryNodes: client.listNodes,
+    queryEdges: client.listEdges,
+    getNeighborhood: client.neighborhood
+  });
 }
 
 // ../sdk/src/identityClient.ts
@@ -2982,6 +2980,13 @@ function createIdentityClient(config = {}) {
     body: input,
     idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
   });
+  const updatePrincipal = (input, idempotencyKey) => requestPrincipalWrite("PATCH", input, idempotencyKey);
+  const deleteKey = (keyId, input = {}, idempotencyKey) => gateway.request({
+    path: `/api/platform/v1/identity/keys/${encodeURIComponent(keyId)}/revoke`,
+    method: "POST",
+    body: input,
+    idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+  });
   return {
     /**
      * Resolve the current authenticated identity summary.
@@ -3030,15 +3035,11 @@ function createIdentityClient(config = {}) {
     /**
      * Update a principal.
      */
-    async updatePrincipal(input, idempotencyKey) {
-      return requestPrincipalWrite("PATCH", input, idempotencyKey);
-    },
+    updatePrincipal,
     /**
      * @deprecated Use createPrincipal or updatePrincipal.
      */
-    async upsertPrincipal(input, idempotencyKey) {
-      return requestPrincipalWrite("PATCH", input, idempotencyKey);
-    },
+    upsertPrincipal: updatePrincipal,
     /**
      * List keys in the current identity scope.
      */
@@ -3077,20 +3078,11 @@ function createIdentityClient(config = {}) {
     /**
      * 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()
-      });
-    },
+    deleteKey,
     /**
      * @deprecated Use deleteKey.
      */
-    async revokeKey(keyId, input = {}, idempotencyKey) {
-      return this.deleteKey(keyId, input, idempotencyKey);
-    },
+    revokeKey: deleteKey,
     /**
      * Search Clerk users by email or display attributes.
      */
@@ -3206,14 +3198,11 @@ function createIdentityClient(config = {}) {
 }
 
 // ../sdk/src/topicsClient.ts
-function asRecord3(value) {
-  return value && typeof value === "object" ? value : {};
-}
 function cleanString3(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
 function normalizeTopicRecord(value) {
-  const record = asRecord3(value);
+  const record = asRecord(value);
   const topicId = cleanString3(record.topicId) ?? cleanString3(record.id) ?? cleanString3(record._id);
   return withTopicAlias({
     ...record,
@@ -3238,7 +3227,7 @@ function createTopicsClient(config = {}) {
         })}`
       }).then(
         (response) => mapGatewayData(response, (data) => {
-          const record = asRecord3(data);
+          const record = asRecord(data);
           const items = Array.isArray(record.topics) ? record.topics.map(normalizeTopicRecord) : [];
           return {
             ...createListResult(items, "topics"),
@@ -3255,7 +3244,7 @@ function createTopicsClient(config = {}) {
       }).then(
         (response) => mapGatewayData(
           response,
-          (data) => normalizeTopicRecord(asRecord3(data).topic ?? data)
+          (data) => normalizeTopicRecord(asRecord(data).topic ?? data)
         )
       );
     },
@@ -3291,7 +3280,7 @@ function createTopicsClient(config = {}) {
         )}`
       }).then(
         (response) => mapGatewayData(response, (data) => {
-          const record = asRecord3(data);
+          const record = asRecord(data);
           return {
             tree: Array.isArray(record.tree) ? record.tree.map(normalizeTopicTreeNode) : []
           };
@@ -3710,7 +3699,7 @@ function createEventsFacade(config = {}) {
 function createGraphFacade(config = {}) {
   const graphClient = createGraphClient(config);
   const gateway = createGatewayRequestClient(config);
-  return {
+  const graphFacade = {
     async neighborhood(input) {
       return graphClient.neighborhood({
         globalId: input.globalId,
@@ -3718,18 +3707,6 @@ function createGraphFacade(config = {}) {
         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",
@@ -3739,6 +3716,12 @@ function createGraphFacade(config = {}) {
       });
     }
   };
+  return Object.assign(graphFacade, {
+    traverse: graphClient.traverse,
+    analyze: graphClient.analyze,
+    bias: graphClient.bias,
+    gaps: graphClient.gaps
+  });
 }
 function createIdentityFacade(config = {}) {
   const identityClient = createIdentityClient(config);
@@ -3752,15 +3735,12 @@ function createIdentityFacade(config = {}) {
 function createOntologiesFacade(config = {}) {
   const ontologyClient = createOntologyClient(config);
   const gateway = createGatewayRequestClient(config);
-  return {
+  const ontologyFacade = {
     async get(id) {
       return gateway.request({
         path: `/api/platform/v1/ontologies/${encodeURIComponent(id)}`
       });
     },
-    async list(query5 = {}) {
-      return ontologyClient.list(query5);
-    },
     async bind(input, idempotencyKey) {
       return gateway.request({
         path: `/api/platform/v1/ontologies/${encodeURIComponent(input.ontologyId)}/bind`,
@@ -3780,6 +3760,9 @@ function createOntologiesFacade(config = {}) {
       });
     }
   };
+  return Object.assign(ontologyFacade, {
+    list: ontologyClient.list
+  });
 }
 function createQuestionsFacade(config = {}) {
   const gateway = createGatewayRequestClient(config);
@@ -3972,15 +3955,9 @@ function createTasksFacade(config = {}) {
 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(query5 = {}) {
-      return topicsClient.list(query5);
-    },
+    create: topicsClient.create,
+    get: topicsClient.get,
+    list: topicsClient.list,
     async update(input, idempotencyKey) {
       const { id, ...rest } = input;
       return topicsClient.update(id, rest, idempotencyKey);
@@ -3996,12 +3973,8 @@ function createTopicsFacade(config = {}) {
         maxDepth: input.maxDepth
       });
     },
-    async remove(id, idempotencyKey = randomIdempotencyKey()) {
-      return topicsClient.remove(id, idempotencyKey);
-    },
-    async bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
-      return topicsClient.bulkCreate(input, idempotencyKey);
-    }
+    remove: topicsClient.remove,
+    bulkCreate: topicsClient.bulkCreate
   };
 }
 function createWebhooksFacade(config = {}) {
@@ -4201,7 +4174,7 @@ function createWorktreesFacade(config = {}) {
 // ../sdk/src/decisionsClient.ts
 function createDecisionsClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List judgments for a topic scope.
      */
@@ -4279,12 +4252,6 @@ function createDecisionsClient(config = {}) {
         })
       );
     },
-    /**
-     * @deprecated Use listPendingOutcomeReviews.
-     */
-    async listPendingJudgmentOutcomeReview(query5) {
-      return this.listPendingOutcomeReviews(query5);
-    },
     /**
      * Get audit integrity checks for judgment transitions.
      */
@@ -4317,12 +4284,6 @@ function createDecisionsClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use createJudgment.
-     */
-    async recordJudgment(input, idempotencyKey) {
-      return this.createJudgment(input, idempotencyKey);
-    },
     /**
      * Update the outcome for an existing judgment.
      */
@@ -4333,14 +4294,13 @@ function createDecisionsClient(config = {}) {
         body: input,
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
-    },
-    /**
-     * @deprecated Use updateJudgmentOutcome.
-     */
-    async recordJudgmentOutcome(judgmentId, input, idempotencyKey) {
-      return this.updateJudgmentOutcome(judgmentId, input, idempotencyKey);
     }
   };
+  return Object.assign(client, {
+    listPendingJudgmentOutcomeReview: client.listPendingOutcomeReviews,
+    recordJudgment: client.createJudgment,
+    recordJudgmentOutcome: client.updateJudgmentOutcome
+  });
 }
 
 // ../sdk/src/embeddingsClient.ts
@@ -4465,50 +4425,55 @@ function cleanNumber(value) {
 function cleanBoolean(value) {
   return typeof value === "boolean" ? value : void 0;
 }
-function buildCompileContextRequest(topicId, input = {}) {
-  const payload = { topicId };
-  const query5 = cleanString4(input.query);
+function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
+  const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
+  const payload = {};
+  const topicId = typeof topicIdOrInput === "string" ? cleanString4(topicIdOrInput) : cleanString4(effectiveInput.topicId);
+  if (topicId) {
+    payload.topicId = topicId;
+  }
+  const query5 = cleanString4(effectiveInput.query);
   if (query5) {
     payload.query = query5;
   }
-  const budget = cleanNumber(input.budget) ?? cleanNumber(input.tokenBudget);
+  const budget = cleanNumber(effectiveInput.budget) ?? cleanNumber(effectiveInput.tokenBudget);
   if (budget !== void 0) {
     payload.budget = budget;
   }
-  const ranking = cleanString4(input.ranking) ?? cleanString4(input.rankingProfile);
+  const ranking = cleanString4(effectiveInput.ranking) ?? cleanString4(effectiveInput.rankingProfile);
   if (ranking) {
     payload.ranking = ranking;
   }
-  const limit = cleanNumber(input.limit);
+  const limit = cleanNumber(effectiveInput.limit);
   if (limit !== void 0) {
     payload.limit = limit;
   }
-  const maxDepth = cleanNumber(input.maxDepth);
+  const maxDepth = cleanNumber(effectiveInput.maxDepth);
   if (maxDepth !== void 0) {
     payload.maxDepth = maxDepth;
   }
-  const includeEntities = cleanBoolean(input.includeEntities);
+  const includeEntities = cleanBoolean(effectiveInput.includeEntities);
   if (includeEntities !== void 0) {
     payload.includeEntities = includeEntities;
   }
-  const mode = cleanString4(input.mode);
+  const mode = cleanString4(effectiveInput.mode);
   if (mode) {
     payload.mode = mode;
   }
-  const includeFailures = cleanBoolean(input.includeFailures);
+  const includeFailures = cleanBoolean(effectiveInput.includeFailures);
   if (includeFailures !== void 0) {
     payload.includeFailures = includeFailures;
   }
-  const worktreeId = cleanString4(input.worktreeId);
+  const worktreeId = cleanString4(effectiveInput.worktreeId);
   if (worktreeId) {
     payload.worktreeId = worktreeId;
   }
-  const sessionId = cleanString4(input.sessionId);
+  const sessionId = cleanString4(effectiveInput.sessionId);
   if (sessionId) {
     payload.sessionId = sessionId;
   }
-  if (Array.isArray(input.packWeightOverrides) && input.packWeightOverrides.length > 0) {
-    payload.packWeightOverrides = input.packWeightOverrides;
+  if (Array.isArray(effectiveInput.packWeightOverrides) && effectiveInput.packWeightOverrides.length > 0) {
+    payload.packWeightOverrides = effectiveInput.packWeightOverrides;
   }
   return {
     path: "/api/platform/v1/context/compile",
@@ -4520,13 +4485,20 @@ function createContextClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
   return {
     /**
-     * Compile a focused reasoning context pack for a topic scope.
-     * @param topicId - The topic to compile context for.
+     * Compile a focused reasoning context pack.
+     * @param topicIdOrInput - Optional topic ID, or compile input for query-first resolution.
      * @param input - Optional compile parameters (query, budget, ranking, etc.).
      * @returns The compiled context payload with beliefs, questions, and evidence.
      */
-    async compile(topicId, input = {}) {
-      const request = buildCompileContextRequest(topicId, input);
+    async compile(topicIdOrInput = {}, input = {}) {
+      const request = buildCompileContextRequest(topicIdOrInput, input);
+      return gateway.request({
+        ...request,
+        body: request.body
+      });
+    },
+    async compileByQuery(input = {}) {
+      const request = buildCompileContextRequest(input);
       return gateway.request({
         ...request,
         body: request.body
@@ -4964,7 +4936,7 @@ function createGraphStateClassifierClient(config = {}) {
 // ../sdk/src/harnessClient.ts
 function createHarnessClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List agent definitions.
      */
@@ -4997,12 +4969,6 @@ function createHarnessClient(config = {}) {
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
     },
-    /**
-     * @deprecated Use createAgentDefinition.
-     */
-    async registerAgentDefinition(input, idempotencyKey) {
-      return this.createAgentDefinition(input, idempotencyKey);
-    },
     /**
      * Update an agent definition.
      */
@@ -5041,12 +5007,6 @@ function createHarnessClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listAgentRuns.
-     */
-    async listRunsForAgent(agentId, scope = {}) {
-      return this.listAgentRuns(agentId, scope);
-    },
     /**
      * List tool definitions.
      */
@@ -5079,12 +5039,6 @@ function createHarnessClient(config = {}) {
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
     },
-    /**
-     * @deprecated Use createToolDefinition.
-     */
-    async registerToolDefinition(input, idempotencyKey) {
-      return this.createToolDefinition(input, idempotencyKey);
-    },
     /**
      * Update a tool definition.
      */
@@ -5119,12 +5073,6 @@ function createHarnessClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listRunEntries.
-     */
-    async listRunLedgerEntries(scope = {}) {
-      return this.listRunEntries(scope);
-    },
     /**
      * Create a harness run.
      */
@@ -5199,6 +5147,12 @@ function createHarnessClient(config = {}) {
       });
     }
   };
+  return Object.assign(client, {
+    registerAgentDefinition: client.createAgentDefinition,
+    listRunsForAgent: client.listAgentRuns,
+    registerToolDefinition: client.createToolDefinition,
+    listRunLedgerEntries: client.listRunEntries
+  });
 }
 
 // ../sdk/src/jobsClient.ts
@@ -5326,45 +5280,41 @@ function createJobsClient(config = {}) {
 // ../sdk/src/learningClient.ts
 function createLearningClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
+  const listRecentExecutions = async (args = {}) => 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" : void 0,
+      limit: typeof args.limit === "number" && Number.isFinite(args.limit) ? String(args.limit) : void 0
+    })}`
+  }).then(
+    (response) => mapGatewayData(
+      response,
+      (data) => createListResult(Array.isArray(data) ? data : [], "executions")
+    )
+  );
+  const getExecutionStats = async (args = {}) => 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) : void 0
+    })}`
+  });
   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" : void 0,
-          limit: typeof args.limit === "number" && Number.isFinite(args.limit) ? String(args.limit) : void 0
-        })}`
-      }).then(
-        (response) => mapGatewayData(
-          response,
-          (data) => createListResult(Array.isArray(data) ? data : [], "executions")
-        )
-      );
-    },
+    listRecentExecutions,
     /**
      * @deprecated Use listRecentExecutions.
      */
-    async getRecentExecutions(args = {}) {
-      return this.listRecentExecutions(args);
-    },
+    getRecentExecutions: listRecentExecutions,
     /**
      * 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) : void 0
-        })}`
-      });
-    }
+    getExecutionStats
   };
 }
 
@@ -6401,7 +6351,7 @@ function createOrgGraphSearchClient(config = {}) {
 // ../sdk/src/packsClient.ts
 function createPacksClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  return {
+  const client = {
     /**
      * List catalog entries for available packs.
      */
@@ -6415,12 +6365,6 @@ function createPacksClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listCatalog.
-     */
-    async getCatalog() {
-      return this.listCatalog();
-    },
     /**
      * Get the discovery catalog for packs.
      */
@@ -6450,12 +6394,6 @@ function createPacksClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listStates.
-     */
-    async getStates(query5 = {}) {
-      return this.listStates(query5);
-    },
     /**
      * Get health details for a pack.
      */
@@ -6479,12 +6417,6 @@ function createPacksClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use listTelemetry.
-     */
-    async getTelemetry(query5 = {}) {
-      return this.listTelemetry(query5);
-    },
     /**
      * Create a pack entitlement.
      */
@@ -6496,18 +6428,6 @@ function createPacksClient(config = {}) {
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
     },
-    /**
-     * Update a pack entitlement.
-     */
-    async updateEntitlement(input, idempotencyKey) {
-      return this.createEntitlement(input, idempotencyKey);
-    },
-    /**
-     * @deprecated Use createEntitlement or updateEntitlement.
-     */
-    async upsertEntitlement(input, idempotencyKey) {
-      return this.createEntitlement(input, idempotencyKey);
-    },
     /**
      * Install a pack.
      */
@@ -6564,6 +6484,13 @@ function createPacksClient(config = {}) {
       });
     }
   };
+  return Object.assign(client, {
+    getCatalog: client.listCatalog,
+    getStates: client.listStates,
+    getTelemetry: client.listTelemetry,
+    updateEntitlement: client.createEntitlement,
+    upsertEntitlement: client.createEntitlement
+  });
 }
 
 // ../sdk/src/policyClient.ts
@@ -6599,6 +6526,14 @@ function asRolePolicyArray(data) {
   }
   return data.map(asRolePolicyRecord).filter((row) => Boolean(row));
 }
+function buildFilterByPermissionResponse(permission, allowedTopicIds, deniedTopics, count) {
+  const result = {};
+  result.permission = permission;
+  result.allowedTopicIds = allowedTopicIds;
+  result.deniedTopics = deniedTopics;
+  result.count = count;
+  return result;
+}
 function createPolicyClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
   return {
@@ -6821,15 +6756,15 @@ function createPolicyClient(config = {}) {
       });
       const allowedTopicIds = Array.isArray(response.data?.allowedTopicIds) ? response.data.allowedTopicIds : [];
       const deniedTopics = Array.isArray(response.data?.deniedTopics) ? response.data.deniedTopics : [];
-      return {
-        success: true,
-        data: {
-          permission,
-          allowedTopicIds,
-          deniedTopics,
-          count: typeof response.data?.count === "number" ? response.data.count : allowedTopicIds.length
-        }
-      };
+      const result = {};
+      result.success = true;
+      result.data = buildFilterByPermissionResponse(
+        permission,
+        allowedTopicIds,
+        deniedTopics,
+        typeof response.data?.count === "number" ? response.data.count : allowedTopicIds.length
+      );
+      return result;
     }
   };
 }
@@ -6837,64 +6772,66 @@ function createPolicyClient(config = {}) {
 // ../sdk/src/reportsClient.ts
 function createReportsClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
+  const listTemplates = async (args = {}) => gateway.request({
+    path: `/api/platform/v1/reports/templates${toQueryString({
+      slug: args.slug
+    })}`
+  }).then(
+    (response) => mapGatewayData(response, (data) => {
+      const rows = asListItems(data, "templates");
+      return createListResult(rows, "templates");
+    })
+  );
+  const listReports = async (input, args = {}) => {
+    const topicId = resolveTopicId(input);
+    if (!topicId) {
+      throw new Error("topicId is required");
+    }
+    return gateway.request({
+      path: `/api/platform/v1/reports/topics/${encodeURIComponent(topicId)}${toQueryString(
+        {
+          summary: typeof args.summary === "boolean" ? args.summary ? "true" : "false" : void 0
+        }
+      )}`
+    }).then(
+      (response) => mapGatewayData(
+        response,
+        (data) => createListResult(Array.isArray(data) ? data : [], "reports")
+      )
+    );
+  };
+  const getReport = async (reportId) => gateway.request({
+    path: `/api/platform/v1/reports/${encodeURIComponent(reportId)}`
+  });
   return {
     /**
      * List report templates.
      */
-    async listTemplates(args = {}) {
-      return gateway.request({
-        path: `/api/platform/v1/reports/templates${toQueryString({
-          slug: args.slug
-        })}`
-      }).then(
-        (response) => mapGatewayData(response, (data) => {
-          const record = data && typeof data === "object" ? data : {};
-          const rows = Array.isArray(data) ? data : Array.isArray(record.templates) ? record.templates : [];
-          return createListResult(rows, "templates");
-        })
-      );
-    },
+    listTemplates,
     /**
      * @deprecated Use listTemplates.
      */
-    async getTemplates(args = {}) {
-      return this.listTemplates(args);
-    },
+    getTemplates: listTemplates,
     /**
      * List reports for a topic scope.
      */
-    async listReports(input, args = {}) {
-      const topicId = resolveTopicId(input);
-      if (!topicId) {
-        throw new Error("topicId is required");
-      }
-      return gateway.request({
-        path: `/api/platform/v1/reports/topics/${encodeURIComponent(topicId)}${toQueryString(
-          {
-            summary: typeof args.summary === "boolean" ? args.summary ? "true" : "false" : void 0
-          }
-        )}`
-      }).then(
-        (response) => mapGatewayData(
-          response,
-          (data) => createListResult(Array.isArray(data) ? data : [], "reports")
-        )
-      );
-    },
+    listReports,
     /**
      * Get a generated report.
      */
-    async getReport(reportId) {
-      return gateway.request({
-        path: `/api/platform/v1/reports/${encodeURIComponent(reportId)}`
-      });
-    }
+    getReport
   };
 }
 
 // ../sdk/src/schemaClient.ts
 function createSchemaClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
+  const createEntitlement = (input, idempotencyKey) => gateway.request({
+    path: "/api/platform/v1/schema/entitlements",
+    method: "POST",
+    body: input,
+    idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+  });
   return {
     /**
      * List schema packs.
@@ -6946,29 +6883,95 @@ function createSchemaClient(config = {}) {
     /**
      * Create a schema entitlement.
      */
-    async createEntitlement(input, idempotencyKey) {
-      return gateway.request({
-        path: "/api/platform/v1/schema/entitlements",
-        method: "POST",
-        body: input,
-        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
-      });
-    },
+    createEntitlement,
     /**
      * Update a schema entitlement.
      */
-    async updateEntitlement(input, idempotencyKey) {
-      return this.createEntitlement(input, idempotencyKey);
-    },
+    updateEntitlement: createEntitlement,
     /**
      * @deprecated Use createEntitlement or updateEntitlement.
      */
-    async upsertEntitlement(input, idempotencyKey) {
-      return this.createEntitlement(input, idempotencyKey);
-    }
+    upsertEntitlement: createEntitlement
   };
 }
 
+// ../sdk/src/clientHelpers.ts
+function asNodeArray(data) {
+  const rows = asListItems(data, "nodes");
+  if (rows.length > 0) {
+    return rows.filter(
+      (value) => Boolean(value) && typeof value === "object"
+    );
+  }
+  if (data && typeof data === "object") {
+    return [data];
+  }
+  return [];
+}
+function requireTopicId4(args) {
+  const topicId = resolveTopicId(args);
+  if (!topicId) {
+    throw new Error("topicId is required");
+  }
+  return topicId;
+}
+function requireTopicOrProjectId(args) {
+  const topicId = args.topicId?.trim() || args.projectId?.trim() || void 0;
+  if (!topicId) {
+    throw new Error("topicId is required");
+  }
+  return topicId;
+}
+var AUDIT_NODE_REFERENCE_KEY_PATTERN = /(^|_)(id|nodeid|beliefid|resourceid|targetid|sourceid|subjectid|globalid|entityid|recordid|fromnodeid|tonodeid|linkednodeid|linkedbeliefid|nodeids|beliefids|resourceids)$/i;
+function matchesAuditNodeReference(value, nodeId) {
+  if (Array.isArray(value)) {
+    return value.some((entry) => matchesAuditNodeReference(entry, nodeId));
+  }
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  return Object.entries(value).some(([key, entry]) => {
+    if (typeof entry === "string" && entry === nodeId && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key)) {
+      return true;
+    }
+    if (Array.isArray(entry) && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key) && entry.some((item) => item === nodeId)) {
+      return true;
+    }
+    return matchesAuditNodeReference(entry, nodeId);
+  });
+}
+function requireText(args) {
+  const text = resolveText(args);
+  if (!text) {
+    throw new Error("text is required");
+  }
+  return text;
+}
+function requireBaseRate(args) {
+  const baseRate = typeof args.baseRate === "number" && Number.isFinite(args.baseRate) ? args.baseRate : 0.5;
+  if (baseRate < 0 || baseRate > 1) {
+    throw new Error("baseRate must be within [0, 1].");
+  }
+  return baseRate;
+}
+function sdkQueryString(input) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(input)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      if (value.length > 0) {
+        params.set(key, value.join(","));
+      }
+      continue;
+    }
+    params.set(key, String(value));
+  }
+  const serialized = params.toString();
+  return serialized ? `?${serialized}` : "";
+}
+
 // ../sdk/src/telemetryClient.ts
 var TELEMETRY_FIELDS = [
   "tenantId",
@@ -7139,6 +7142,16 @@ function query4(input) {
     cursor: input.cursor
   };
 }
+function effectiveToolsQuery(input) {
+  return {
+    ...query4(input),
+    callerRole: input.callerRole,
+    surface: input.surface,
+    sessionType: input.sessionType,
+    permittedToolNames: input.permittedToolNames ? JSON.stringify(input.permittedToolNames) : void 0,
+    executableOnly: input.executableOnly
+  };
+}
 function writeBody(input, operation) {
   return knownPayload(input, TOOL_REGISTRY_FIELDS, operation);
 }
@@ -7167,7 +7180,9 @@ function createToolRegistryClient(config = {}) {
     },
     listEffectiveTools(input) {
       return gateway.request({
-        path: `/api/platform/v1/tools/effective${toQueryString(query4(input))}`
+        path: `/api/platform/v1/tools/effective${toQueryString(
+          effectiveToolsQuery(input)
+        )}`
       }).then(
         (response) => mapGatewayData(
           response,
@@ -7258,7 +7273,7 @@ function createToolRegistryClient(config = {}) {
 }
 
 // ../sdk/src/version.ts
-var LUCERN_SDK_VERSION = "0.2.0-alpha.1";
+var LUCERN_SDK_VERSION = "0.3.0-alpha.8";
 
 // ../sdk/src/workflowClient.ts
 function normalizeLensQuery(value) {
@@ -7452,12 +7467,6 @@ function createWorkflowClient(config = {}) {
         )
       );
     },
-    /**
-     * @deprecated Use createWorktree.
-     */
-    async addWorktree(input, idempotencyKey) {
-      return client.createWorktree(input, idempotencyKey);
-    },
     /**
      * Merge a worktree into the main belief line.
      */
@@ -7655,54 +7664,19 @@ function createWorkflowClient(config = {}) {
         body: input,
         idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
       });
-    },
-    /**
-     * @deprecated Use createBranch.
-     */
-    async createPillar(input, idempotencyKey) {
-      return client.createBranch(input, idempotencyKey);
-    },
-    /**
-     * @deprecated Use addWorktree.
-     */
-    async createSprint(input, idempotencyKey) {
-      return client.createWorktree(input, idempotencyKey);
-    },
-    /**
-     * @deprecated Use merge.
-     */
-    async completeSprint(worktreeId, input, idempotencyKey) {
-      return client.merge(worktreeId, input, idempotencyKey);
-    },
-    /**
-     * @deprecated Use openPullRequest.
-     */
-    async requestReview(worktreeId, input, idempotencyKey) {
-      return client.openPullRequest(worktreeId, input, idempotencyKey);
-    },
-    /**
-     * @deprecated Use push.
-     */
-    async publishFindings(worktreeId, input, idempotencyKey) {
-      return client.push(worktreeId, input, idempotencyKey);
     }
   };
-  return client;
+  return Object.assign(client, {
+    addWorktree: client.createWorktree,
+    createPillar: client.createBranch,
+    createSprint: client.createWorktree,
+    completeSprint: client.merge,
+    requestReview: client.openPullRequest,
+    publishFindings: client.push
+  });
 }
 
 // ../sdk/src/client.ts
-function asNodeArray(data) {
-  const rows = asListItems(data, "nodes");
-  if (rows.length > 0) {
-    return rows.filter(
-      (value) => Boolean(value) && typeof value === "object"
-    );
-  }
-  if (data && typeof data === "object") {
-    return [data];
-  }
-  return [];
-}
 function toGatewayConfig(config) {
   return {
     baseUrl: config.baseUrl,
@@ -7730,72 +7704,9 @@ function toGatewayConfig(config) {
     }
   };
 }
-function requireTopicId4(args) {
-  const topicId = resolveTopicId(args);
-  if (!topicId) {
-    throw new Error("topicId is required");
-  }
-  return topicId;
-}
-function requireTopicOrProjectId(args) {
-  const topicId = args.topicId?.trim() || args.projectId?.trim() || void 0;
-  if (!topicId) {
-    throw new Error("topicId is required");
-  }
-  return topicId;
-}
-var AUDIT_NODE_REFERENCE_KEY_PATTERN = /(^|_)(id|nodeid|beliefid|resourceid|targetid|sourceid|subjectid|globalid|entityid|recordid|fromnodeid|tonodeid|linkednodeid|linkedbeliefid|nodeids|beliefids|resourceids)$/i;
-function matchesAuditNodeReference(value, nodeId) {
-  if (Array.isArray(value)) {
-    return value.some((entry) => matchesAuditNodeReference(entry, nodeId));
-  }
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  return Object.entries(value).some(([key, entry]) => {
-    if (typeof entry === "string" && entry === nodeId && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key)) {
-      return true;
-    }
-    if (Array.isArray(entry) && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key) && entry.some((item) => item === nodeId)) {
-      return true;
-    }
-    return matchesAuditNodeReference(entry, nodeId);
-  });
-}
-function requireText(args) {
-  const text = resolveText(args);
-  if (!text) {
-    throw new Error("text is required");
-  }
-  return text;
-}
-function requireBaseRate(args) {
-  const baseRate = typeof args.baseRate === "number" && Number.isFinite(args.baseRate) ? args.baseRate : 0.5;
-  if (baseRate < 0 || baseRate > 1) {
-    throw new Error("baseRate must be within [0, 1].");
-  }
-  return baseRate;
-}
 function exposeGatewayData(response) {
   return Object.assign({}, response, response.data);
 }
-function sdkQueryString(input) {
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(input)) {
-    if (value === void 0 || value === null) {
-      continue;
-    }
-    if (Array.isArray(value)) {
-      if (value.length > 0) {
-        params.set(key, value.join(","));
-      }
-      continue;
-    }
-    params.set(key, String(value));
-  }
-  const serialized = params.toString();
-  return serialized ? `?${serialized}` : "";
-}
 function createLucernClient(config = {}) {
   const gatewayConfig = toGatewayConfig(config);
   const beliefsClient = createBeliefsClient(gatewayConfig);
@@ -8019,7 +7930,7 @@ function createLucernClient(config = {}) {
       topicId,
       nodeType: "contradiction",
       limit: 500
-    }) : args.nodeId ? await graphClient.queryNodes({ nodeId: args.nodeId }) : { data: [] };
+    }) : args.nodeId ? await graphClient.listNodes({ nodeId: args.nodeId }) : { data: [] };
     const contradictions2 = asNodeArray(response.data).filter((node) => {
       const status = typeof node.metadata?.status === "string" ? node.metadata.status : typeof node.status === "string" ? node.status : "unresolved";
       if (args.status && status !== args.status) {
@@ -8199,23 +8110,15 @@ function createLucernClient(config = {}) {
     }).then(exposeGatewayData);
   }
   const nodesNamespace = {
-    list(query5) {
-      return graphClient.listNodes(query5);
-    },
+    list: graphClient.listNodes,
     get(input) {
       return graphClient.getNode(
         typeof input === "string" ? { nodeId: input } : input
       );
     },
-    create(input, idempotencyKey) {
-      return graphClient.createNode(input, idempotencyKey);
-    },
-    update(input, idempotencyKey) {
-      return graphClient.updateNode(input, idempotencyKey);
-    },
-    batchCreate(input, idempotencyKey) {
-      return graphClient.batchCreateNodes(input, idempotencyKey);
-    },
+    create: graphClient.createNode,
+    update: graphClient.updateNode,
+    batchCreate: graphClient.batchCreateNodes,
     listByTopicAndType(input) {
       return gateway.request({
         path: `/api/platform/v1/nodes${sdkQueryString({
@@ -8240,15 +8143,9 @@ function createLucernClient(config = {}) {
         })}`
       }).then(exposeGatewayData);
     },
-    supersede(input, idempotencyKey) {
-      return graphClient.supersedeNode(input, idempotencyKey);
-    },
-    verify(input, idempotencyKey) {
-      return graphClient.verifyNode(input, idempotencyKey);
-    },
-    hardDelete(input, idempotencyKey) {
-      return graphClient.hardDeleteNode(input, idempotencyKey);
-    }
+    supersede: graphClient.supersedeNode,
+    verify: graphClient.verifyNode,
+    hardDelete: graphClient.hardDeleteNode
   };
   const publicationNamespace = {
     create(input, idempotencyKey) {
@@ -8325,9 +8222,7 @@ function createLucernClient(config = {}) {
   return {
     config,
     version: LUCERN_SDK_VERSION,
-    search(query5, options) {
-      return searchResources(query5, options);
-    },
+    search: searchResources,
     events: {
       list(query5 = {}) {
         return eventsFacade.list(query5).then(exposeGatewayData);
@@ -8424,9 +8319,7 @@ function createLucernClient(config = {}) {
       confidenceHistory(nodeId) {
         return beliefsFacade.confidenceHistory(nodeId).then(exposeGatewayData);
       },
-      opinionHistory(nodeId) {
-        return getOpinionHistory(nodeId);
-      },
+      opinionHistory: getOpinionHistory,
       createContract(nodeId, input) {
         return beliefsFacade.createContract(nodeId, input).then(exposeGatewayData);
       },
@@ -8680,10 +8573,10 @@ function createLucernClient(config = {}) {
         }));
       },
       getHighPriority(args) {
-        return this.list({
+        return questionsFacade.list({
           topicId: requireTopicId4(args),
           status: args.includeAnswered ? void 0 : "open"
-        }).then((data) => {
+        }).then(exposeGatewayData).then((data) => {
           const questions = Array.isArray(data.questions) ? data.questions : [];
           const rank = (priority) => {
             switch (priority) {
@@ -8713,9 +8606,7 @@ function createLucernClient(config = {}) {
     },
     graph: {
       nodes: nodesNamespace,
-      createEdge(input) {
-        return graphClient.createEdge(input);
-      },
+      createEdge: graphClient.createEdge,
       neighborhood(args) {
         return graphFacade.neighborhood({
           globalId: args.globalId,
@@ -8774,7 +8665,7 @@ function createLucernClient(config = {}) {
       bisectConfidence,
       listBeliefs,
       detectConfirmationBias(topicId, threshold) {
-        return this.bias({
+        return graphFacade.bias({
           topicId,
           threshold,
           limit: 200
@@ -8785,7 +8676,7 @@ function createLucernClient(config = {}) {
         }));
       },
       getStructureAnalysis(topicId) {
-        return this.analyze({
+        return graphFacade.analyze({
           topicId,
           limit: 200
         }).then((response) => ({
@@ -8852,38 +8743,20 @@ function createLucernClient(config = {}) {
       }
     },
     judgments: {
-      create(input) {
-        return decisionsClient.createJudgment(input);
-      },
-      record(input) {
-        return decisionsClient.recordJudgment(input);
-      },
-      list(query5) {
-        return decisionsClient.listJudgments(query5);
-      },
-      get(judgmentId) {
-        return decisionsClient.getJudgment(judgmentId);
-      },
-      recordOutcome(judgmentId, input) {
-        return decisionsClient.recordJudgmentOutcome(judgmentId, input);
-      },
-      updateOutcome(judgmentId, input) {
-        return decisionsClient.updateJudgmentOutcome(judgmentId, input);
-      },
+      create: decisionsClient.createJudgment,
+      record: decisionsClient.recordJudgment,
+      list: decisionsClient.listJudgments,
+      get: decisionsClient.getJudgment,
+      recordOutcome: decisionsClient.recordJudgmentOutcome,
+      updateOutcome: decisionsClient.updateJudgmentOutcome,
       readiness(topicId) {
-        return decisionsClient.getJudgmentReadiness({
-          topicId
-        });
+        return decisionsClient.getJudgmentReadiness({ topicId });
       },
       calibration(topicId) {
-        return decisionsClient.getJudgmentCalibration({
-          topicId
-        });
+        return decisionsClient.getJudgmentCalibration({ topicId });
       },
       pendingOutcomeReview(topicId) {
-        return decisionsClient.listPendingJudgmentOutcomeReview({
-          topicId
-        });
+        return decisionsClient.listPendingJudgmentOutcomeReview({ topicId });
       },
       transitionAuditIntegrity(args) {
         return decisionsClient.getJudgmentTransitionAuditIntegrity({
@@ -8893,21 +8766,11 @@ function createLucernClient(config = {}) {
       }
     },
     decisions: {
-      create(input) {
-        return decisionsClient.createJudgment(input);
-      },
-      record(input) {
-        return decisionsClient.recordJudgment(input);
-      },
-      list(query5) {
-        return decisionsClient.listJudgments(query5);
-      },
-      get(decisionId) {
-        return decisionsClient.getJudgment(decisionId);
-      },
-      recordOutcome(decisionId, input) {
-        return decisionsClient.recordJudgmentOutcome(decisionId, input);
-      },
+      create: decisionsClient.createJudgment,
+      record: decisionsClient.recordJudgment,
+      list: decisionsClient.listJudgments,
+      get: decisionsClient.getJudgment,
+      recordOutcome: decisionsClient.recordJudgmentOutcome,
       lessons(decisionId, input, idempotencyKey) {
         return gateway.request({
           path: `/api/platform/v1/decisions/${encodeURIComponent(
@@ -8939,21 +8802,11 @@ function createLucernClient(config = {}) {
       }
     },
     worktrees: {
-      createBranch(input) {
-        return workflowClient.createBranch(input);
-      },
-      createLens(input) {
-        return workflowClient.createLens(input);
-      },
-      listLenses(query5) {
-        return workflowClient.listLenses(query5);
-      },
-      applyLensToTopic(input) {
-        return workflowClient.applyLensToTopic(input);
-      },
-      removeLensFromTopic(input) {
-        return workflowClient.removeLensFromTopic(input);
-      },
+      createBranch: workflowClient.createBranch,
+      createLens: workflowClient.createLens,
+      listLenses: workflowClient.listLenses,
+      applyLensToTopic: workflowClient.applyLensToTopic,
+      removeLensFromTopic: workflowClient.removeLensFromTopic,
       create(input) {
         return worktreesFacade.create({
           title: input.title,
@@ -9058,7 +8911,9 @@ function createLucernClient(config = {}) {
         const dependsOn = Array.isArray(input.dependsOn) ? input.dependsOn.filter(
           (value) => typeof value === "string"
         ) : void 0;
-        const blocks = Array.isArray(input.blocks) ? input.blocks.filter((value) => typeof value === "string") : void 0;
+        const blocks = Array.isArray(input.blocks) ? input.blocks.filter(
+          (value) => typeof value === "string"
+        ) : void 0;
         return worktreesFacade.update({
           id: typeof input.worktreeId === "string" ? input.worktreeId : "",
           hypothesis: typeof input.hypothesis === "string" ? input.hypothesis : void 0,
@@ -9072,7 +8927,23 @@ function createLucernClient(config = {}) {
         });
       },
       update(input) {
-        return this.updateMetadata(input);
+        const dependsOn = Array.isArray(input.dependsOn) ? input.dependsOn.filter(
+          (value) => typeof value === "string"
+        ) : void 0;
+        const blocks = Array.isArray(input.blocks) ? input.blocks.filter(
+          (value) => typeof value === "string"
+        ) : void 0;
+        return worktreesFacade.update({
+          id: typeof input.worktreeId === "string" ? input.worktreeId : "",
+          hypothesis: typeof input.hypothesis === "string" ? input.hypothesis : void 0,
+          campaign: typeof input.campaign === "number" ? input.campaign : void 0,
+          lane: typeof input.lane === "string" ? input.lane : void 0,
+          laneOrderInCampaign: typeof input.laneOrderInCampaign === "number" ? input.laneOrderInCampaign : void 0,
+          orderInLane: typeof input.orderInLane === "number" ? input.orderInLane : void 0,
+          dependsOn,
+          blocks,
+          gate: typeof input.gate === "string" ? input.gate : void 0
+        });
       },
       updateTargets(input) {
         return worktreesFacade.updateTargets({
@@ -9083,9 +8954,7 @@ function createLucernClient(config = {}) {
           removeQuestionIds: input.removeQuestionIds
         });
       },
-      listAll(query5 = {}) {
-        return workflowClient.listAllWorktrees(query5);
-      },
+      listAll: workflowClient.listAllWorktrees,
       merge(worktreeId, input) {
         return worktreesFacade.merge({
           id: worktreeId,
@@ -9093,18 +8962,12 @@ function createLucernClient(config = {}) {
           summary: input.summary
         });
       },
-      push(worktreeId, input) {
-        return workflowClient.push(worktreeId, input);
-      },
-      openPullRequest(worktreeId, input) {
-        return workflowClient.openPullRequest(worktreeId, input);
-      },
+      push: workflowClient.push,
+      openPullRequest: workflowClient.openPullRequest,
       pipelineSnapshot(topicId) {
         return functionSurfaceClient.pipelineSnapshot({ topicId });
       },
-      complete(input, idempotencyKey) {
-        return worktreesFacade.complete(input, idempotencyKey);
-      },
+      complete: worktreesFacade.complete,
       advancePhase(worktreeId, idempotencyKey) {
         return worktreesFacade.advancePhase(
           { worktreeId },
@@ -9117,12 +8980,8 @@ function createLucernClient(config = {}) {
           idempotencyKey
         );
       },
-      patchState(input, idempotencyKey) {
-        return worktreesFacade.patchState(input, idempotencyKey);
-      },
-      bulkCreate(input, idempotencyKey) {
-        return worktreesFacade.bulkCreate(input, idempotencyKey);
-      }
+      patchState: worktreesFacade.patchState,
+      bulkCreate: worktreesFacade.bulkCreate
     },
     context: {
       listTopics(query5 = {}) {
@@ -9133,27 +8992,15 @@ function createLucernClient(config = {}) {
           type: query5.type
         });
       },
-      compile(topicId, input = {}) {
-        return contextClient.compile(topicId, input);
-      },
-      recordScopeLearning(input, idempotencyKey) {
-        return functionSurfaceClient.recordScopeLearning(input, idempotencyKey);
-      },
+      compile: contextClient.compile,
+      recordScopeLearning: functionSurfaceClient.recordScopeLearning,
       discover(input) {
         return discoverTopics(input);
       },
-      analyzeTopicDensity(input) {
-        return functionSurfaceClient.analyzeTopicDensity(input);
-      },
-      applyAutoBranching(input, idempotencyKey) {
-        return functionSurfaceClient.applyAutoBranching(input, idempotencyKey);
-      },
-      seedBeliefLattice(input = {}, idempotencyKey) {
-        return functionSurfaceClient.seedBeliefLattice(input, idempotencyKey);
-      },
-      getLatticeCoverage(input = {}) {
-        return functionSurfaceClient.getLatticeCoverage(input);
-      },
+      analyzeTopicDensity: functionSurfaceClient.analyzeTopicDensity,
+      applyAutoBranching: functionSurfaceClient.applyAutoBranching,
+      seedBeliefLattice: functionSurfaceClient.seedBeliefLattice,
+      getLatticeCoverage: functionSurfaceClient.getLatticeCoverage,
       matchEntityType(input) {
         return ontologiesFacade.match(input).then(exposeGatewayData);
       },
@@ -9238,9 +9085,7 @@ function createLucernClient(config = {}) {
           type: input.type
         });
       },
-      get(topicId) {
-        return topicsFacade.get(topicId);
-      },
+      get: topicsFacade.get,
       create(input) {
         return topicsFacade.create({
           name: input.name,
@@ -9285,12 +9130,8 @@ function createLucernClient(config = {}) {
           maxDepth: query5.maxDepth
         });
       },
-      remove(topicId, idempotencyKey) {
-        return topicsFacade.remove(topicId, idempotencyKey);
-      },
-      bulkCreate(input, idempotencyKey) {
-        return topicsFacade.bulkCreate(input, idempotencyKey);
-      }
+      remove: topicsFacade.remove,
+      bulkCreate: topicsFacade.bulkCreate
     },
     answers: {
       create(input) {
@@ -9389,33 +9230,15 @@ function createLucernClient(config = {}) {
       raw: ontologyClient
     },
     coordination: {
-      registerSession(input = {}, idempotencyKey) {
-        return functionSurfaceClient.registerSession(input, idempotencyKey);
-      },
-      heartbeatSession(input = {}, idempotencyKey) {
-        return functionSurfaceClient.heartbeatSession(input, idempotencyKey);
-      },
-      endSession(input = {}, idempotencyKey) {
-        return functionSurfaceClient.endSession(input, idempotencyKey);
-      },
-      listActiveSessions(input = {}) {
-        return functionSurfaceClient.listActiveSessions(input);
-      },
-      sendAgentMessage(input, idempotencyKey) {
-        return functionSurfaceClient.sendAgentMessage(input, idempotencyKey);
-      },
-      broadcastMessage(input, idempotencyKey) {
-        return functionSurfaceClient.broadcastMessage(input, idempotencyKey);
-      },
-      getInbox(input = {}) {
-        return functionSurfaceClient.getAgentInbox(input);
-      },
-      getAgentInbox(input = {}) {
-        return functionSurfaceClient.getAgentInbox(input);
-      },
-      claimFiles(input, idempotencyKey) {
-        return functionSurfaceClient.claimFiles(input, idempotencyKey);
-      }
+      registerSession: functionSurfaceClient.registerSession,
+      heartbeatSession: functionSurfaceClient.heartbeatSession,
+      endSession: functionSurfaceClient.endSession,
+      listActiveSessions: functionSurfaceClient.listActiveSessions,
+      sendAgentMessage: functionSurfaceClient.sendAgentMessage,
+      broadcastMessage: functionSurfaceClient.broadcastMessage,
+      getInbox: functionSurfaceClient.getAgentInbox,
+      getAgentInbox: functionSurfaceClient.getAgentInbox,
+      claimFiles: functionSurfaceClient.claimFiles
     },
     policy: {
       checkPermission(input) {
@@ -9446,38 +9269,24 @@ function createLucernClient(config = {}) {
           principalId: typeof input.principalId === "string" ? input.principalId : void 0
         });
       },
+      // Backward compatibility shim: keep the policy namespace exposing the
+      // historical manageWritePolicy entry point.
       manageWritePolicy(input, idempotencyKey) {
         return functionSurfaceClient.manageWritePolicy(input, idempotencyKey);
       },
       raw: policyClient
     },
     observations: {
-      ingest(input, idempotencyKey) {
-        return functionSurfaceClient.ingestObservation(input, idempotencyKey);
-      },
-      ingestObservation(input, idempotencyKey) {
-        return functionSurfaceClient.ingestObservation(input, idempotencyKey);
-      },
-      getContext(input) {
-        return functionSurfaceClient.getObservationContext(input);
-      },
-      getObservationContext(input) {
-        return functionSurfaceClient.getObservationContext(input);
-      }
+      ingest: functionSurfaceClient.ingestObservation,
+      ingestObservation: functionSurfaceClient.ingestObservation,
+      getContext: functionSurfaceClient.getObservationContext,
+      getObservationContext: functionSurfaceClient.getObservationContext
     },
     coding: {
-      getCodeContext(input) {
-        return functionSurfaceClient.getCodeContext(input);
-      },
-      getChangeHistory(input) {
-        return functionSurfaceClient.getChangeHistory(input);
-      },
-      recordAttempt(input, idempotencyKey) {
-        return functionSurfaceClient.recordAttempt(input, idempotencyKey);
-      },
-      getFailureLog(input) {
-        return functionSurfaceClient.getFailureLog(input);
-      }
+      getCodeContext: functionSurfaceClient.getCodeContext,
+      getChangeHistory: functionSurfaceClient.getChangeHistory,
+      recordAttempt: functionSurfaceClient.recordAttempt,
+      getFailureLog: functionSurfaceClient.getFailureLog
     },
     contracts: {
       create(input) {
@@ -9503,9 +9312,7 @@ function createLucernClient(config = {}) {
       }
     },
     bootstrap: {
-      generateSessionHandoff(input) {
-        return functionSurfaceClient.generateSessionHandoff(input);
-      }
+      generateSessionHandoff: functionSurfaceClient.generateSessionHandoff
     },
     embeddings: embeddingsClient,
     graphAnalysis: graphAnalysisClient,
@@ -9527,25 +9334,15 @@ function createLucernClient(config = {}) {
       createAcl: toolRegistryClient.createAcl,
       deleteAcl: toolRegistryClient.deleteAcl,
       registerCustomTool: toolRegistryClient.registerCustomTool,
-      register(registration) {
-        return registerCustomTool(registration);
-      },
-      unregister(fullName) {
-        return unregisterCustomTool(fullName);
-      },
-      list() {
-        return listRegisteredCustomTools();
-      },
-      clear() {
-        clearRegisteredCustomTools();
-      },
+      register: registerCustomTool,
+      unregister: unregisterCustomTool,
+      list: listRegisteredCustomTools,
+      clear: clearRegisteredCustomTools,
       invoke(name, input = {}) {
         const fullName = name.includes(".") ? name : `custom.${name}`;
         return invokeCustomTool(fullName, input);
       },
-      namespace(namespace) {
-        return getCustomNamespace(namespace);
-      }
+      namespace: getCustomNamespace
     },
     packs: {
       /**
@@ -9560,27 +9357,13 @@ function createLucernClient(config = {}) {
       get isInstalled() {
         return _packInstalled;
       },
-      listCatalog() {
-        return packsClient.listCatalog();
-      },
-      catalog() {
-        return packsClient.getCatalog();
-      },
-      listStates(scope) {
-        return packsClient.listStates(scope);
-      },
-      states(scope) {
-        return packsClient.getStates(scope);
-      },
-      install(input) {
-        return packsClient.install(input);
-      },
-      enable(input) {
-        return packsClient.enable(input);
-      },
-      disable(input) {
-        return packsClient.disable(input);
-      }
+      listCatalog: packsClient.listCatalog,
+      catalog: packsClient.listCatalog,
+      listStates: packsClient.listStates,
+      states: packsClient.getStates,
+      install: packsClient.install,
+      enable: packsClient.enable,
+      disable: packsClient.disable
     },
     nodes: nodesNamespace,
     identity: {
@@ -9593,30 +9376,16 @@ function createLucernClient(config = {}) {
       raw: identityClient
     },
     mcp: {
-      bootstrapSession(input) {
-        return mcpClient.bootstrapSession(input);
-      },
-      checkWritePolicy(input) {
-        return mcpClient.checkWritePolicy(input);
-      },
-      beginBuildSession(input) {
-        return mcpClient.beginBuildSession(input);
-      },
-      evaluateEngineeringContract(input) {
-        return mcpClient.evaluateEngineeringContract(input);
-      },
-      evaluateResearchContract(input) {
-        return mcpClient.evaluateResearchContract(input);
-      }
+      bootstrapSession: mcpClient.bootstrapSession,
+      checkWritePolicy: mcpClient.checkWritePolicy,
+      beginBuildSession: mcpClient.beginBuildSession,
+      evaluateEngineeringContract: mcpClient.evaluateEngineeringContract,
+      evaluateResearchContract: mcpClient.evaluateResearchContract
     },
     auth: {
       device: {
-        createCode(input) {
-          return authDeviceClient.createDeviceCode(input);
-        },
-        pollToken(deviceCode) {
-          return authDeviceClient.pollDeviceToken(deviceCode);
-        }
+        createCode: authDeviceClient.createDeviceCode,
+        pollToken: authDeviceClient.pollDeviceToken
       }
     },
     custom: getCustomNamespace("custom"),
@@ -9669,50 +9438,55 @@ function cleanNumber2(value) {
 function cleanBoolean2(value) {
   return typeof value === "boolean" ? value : void 0;
 }
-function buildCompileContextRequest2(topicId, input = {}) {
-  const payload = { topicId };
-  const query5 = cleanString6(input.query);
+function buildCompileContextRequest2(topicIdOrInput = {}, input = {}) {
+  const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
+  const payload = {};
+  const topicId = typeof topicIdOrInput === "string" ? cleanString6(topicIdOrInput) : cleanString6(effectiveInput.topicId);
+  if (topicId) {
+    payload.topicId = topicId;
+  }
+  const query5 = cleanString6(effectiveInput.query);
   if (query5) {
     payload.query = query5;
   }
-  const budget = cleanNumber2(input.budget) ?? cleanNumber2(input.tokenBudget);
+  const budget = cleanNumber2(effectiveInput.budget) ?? cleanNumber2(effectiveInput.tokenBudget);
   if (budget !== void 0) {
     payload.budget = budget;
   }
-  const ranking = cleanString6(input.ranking) ?? cleanString6(input.rankingProfile);
+  const ranking = cleanString6(effectiveInput.ranking) ?? cleanString6(effectiveInput.rankingProfile);
   if (ranking) {
     payload.ranking = ranking;
   }
-  const limit = cleanNumber2(input.limit);
+  const limit = cleanNumber2(effectiveInput.limit);
   if (limit !== void 0) {
     payload.limit = limit;
   }
-  const maxDepth = cleanNumber2(input.maxDepth);
+  const maxDepth = cleanNumber2(effectiveInput.maxDepth);
   if (maxDepth !== void 0) {
     payload.maxDepth = maxDepth;
   }
-  const includeEntities = cleanBoolean2(input.includeEntities);
+  const includeEntities = cleanBoolean2(effectiveInput.includeEntities);
   if (includeEntities !== void 0) {
     payload.includeEntities = includeEntities;
   }
-  const mode = cleanString6(input.mode);
+  const mode = cleanString6(effectiveInput.mode);
   if (mode) {
     payload.mode = mode;
   }
-  const includeFailures = cleanBoolean2(input.includeFailures);
+  const includeFailures = cleanBoolean2(effectiveInput.includeFailures);
   if (includeFailures !== void 0) {
     payload.includeFailures = includeFailures;
   }
-  const worktreeId = cleanString6(input.worktreeId);
+  const worktreeId = cleanString6(effectiveInput.worktreeId);
   if (worktreeId) {
     payload.worktreeId = worktreeId;
   }
-  const sessionId = cleanString6(input.sessionId);
+  const sessionId = cleanString6(effectiveInput.sessionId);
   if (sessionId) {
     payload.sessionId = sessionId;
   }
-  if (Array.isArray(input.packWeightOverrides) && input.packWeightOverrides.length > 0) {
-    payload.packWeightOverrides = input.packWeightOverrides;
+  if (Array.isArray(effectiveInput.packWeightOverrides) && effectiveInput.packWeightOverrides.length > 0) {
+    payload.packWeightOverrides = effectiveInput.packWeightOverrides;
   }
   return {
     path: "/api/platform/v1/context/compile",
@@ -9722,8 +9496,12 @@ function buildCompileContextRequest2(topicId, input = {}) {
 }
 function createContextFacade(config) {
   return {
-    compile(topicId, input = {}) {
-      const request = buildCompileContextRequest2(topicId, input);
+    compile(topicIdOrInput = {}, input = {}) {
+      const request = buildCompileContextRequest2(topicIdOrInput, input);
+      return config.transport.request(request);
+    },
+    compileByQuery(input = {}) {
+      const request = buildCompileContextRequest2(input);
       return config.transport.request(request);
     }
   };
@@ -9802,17 +9580,11 @@ var TOKENS_PER_WORD = 1.35;
 var MIN_TOKEN_ESTIMATE = 8;
 
 // ../sdk/src/contextPackPolicy.ts
-function nowMs() {
-  return Date.now();
-}
-function normalizeText(text) {
-  return text.trim().toLowerCase();
-}
 function tokenHits(text, tokens) {
   if (tokens.length === 0) {
     return 1;
   }
-  const haystack = normalizeText(text);
+  const haystack = text.trim().toLowerCase();
   let hits = 0;
   for (const token of tokens) {
     if (haystack.includes(token)) {
@@ -9827,7 +9599,7 @@ function clamp013(value) {
   }
   return Math.max(0, Math.min(1, value));
 }
-function recencyScore(updatedAt, referenceTimeMs = nowMs()) {
+function recencyScore(updatedAt, referenceTimeMs = Date.now()) {
   if (!updatedAt || !Number.isFinite(updatedAt)) {
     return 0.25;
   }
@@ -9843,15 +9615,15 @@ function confidenceScore(confidence) {
   return clamp013(confidence);
 }
 function priorityScore(priority) {
-  const value = normalizeText(priority || "");
+  const value = (priority || "").trim().toLowerCase();
   return PRIORITY_SCORES[value] ?? DEFAULT_PRIORITY_SCORE;
 }
 function severityScore(severity) {
-  const value = normalizeText(severity || "");
+  const value = (severity || "").trim().toLowerCase();
   return SEVERITY_SCORES[value] ?? DEFAULT_SEVERITY_SCORE;
 }
 function beliefTypeBonus(beliefType) {
-  const value = normalizeText(beliefType || "");
+  const value = (beliefType || "").trim().toLowerCase();
   return BELIEF_TYPE_BONUS[value] ?? DEFAULT_BELIEF_TYPE_BONUS;
 }
 function resolveEffectiveWeights(overrides) {
@@ -9877,7 +9649,7 @@ function generateJustification(_section, candidate, queryTokens, weights) {
   }
   const ts = candidate.updatedAt || candidate.createdAt || null;
   if (ts && Number.isFinite(ts)) {
-    const ageDays = Math.max(0, nowMs() - ts) / (1e3 * 60 * 60 * 24);
+    const ageDays = Math.max(0, Date.now() - ts) / (1e3 * 60 * 60 * 24);
     if (ageDays < 1) {
       parts.push("updated today");
     } else if (ageDays < 7) {
@@ -9902,10 +9674,6 @@ function generateJustification(_section, candidate, queryTokens, weights) {
   }
   return parts.join(", ");
 }
-function computeBaselineScore(candidate, queryTokens) {
-  const hits = tokenHits(candidate.text, queryTokens);
-  return queryTokens.length === 0 ? 1 : hits;
-}
 function computeWeightedScore(section, candidate, queryTokens, effectiveWeights, referenceTimeMs) {
   const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
   const queryComponent = queryTokens.length === 0 ? 0.4 : clamp013(tokenHits(candidate.text, queryTokens) / queryTokens.length);
@@ -9939,7 +9707,7 @@ function rankContextSection(section, rows, queryTokens, limit, profile, options)
       queryTokens,
       effectiveWeights,
       referenceTimeMs
-    ) : computeBaselineScore(row, queryTokens);
+    ) : queryTokens.length === 0 ? 1 : tokenHits(row.text, queryTokens);
     const result = { ...row, score };
     if (includeJustifications && profile === "weighted_v1") {
       const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
@@ -10306,18 +10074,21 @@ function normalizeQueryTokens(query5) {
 function parseRankingProfile(value) {
   return value === "baseline_v1" ? "baseline_v1" : "weighted_v1";
 }
+function isRecord5(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function beliefTypeOf(node) {
   if (typeof node.beliefType === "string") {
     return node.beliefType;
   }
-  const metadata = node.metadata || {};
+  const metadata = isRecord5(node.metadata) ? node.metadata : {};
   if (typeof metadata.beliefType === "string") {
     return metadata.beliefType;
   }
   return "";
 }
 function questionStatusOf(node) {
-  const metadata = node.metadata || {};
+  const metadata = isRecord5(node.metadata) ? node.metadata : {};
   const direct = typeof node.status === "string" ? node.status : "";
   const questionStatus = typeof metadata.questionStatus === "string" ? metadata.questionStatus : "";
   return (questionStatus || direct || "open").toLowerCase();
@@ -10333,9 +10104,6 @@ function isOpenQuestion(status) {
     "belief_forked"
   ].includes(status);
 }
-function metadataText(payload) {
-  return JSON.stringify(payload).toLowerCase();
-}
 function collectTopicNeighborhood(topics2, rootTopicId, maxDescendantDepth = 2) {
   const byId = /* @__PURE__ */ new Map();
   const children = /* @__PURE__ */ new Map();
@@ -10397,11 +10165,10 @@ function dedupeById(rows) {
   return output;
 }
 function candidateTimestamp(candidate) {
-  if (!candidate || typeof candidate !== "object") {
+  if (!isRecord5(candidate)) {
     return 0;
   }
-  const record = candidate;
-  const timestamps = [record.updatedAt, record.createdAt, record.generatedAt].filter(
+  const timestamps = [candidate.updatedAt, candidate.createdAt, candidate.generatedAt].filter(
     (value) => typeof value === "number" && Number.isFinite(value)
   );
   return timestamps.length > 0 ? Math.max(...timestamps) : 0;
@@ -10523,7 +10290,7 @@ function compileContextPackFromSnapshot(snapshot) {
     beliefType: beliefTypeOf(belief) || null,
     status: belief.status || "active",
     updatedAt: belief.updatedAt || belief.createdAt || null,
-    metadataText: belief.metadata && typeof belief.metadata === "object" ? metadataText(belief.metadata) : ""
+    metadataText: belief.metadata && typeof belief.metadata === "object" ? JSON.stringify(belief.metadata).toLowerCase() : ""
   }));
   const activeBeliefs = rankContextSection(
     "activeBeliefs",
@@ -10555,7 +10322,7 @@ function compileContextPackFromSnapshot(snapshot) {
       status,
       priority: typeof metadata.priority === "string" ? metadata.priority : "medium",
       updatedAt: question.updatedAt || question.createdAt || null,
-      metadataText: metadataText(metadata)
+      metadataText: JSON.stringify(metadata).toLowerCase()
     };
   }).filter((row) => isOpenQuestion(row.status));
   const openQuestions = rankContextSection(
@@ -10587,7 +10354,7 @@ function compileContextPackFromSnapshot(snapshot) {
       kind: typeof metadata.kind === "string" && metadata.kind || "observation",
       createdAt: item.createdAt || null,
       updatedAt: item.updatedAt || item.createdAt || null,
-      metadataText: metadataText(metadata)
+      metadataText: JSON.stringify(metadata).toLowerCase()
     };
   });
   const recentEvidence = rankContextSection(
@@ -10669,7 +10436,7 @@ function compileContextPackFromSnapshot(snapshot) {
   let failureContext;
   if (snapshot.plan.includeFailures && snapshot.failures) {
     const allFailures = snapshot.failures.filter((node) => {
-      const metadata = node.metadata || {};
+      const metadata = isRecord5(node.metadata) ? node.metadata : {};
       return metadata.failedApproach === true || metadata.isFailedAttempt === true;
     });
     const rankedFailures = rankContextSection(
@@ -10687,7 +10454,7 @@ function compileContextPackFromSnapshot(snapshot) {
     );
     const failures = rankedFailures.map((row) => {
       const original = allFailures.find((node) => String(node._id) === row.id);
-      const metadata = original?.metadata || {};
+      const metadata = isRecord5(original?.metadata) ? original?.metadata : {};
       return {
         attemptId: row.id,
         approach: String(row.text || ""),
@@ -11171,9 +10938,7 @@ function lastDelegator(delegationChain) {
 
 // ../sdk/src/contracts/lens-filter.contract.ts
 function isLensFilterCriteria(value) {
-  if (!value || typeof value !== "object") return false;
-  const obj = value;
-  return typeof obj.version === "number" && typeof obj.kind === "string";
+  return isRecord6(value) && typeof value.version === "number" && typeof value.kind === "string";
 }
 function isTaxonomyFilterCriteriaV1(value) {
   if (!isLensFilterCriteria(value)) return false;
@@ -11202,6 +10967,9 @@ function validateFilterCriteria(value) {
     ]
   };
 }
+function isRecord6(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function validateTaxonomyFilterV1(criteria) {
   const errors = [];
   if (!Array.isArray(criteria.entityTypeFilters)) {
@@ -11715,9 +11483,16 @@ var ADD_WORKTREE = {
     },
     projectId: {
       type: "string",
-      description: "Legacy topicId alias"
+      description: "Legacy topicId alias or resolver hint"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope hint for resolver validation"
+    },
+    topicHint: {
+      type: "string",
+      description: "Natural-language topic hint for automatic topic resolution"
     },
-    topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
       description: "The branch this worktree investigates"
@@ -11815,6 +11590,22 @@ var ADD_WORKTREE = {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
     },
+    tags: {
+      type: "array",
+      description: "Additional topic-resolution tags for the worktree"
+    },
+    touchedPaths: {
+      type: "array",
+      description: "File paths used as topic-resolution signals"
+    },
+    sourceRef: {
+      type: "string",
+      description: "Source reference used as a topic-resolution signal"
+    },
+    sourceKind: {
+      type: "string",
+      description: "Source kind used as a topic-resolution signal"
+    },
     campaign: {
       type: "number",
       description: "Top-level pipeline campaign number. Campaigns define the outer execution slice."
@@ -11852,7 +11643,7 @@ var ADD_WORKTREE = {
       description: "Timestamp when worktree metadata was last reconciled"
     }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created worktree",
     fields: {
@@ -13349,15 +13140,15 @@ var IDENTITY_WHOAMI = {
 };
 var COMPILE_CONTEXT = {
   name: "compile_context",
-  description: "Compile a focused reasoning context for a topic. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
+  description: "Compile a focused reasoning context. If topicId is omitted, Lucern resolves the best topic from the query. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
   parameters: {
     topicId: {
       type: "string",
-      description: "Topic scope ID to compile"
+      description: "Optional topic scope ID. Omit to resolve the topic from query."
     },
     query: {
       type: "string",
-      description: "Optional focus query used to rank context items"
+      description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
     },
     budget: {
       type: "number",
@@ -13381,7 +13172,7 @@ var COMPILE_CONTEXT = {
       description: "Include related ontological entities in the compiled result"
     }
   },
-  required: ["topicId"],
+  required: [],
   response: {
     description: "Compiled context pack for the requested topic",
     fields: {
@@ -13555,18 +13346,60 @@ var CREATE_TASK = {
   name: "create_task",
   description: "Create an execution task tied to the reasoning state. Like `git task` \u2014 tracks concrete work items (calls to make, data to gather, analyses to run) linked to questions, beliefs, or worktrees.",
   parameters: {
-    title: { type: "string", description: "Task description" },
+    title: { type: "string", description: "Task title" },
     topicId: { type: "string", description: "Topic scope" },
+    description: {
+      type: "string",
+      description: "Long-form task description"
+    },
     taskType: {
       type: "string",
-      description: "Type: research, interview, analysis, data_collection",
-      enum: ["research", "interview", "analysis", "data_collection"]
+      description: "Task taxonomy",
+      enum: [
+        "general",
+        "find_evidence",
+        "verify_claim",
+        "research",
+        "review",
+        "interview",
+        "analysis",
+        "track_metrics"
+      ]
+    },
+    priority: {
+      type: "string",
+      description: "Priority",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    status: {
+      type: "string",
+      description: "Initial status (defaults to todo)",
+      enum: ["todo", "in_progress", "blocked", "done"]
+    },
+    linkedWorktreeId: {
+      type: "string",
+      description: "Worktree this task belongs to"
+    },
+    linkedBeliefId: {
+      type: "string",
+      description: "Belief this task supports"
     },
     linkedQuestionId: {
       type: "string",
       description: "Question this task addresses"
     },
-    linkedWorktreeId: { type: "string", description: "Worktree scope" }
+    assigneeId: {
+      type: "string",
+      description: "Principal assigned to the task"
+    },
+    dueDate: {
+      type: "number",
+      description: "Due date as epoch milliseconds"
+    },
+    tags: {
+      type: "array",
+      description: "Free-form string tags"
+    }
   },
   required: ["title"],
   response: {
@@ -15923,6 +15756,9 @@ function fromBase64(value) {
   const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
   return decodeURIComponent(escape(atob(normalized)));
 }
+function isRecord7(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function createEventId() {
   const random = typeof globalThis.crypto?.randomUUID === "function" ? globalThis.crypto.randomUUID().replace(/-/g, "") : Array.from(
     typeof globalThis.crypto?.getRandomValues === "function" ? globalThis.crypto.getRandomValues(new Uint8Array(16)) : Array.from({ length: 16 }, () => Math.floor(Math.random() * 256)),
@@ -15971,14 +15807,14 @@ function decodeEventCursor(cursor) {
   }
   try {
     const parsed = JSON.parse(fromBase64(cursor.trim()));
-    if (typeof parsed.timestamp !== "number" || !Number.isFinite(parsed.timestamp) || typeof parsed.eventId !== "string" || parsed.eventId.trim().length === 0) {
+    if (!isRecord7(parsed) || typeof parsed.timestamp !== "number" || !Number.isFinite(parsed.timestamp) || typeof parsed.eventId !== "string" || parsed.eventId.trim().length === 0) {
       return null;
     }
     return {
       timestamp: parsed.timestamp,
       eventId: parsed.eventId.trim()
     };
-  } catch {
+  } catch (error) {
     return null;
   }
 }
@@ -16007,7 +15843,7 @@ var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "::1"])
 function normalizeUrl(url) {
   try {
     return new URL(url.trim());
-  } catch {
+  } catch (error) {
     throw new Error("Webhook URL must be a valid absolute URL.");
   }
 }
@@ -21140,6 +20976,11 @@ var TENANT_CLIENT_INSTALLABLE_PACKAGES = [
     role: "sdk_dependency",
     directTenantImport: false
   },
+  {
+    packageName: "@lucern/graph-sync",
+    role: "host_addon_runtime",
+    directTenantImport: true
+  },
   {
     packageName: "@lucern/identity",
     role: "component_runtime",
@@ -21428,8 +21269,11 @@ function compactRecord(input) {
     Object.entries(input).filter(([, value]) => value !== void 0)
   );
 }
+function isRecord8(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function recordValue(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return isRecord8(value) ? value : {};
 }
 var createEvidenceProjection = defineProjection({
   contractName: "create_evidence",
@@ -21864,9 +21708,7 @@ function mcpContractFromArgsSchema(base, args, contractName) {
     required: converted.filter(([, field]) => field.required).map(([fieldName]) => fieldName)
   };
 }
-function defineFunctionContract(contract) {
-  return contract;
-}
+var defineFunctionContract = (contract) => contract;
 function authUserId(context) {
   return context.userId ?? context.principalId ?? "lucern-agent";
 }
@@ -22020,6 +21862,9 @@ var observationContextArgs = z.object({
   limit: z.number().optional().describe("Maximum observations to return."),
   status: z.string().optional().describe("Observation status filter.")
 });
+function isRecord9(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 var observationInput = (input, context) => withUserId(
   compactRecord4({
     projectId: input.projectId,
@@ -22052,7 +21897,7 @@ var contextContracts = [
     path: "/context/compile",
     sdkNamespace: "context",
     sdkMethod: "compileContext",
-    summary: "Compile a focused reasoning context for a topic.",
+    summary: "Compile a focused reasoning context, resolving topic from query when omitted.",
     convex: {
       module: "contextCompiler",
       functionName: "compile",
@@ -22074,8 +21919,8 @@ var contextContracts = [
       kind: "mutation",
       inputProjection: observationInput,
       outputProjection: (output, input) => ({
-        ...output && typeof output === "object" ? output : {},
-        observationId: output && typeof output === "object" ? output.nodeId : void 0,
+        ...isRecord9(output) ? output : {},
+        observationId: isRecord9(output) ? output.nodeId : void 0,
         observationType: input.observationType
       })
     },
@@ -23556,10 +23401,11 @@ var worktreeDecisionGateInputSchema = z.object({
   decidedBy: z.string().optional().describe("Actor that decided the gate verdict.")
 }).passthrough().describe("Decision gate contract for worktree activation or exit.");
 var addWorktreeArgs = z.object({
-  title: z.string().optional().describe("Human-readable worktree name or objective."),
+  title: z.string().describe("Human-readable worktree name or objective."),
   name: z.string().optional().describe("Storage-name alias for callers that already use backend naming."),
-  topicId: z.string().describe("Primary topic scope for the worktree."),
-  projectId: z.string().optional().describe("Legacy topicId alias."),
+  topicId: z.string().optional().describe("Optional primary topic scope hint for resolver validation."),
+  projectId: z.string().optional().describe("Legacy topicId alias/hint."),
+  topicHint: z.string().optional().describe("Natural-language topic hint for automatic topic resolution."),
   branchId: z.string().optional().describe("Legacy branch identifier for compatibility with workflow callers."),
   objective: z.string().optional().describe("Reasoning objective this worktree is intended to resolve."),
   hypothesis: z.string().optional().describe("Testable claim this worktree investigates."),
@@ -23584,6 +23430,10 @@ var addWorktreeArgs = z.object({
   autoShape: z.boolean().optional().describe("Whether to invoke inquiry auto-shaping during creation."),
   autoFixPolicy: autoFixPolicyInputSchema.optional(),
   domainPackId: z.string().optional().describe("Domain pack whose shaping hooks should influence the worktree."),
+  tags: z.array(z.string()).optional().describe("Additional topic-resolution tags for the worktree."),
+  touchedPaths: z.array(z.string()).optional().describe("File paths used as topic-resolution signals."),
+  sourceRef: z.string().optional().describe("Source reference used as a topic-resolution signal."),
+  sourceKind: z.string().optional().describe("Source kind used as a topic-resolution signal."),
   campaign: z.number().optional().describe("Top-level pipeline campaign number."),
   lane: z.string().optional().describe("Campaign lane for the worktree."),
   laneOrderInCampaign: z.number().optional().describe("Ordering for this lane within its campaign."),
@@ -23913,8 +23763,46 @@ var worktreesContracts = [
     args: openPullRequestArgs
   })
 ];
-
-// ../contracts/src/function-registry/tasks.ts
+var taskPrioritySchema = z.enum(["urgent", "high", "medium", "low"]);
+var taskStatusSchema2 = z.enum(["todo", "in_progress", "blocked", "done"]);
+var taskTypeSchema = z.enum([
+  "general",
+  "find_evidence",
+  "verify_claim",
+  "research",
+  "review",
+  "interview",
+  "analysis",
+  "track_metrics"
+]);
+var createTaskArgs = z.object({
+  title: z.string().describe("Task title."),
+  topicId: z.string().optional().describe("Topic scope."),
+  description: z.string().optional().describe("Long-form task description."),
+  taskType: taskTypeSchema.optional().describe("Task taxonomy."),
+  priority: taskPrioritySchema.optional().describe("Priority. Defaults to medium when omitted by the server."),
+  status: taskStatusSchema2.optional().describe("Initial status. Defaults to todo."),
+  linkedWorktreeId: z.string().optional().describe("Worktree this task belongs to."),
+  linkedBeliefId: z.string().optional().describe("Belief this task supports."),
+  linkedQuestionId: z.string().optional().describe("Question this task addresses."),
+  assigneeId: z.string().optional().describe("Principal assigned to the task."),
+  dueDate: z.number().optional().describe("Due date as epoch milliseconds."),
+  tags: z.array(z.string()).optional().describe("Free-form tags.")
+});
+var createTaskInput = (input) => compactRecord4({
+  title: input.title,
+  topicId: input.topicId,
+  description: input.description,
+  taskType: input.taskType,
+  priority: input.priority ?? "medium",
+  status: input.status ?? "todo",
+  linkedWorktreeId: input.linkedWorktreeId,
+  linkedBeliefId: input.linkedBeliefId,
+  linkedQuestionId: input.linkedQuestionId,
+  assigneeId: input.assigneeId,
+  dueDate: input.dueDate,
+  tags: input.tags
+});
 var taskInput = (input) => compactRecord4({
   ...input,
   taskId: input.taskId ?? input.id
@@ -23946,8 +23834,10 @@ var tasksContracts = [
     convex: {
       module: "tasks",
       functionName: "create",
-      kind: "mutation"
-    }
+      kind: "mutation",
+      inputProjection: createTaskInput
+    },
+    args: createTaskArgs
   }),
   surfaceContract({
     name: "list_tasks",
@@ -25066,9 +24956,12 @@ var ALL_FUNCTION_CONTRACTS = [
 ];
 assertSurfaceCoverage(ALL_FUNCTION_CONTRACTS);
 var FUNCTION_SURFACE_CONTRACTS = ALL_FUNCTION_CONTRACTS;
-new Map(
+var FUNCTION_CONTRACTS_BY_NAME = new Map(
   ALL_FUNCTION_CONTRACTS.map((contract) => [contract.name, contract])
 );
+FUNCTION_CONTRACTS_BY_NAME.get.bind(
+  FUNCTION_CONTRACTS_BY_NAME
+);
 
 // ../contracts/src/tenant-bootstrap-seed.contract.ts
 function isCopyableSeedRequirement(entry) {
@@ -25714,10 +25607,18 @@ function isInfisicalRuntimeDisabled(env = {}) {
 }
 async function hydrateInfisicalRuntimeEnv(options) {
   const env = options.env ?? {};
-  const bootstrap = mergeBootstrap(
-    readInfisicalRuntimeBootstrap(env, options.bootstrap),
-    options.bootstrap
-  );
+  const baseBootstrap = readInfisicalRuntimeBootstrap(env, options.bootstrap);
+  const bootstrap = baseBootstrap ? {
+    ...baseBootstrap,
+    ...Object.fromEntries(
+      Object.entries(options.bootstrap ?? {}).filter(
+        ([, value]) => value !== void 0
+      )
+    ),
+    apiUrl: trimTrailingSlash(
+      options.bootstrap?.apiUrl ?? baseBootstrap.apiUrl
+    )
+  } : null;
   if (!bootstrap) {
     return {
       status: "disabled",
@@ -25813,16 +25714,6 @@ function normalizeInfisicalEnvironment(value) {
   }
   return "prod";
 }
-function mergeBootstrap(base, overrides) {
-  if (!base) {
-    return null;
-  }
-  return {
-    ...base,
-    ...compact(overrides ?? {}),
-    apiUrl: trimTrailingSlash(overrides?.apiUrl ?? base.apiUrl)
-  };
-}
 async function loginWithUniversalAuth(bootstrap, fetchImpl) {
   const response = await fetchImpl(
     `${trimTrailingSlash(bootstrap.apiUrl)}/api/v1/auth/universal-auth/login`,
@@ -25907,14 +25798,18 @@ async function readSecretValue(args) {
 async function readJson2(response) {
   try {
     return await response.json();
-  } catch {
+  } catch (error) {
+    debugInfisicalRuntimeFallback("response.json", error);
     return void 0;
   }
 }
+function isRecord10(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function readNestedString(value, path2) {
   let current = value;
   for (const key of path2) {
-    if (!current || typeof current !== "object" || !(key in current)) {
+    if (!isRecord10(current) || !(key in current)) {
       return null;
     }
     current = current[key];
@@ -25922,13 +25817,12 @@ function readNestedString(value, path2) {
   return typeof current === "string" && current.length > 0 ? current : null;
 }
 function messageFromBody(body4) {
-  if (!body4 || typeof body4 !== "object") {
+  if (!isRecord10(body4)) {
     return "no response body";
   }
-  const record = body4;
   for (const key of ["message", "error", "errorMessage"]) {
-    if (typeof record[key] === "string") {
-      return record[key];
+    if (typeof body4[key] === "string") {
+      return body4[key];
     }
   }
   return JSON.stringify(body4);
@@ -25948,10 +25842,32 @@ function isTruthyEnv(value) {
 function trimTrailingSlash(value) {
   return value.replace(/\/+$/u, "");
 }
-function compact(value) {
-  return Object.fromEntries(
-    Object.entries(value).filter(([, entry]) => entry !== void 0)
-  );
+function debugInfisicalRuntimeFallback(message, error) {
+  const env = globalThis.process?.env;
+  if (env?.LUCERN_COMPAT_FALLBACK_DEBUG !== "1" && env?.LUCERN_INFISICAL_RUNTIME_DEBUG !== "1") {
+    return;
+  }
+  console.debug(`[infisical-runtime] ${message}`, {
+    error: formatInfisicalRuntimeError(error)
+  });
+}
+function formatInfisicalRuntimeError(error) {
+  if (error instanceof Error) {
+    return `${error.name}: ${error.message}`;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (typeof error === "number" || typeof error === "boolean") {
+    return String(error);
+  }
+  if (error && typeof error === "object") {
+    const keys = Object.keys(error).slice(0, 5);
+    if (keys.length > 0) {
+      return `Unknown Infisical runtime error object with keys: ${keys.join(", ")}`;
+    }
+  }
+  return "Unknown Infisical runtime error shape";
 }
 
 // src/execution.ts
@@ -25998,6 +25914,9 @@ function hasValue(value) {
   }
   return true;
 }
+function isRecord11(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function normalizeToolExecutionParams(params) {
   const normalized = { ...params };
   for (const aliases of SCOPE_ALIAS_GROUPS) {
@@ -26020,16 +25939,19 @@ function parseToolExecutionMetadata(result) {
   }
   try {
     const payload = JSON.parse(raw);
+    if (!isRecord11(payload)) {
+      return { isError: Boolean(result.isError) };
+    }
     return {
       isError: Boolean(result.isError),
       code: typeof payload.code === "string" ? payload.code : void 0,
       status: typeof payload.status === "number" ? payload.status : void 0,
-      correlationId: typeof payload.correlationId === "string" || payload.correlationId === null ? payload.correlationId : void 0,
-      policyTraceId: typeof payload.policyTraceId === "string" || payload.policyTraceId === null ? payload.policyTraceId : void 0,
-      invariant: typeof payload.invariant === "string" || payload.invariant === null ? payload.invariant : void 0
+      correlationId: optionalStringOrNull(payload.correlationId),
+      policyTraceId: optionalStringOrNull(payload.policyTraceId),
+      invariant: optionalStringOrNull(payload.invariant)
     };
-  } catch {
-    return { isError: Boolean(result.isError) };
+  } catch (error) {
+    return ignoreMalformedToolMetadata(error, result);
   }
 }
 async function executeToolWithEnvelope(args) {
@@ -26047,6 +25969,15 @@ async function executeToolWithEnvelope(args) {
   });
   return result;
 }
+function ignoreMalformedToolMetadata(_error, result) {
+  return { isError: Boolean(result.isError) };
+}
+function optionalStringOrNull(value) {
+  if (typeof value === "string" || value === null) {
+    return value;
+  }
+  return void 0;
+}
 
 // src/types.ts
 var McpHandlerError = class extends Error {
@@ -26433,24 +26364,27 @@ function readResultString(value, key) {
 }
 function createContextHandlers(context) {
   const compiler = createContextClient(context.sdkConfig);
+  const functionSurface = createFunctionSurfaceClient(context.sdkConfig);
   return {
     compile_context: contractToHandler(
       MCP_TOOL_CONTRACTS.compile_context,
       async (params) => {
-        const topicId = readTopicId4(params, { required: true });
-        const response = await compiler.compile(
-          topicId,
-          {
-            ...readString3(params, "query") ? { query: readString3(params, "query") } : {},
-            ...readNumber2(params, "budget") !== void 0 ? { budget: readNumber2(params, "budget") } : {},
-            ...readString3(params, "ranking") ? {
-              ranking: readString3(params, "ranking")
-            } : {},
-            ...readNumber2(params, "limit") !== void 0 ? { limit: readNumber2(params, "limit") } : {},
-            ...readNumber2(params, "maxDepth") !== void 0 ? { maxDepth: readNumber2(params, "maxDepth") } : {},
-            ...readBoolean(params, "includeEntities") !== void 0 ? { includeEntities: readBoolean(params, "includeEntities") } : {}
-          }
-        );
+        const topicId = readTopicId4(params);
+        const query5 = readString3(params, "query");
+        const input = {
+          ...query5 ? { query: query5 } : {},
+          ...readNumber2(params, "budget") !== void 0 ? { budget: readNumber2(params, "budget") } : {},
+          ...readString3(params, "ranking") ? {
+            ranking: readString3(params, "ranking")
+          } : {},
+          ...readNumber2(params, "limit") !== void 0 ? { limit: readNumber2(params, "limit") } : {},
+          ...readNumber2(params, "maxDepth") !== void 0 ? { maxDepth: readNumber2(params, "maxDepth") } : {},
+          ...readBoolean(params, "includeEntities") !== void 0 ? { includeEntities: readBoolean(params, "includeEntities") } : {}
+        };
+        if (!topicId && !query5) {
+          throw new Error("[compile_context] query is required when topicId is omitted.");
+        }
+        const response = topicId ? await compiler.compile(topicId, input) : await functionSurface.compileContext(input);
         writeLocalLucernContext({
           topicId: readResultString(response.data, "topicId") ?? topicId,
           topicName: readResultString(response.data, "topicName"),
@@ -27556,18 +27490,22 @@ function createWorktreeHandlers(context) {
       MCP_TOOL_CONTRACTS.add_worktree,
       async (params) => {
         const topicId = readTopicId4(params);
-        if (!topicId) {
-          throw new Error("add_worktree requires topicId");
-        }
         const result = await workflow.addWorktree({
           title: readString3(params, "title", { required: true }),
           topicId,
+          topicHint: readString3(params, "topicHint"),
           branchId: readString3(params, "branchId"),
           objective: readString3(params, "objective"),
           hypothesis: readString3(params, "hypothesis"),
+          rationale: readString3(params, "rationale"),
+          worktreeType: readString3(params, "worktreeType"),
           beliefIds: readStringArray(params, "beliefIds"),
           autoShape: readBoolean(params, "autoShape"),
           domainPackId: readString3(params, "domainPackId"),
+          tags: readStringArray(params, "tags"),
+          touchedPaths: readStringArray(params, "touchedPaths"),
+          sourceRef: readString3(params, "sourceRef"),
+          sourceKind: readString3(params, "sourceKind"),
           campaign: typeof params.campaign === "number" ? params.campaign : void 0,
           lane: readString3(params, "lane"),
           laneOrderInCampaign: typeof params.laneOrderInCampaign === "number" ? params.laneOrderInCampaign : void 0,
@@ -27687,8 +27625,8 @@ function loadMcpSdk() {
   try {
     const dynamicRequire = eval("require");
     return dynamicRequire("@modelcontextprotocol/sdk") ?? {};
-  } catch {
-    return {};
+  } catch (error) {
+    return ignoreMcpSdkLoadError();
   }
 }
 var MCP_AUTH_ERROR_CODES = [
@@ -27767,11 +27705,11 @@ function deriveCustomToolScopes(customTool) {
   return uniqueScopes(customTool.metadata.requiredScopes ?? ["custom:execute"]);
 }
 function createFallbackRuntime() {
+  function noop() {
+  }
   return {
-    registerResource: () => {
-    },
-    registerTool: () => {
-    }
+    registerResource: noop,
+    registerTool: noop
   };
 }
 function createMcpRuntime() {
@@ -27785,7 +27723,7 @@ function createMcpRuntime() {
       { name: "lucern-platform-mcp", version: "1.2.0" },
       { capabilities: { resources: {}, tools: {} } }
     );
-  } catch {
+  } catch (error) {
     return createFallbackRuntime();
   }
 }
@@ -27809,15 +27747,14 @@ function executeWithHandler(_name, handler, contract, params) {
   }
 }
 function isMcpToolResult(value) {
-  if (!value || typeof value !== "object") {
+  if (!isRecord12(value)) {
     return false;
   }
-  const candidate = value;
-  if (!Array.isArray(candidate.content)) {
+  if (!Array.isArray(value.content)) {
     return false;
   }
-  return candidate.content.every((entry) => {
-    if (!entry || typeof entry !== "object") {
+  return value.content.every((entry) => {
+    if (!isRecord12(entry)) {
       return false;
     }
     return typeof entry.text === "string";
@@ -27988,6 +27925,12 @@ function createLucernMcpServer(options) {
     unimplementedToolNames
   };
 }
+function isRecord12(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function ignoreMcpSdkLoadError(_error) {
+  return {};
+}
 
 // src/standalone.ts
 var OBSERVATION_RESOURCE_TEMPLATE = "lucern://observations/topic/{topicId}";
@@ -28029,6 +27972,9 @@ function resourceName(uri) {
   return uri.replace("lucern://", "lucern-").replace(/[{}]/g, "").replace(/[^a-zA-Z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
 function readTemplateVar(variables, key) {
+  if (!isRecord13(variables)) {
+    return;
+  }
   const value = variables[key];
   if (typeof value === "string") {
     return value;
@@ -28041,7 +27987,7 @@ function readTemplateVar(variables, key) {
 async function notifyResourceUpdated(server, uri) {
   try {
     await server.server.sendResourceUpdated({ uri });
-  } catch {
+  } catch (error) {
   }
 }
 function registerResources(server, runtime, observationStore) {
@@ -28102,10 +28048,7 @@ function registerResources(server, runtime, observationStore) {
       mimeType: "application/json"
     },
     async (_uri, variables) => {
-      const topicId = readTemplateVar(
-        variables,
-        "topicId"
-      );
+      const topicId = readTemplateVar(variables, "topicId");
       const records = topicId ? observationStore.list(topicId, 25) : [];
       return {
         contents: [
@@ -28138,9 +28081,8 @@ function registerResources(server, runtime, observationStore) {
       mimeType: "application/json"
     },
     async (_uri, variables) => {
-      const values = variables;
-      const topicId = readTemplateVar(values, "topicId");
-      const query5 = readTemplateVar(values, "query");
+      const topicId = readTemplateVar(variables, "topicId");
+      const query5 = readTemplateVar(variables, "query");
       const matches = topicId && query5 ? observationStore.search(topicId, query5, 25) : [];
       return {
         contents: [
@@ -28173,10 +28115,7 @@ function registerResources(server, runtime, observationStore) {
       mimeType: "application/json"
     },
     async (_uri, variables) => {
-      const topicId = readTemplateVar(
-        variables,
-        "topicId"
-      );
+      const topicId = readTemplateVar(variables, "topicId");
       const context = topicId ? observationStore.getContext({ topicId, limit: 12 }) : observationStore.getContext({ topicId: "unknown", limit: 12 });
       return {
         contents: [
@@ -28200,9 +28139,8 @@ function registerResources(server, runtime, observationStore) {
       mimeType: "application/json"
     },
     async (_uri, variables) => {
-      const values = variables;
-      const topicId = readTemplateVar(values, "topicId");
-      const query5 = readTemplateVar(values, "query");
+      const topicId = readTemplateVar(variables, "topicId");
+      const query5 = readTemplateVar(variables, "query");
       const context = observationStore.getContext({
         topicId: topicId ?? "unknown",
         query: query5,
@@ -28228,7 +28166,7 @@ function registerResources(server, runtime, observationStore) {
     await notifyResourceUpdated(server, `lucern://context/topic/${encoded}`);
     try {
       await server.server.sendResourceListChanged();
-    } catch {
+    } catch (error) {
     }
   };
   return { resourceUris, notifyObservationChanged };
@@ -28268,15 +28206,14 @@ function registerTools(server, runtime) {
         inputSchema: shape
       },
       async (args) => {
-        return handler(args, tool.contract);
+        return handler(isRecord13(args) ? args : {}, tool.contract);
       }
     );
   }
 }
 function createLucernStandaloneMcpServer(options) {
   const observationStore = new McpObservationStore();
-  let notifyObservationChanged = async () => {
-  };
+  let notifyObservationChanged = noopAsync;
   const runtime = createLucernMcpServer({
     ...options,
     observationStore,
@@ -28286,7 +28223,7 @@ function createLucernStandaloneMcpServer(options) {
   });
   const server = new McpServer({
     name: "lucern-mcp",
-    version: "0.2.0-alpha.2"
+    version: "0.3.0-alpha.8"
   });
   registerTools(server, runtime);
   const resources = registerResources(server, runtime, observationStore);
@@ -28300,6 +28237,11 @@ function createLucernStandaloneMcpServer(options) {
     promptNames
   };
 }
+function isRecord13(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+async function noopAsync() {
+}
 
 // src/hosted-route.ts
 var ALLOW_METHODS = "GET, POST, DELETE, OPTIONS";
@@ -28425,12 +28367,12 @@ async function handleHostedMcpRequest(request) {
       message: error instanceof Error ? error.message : "Internal server error."
     });
   } finally {
-    await transport.close().catch(() => {
-    });
-    await server.server.close().catch(() => {
-    });
+    await transport.close().catch(ignoreHostedCloseError);
+    await server.server.close().catch(ignoreHostedCloseError);
   }
 }
+function ignoreHostedCloseError(_error) {
+}
 
 export { handleHostedMcpRequest };
 //# sourceMappingURL=hosted-route.js.map