@lucern/sdk 0.3.0-alpha.1 → 0.3.0-alpha.11

package/dist/contracts/lensFilter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/lens-filter.contract.ts"],"names":[],"mappings":";AA4EO,SAAS,qBACd,KAAA,EAC6B;AAC7B,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AAChD,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,OAAO,OAAO,GAAA,CAAI,OAAA,KAAY,QAAA,IAAY,OAAO,IAAI,IAAA,KAAS,QAAA;AAChE;AAEO,SAAS,2BACd,KAAA,EACmC;AACnC,EAAA,IAAI,CAAC,oBAAA,CAAqB,KAAK,CAAA,EAAG,OAAO,KAAA;AACzC,EAAA,OAAO,KAAA,CAAM,OAAA,KAAY,CAAA,IAAK,KAAA,CAAM,IAAA,KAAS,UAAA;AAC/C;AAcO,SAAS,uBACd,KAAA,EACwB;AACxB,EAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACzC,IAAA,OAAO,EAAE,OAAO,IAAA,EAAK;AAAA,EACvB;AAEA,EAAA,IAAI,CAAC,oBAAA,CAAqB,KAAK,CAAA,EAAG;AAChC,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,KAAA;AAAA,MACP,MAAA,EAAQ;AAAA,QACN;AAAA;AACF,KACF;AAAA,EACF;AAEA,EAAA,IAAI,0BAAA,CAA2B,KAAK,CAAA,EAAG;AACrC,IAAA,OAAO,yBAAyB,KAAK,CAAA;AAAA,EACvC;AAIA,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,KAAA;AAAA,IACP,MAAA,EAAQ;AAAA,MACN,CAAA,qCAAA,EAAwC,GAAA,CAAI,OAAO,CAAA,OAAA,EAAU,IAAI,IAAI,CAAA;AAAA;AACvE,GACF;AACF;AAEA,SAAS,yBACP,QAAA,EACwB;AACxB,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,QAAA,CAAS,iBAAiB,CAAA,EAAG;AAC9C,IAAA,MAAA,CAAO,KAAK,oCAAoC,CAAA;AAChD,IAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AAAA,EAChC;AAEA,EAAA,IAAI,QAAA,CAAS,iBAAA,CAAkB,MAAA,KAAW,CAAA,EAAG;AAC3C,IAAA,MAAA,CAAO,KAAK,mDAAmD,CAAA;AAC/D,IAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AAAA,EAChC;AAEA,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,QAAA,CAAS,iBAAA,CAAkB,QAAQ,CAAA,EAAA,EAAK;AAC1D,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,iBAAA,CAAkB,CAAC,CAAA;AAC3C,IAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,CAAO,oBAAoB,QAAA,EAAU;AACzD,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,qBAAqB,CAAC,CAAA,4CAAA;AAAA,OACxB;AACA,MAAA;AAAA,IACF;AACA,IAAA,IAAI,MAAA,CAAO,eAAA,CAAgB,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AAC9C,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,qBAAqB,CAAC,CAAA,4CAAA;AAAA,OACxB;AAAA,IACF;AACA,IAAA,IACE,MAAA,CAAO,kBAAkB,MAAA,IACzB,CAAC,MAAM,OAAA,CAAQ,MAAA,CAAO,aAAa,CAAA,EACnC;AACA,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,kBAAA,EAAqB,CAAC,CAAA,gCAAA,CAAkC,CAAA;AAAA,IACtE;AAAA,EACF;AAEA,EAAA,IAAI,QAAA,CAAS,kBAAkB,MAAA,EAAW;AACxC,IAAA,IACE,OAAO,QAAA,CAAS,aAAA,KAAkB,QAAA,IAClC,QAAA,CAAS,kBAAkB,IAAA,EAC3B;AACA,MAAA,MAAA,CAAO,KAAK,iCAAiC,CAAA;AAAA,IAC/C;AAAA,EACF;AAEA,EAAA,OAAO,MAAA,CAAO,MAAA,KAAW,CAAA,GACrB,EAAE,KAAA,EAAO,MAAK,GACd,EAAE,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AAC7B","file":"lensFilter.js","sourcesContent":["/**\n * Lens Filter Criteria Contract\n *\n * Version-discriminated filter DSL for lenses. Each filter criteria document\n * carries a `version` and `kind` discriminator so future shapes can coexist\n * without schema migrations. The Convex `filterCriteria` field remains v.any()\n * — all type enforcement happens here at the TypeScript contract layer.\n *\n * Forward-compatibility guarantees:\n * - `version` field: new versions add fields, never remove or rename existing ones\n * - `kind` field: new filter kinds (temporal, confidence-range) can be added\n *   without touching taxonomy code paths\n * - `entityTypeFilters` array items are open to extension in future versions\n * - Resolution logic switches on `version` + `kind` to select the right resolver\n *\n * @module lucern/contracts/src/lens-filter\n */\n\n// ---------------------------------------------------------------------------\n// V1: Taxonomy Filter — entity type + subtype matching\n// ---------------------------------------------------------------------------\n\n/**\n * A single entity type filter entry. Matches nodes whose `nodeType` equals\n * `entityTypeValue`, optionally further narrowed by subtype membership.\n *\n * V2 will add `propertyMatchers` here for arbitrary JSON Schema facet queries.\n */\nexport type EntityTypeFilterV1 = {\n  /** References ontologyVersion.entityTypes[].value, e.g. \"company\" */\n  entityTypeValue: string;\n\n  /** Optional subtype narrowing. If omitted or empty, all subtypes match. */\n  subtypeValues?: string[];\n};\n\n/**\n * Optional scope to restrict which ontology the filter resolves against.\n * If omitted, resolution uses whatever ontology is active in the workspace.\n */\nexport type OntologyScope = {\n  /** Restrict to a specific ontology by key, e.g. \"vc-investment\" */\n  ontologyKey?: string;\n};\n\n/**\n * Taxonomy filter criteria v1: entity type + subtype matching over ontology.\n */\nexport type TaxonomyFilterCriteriaV1 = {\n  version: 1;\n  kind: \"taxonomy\";\n  entityTypeFilters: EntityTypeFilterV1[];\n  ontologyScope?: OntologyScope;\n};\n\n// ---------------------------------------------------------------------------\n// Union: All filter criteria versions and kinds\n// ---------------------------------------------------------------------------\n\n/**\n * Discriminated union of all supported filter criteria.\n * Resolution logic switches on `version` + `kind`.\n *\n * To add a new filter kind:\n *   1. Define a new type (e.g., TemporalFilterCriteriaV1)\n *   2. Add it to this union\n *   3. Add a resolver in taxonomy-filter.ts\n *   4. No schema migration needed — filterCriteria is v.any()\n */\nexport type LensFilterCriteria = TaxonomyFilterCriteriaV1;\n// Future: | TemporalFilterCriteriaV1 | ConfidenceRangeFilterCriteriaV1 | ...\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport function isLensFilterCriteria(\n  value: unknown\n): value is LensFilterCriteria {\n  if (!value || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  return typeof obj.version === \"number\" && typeof obj.kind === \"string\";\n}\n\nexport function isTaxonomyFilterCriteriaV1(\n  value: unknown\n): value is TaxonomyFilterCriteriaV1 {\n  if (!isLensFilterCriteria(value)) return false;\n  return value.version === 1 && value.kind === \"taxonomy\";\n}\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\nexport type FilterValidationResult =\n  | { valid: true }\n  | { valid: false; errors: string[] };\n\n/**\n * Validate a filter criteria document at the contract layer.\n * This runs before persisting to Convex.\n */\nexport function validateFilterCriteria(\n  value: unknown\n): FilterValidationResult {\n  if (value === undefined || value === null) {\n    return { valid: true }; // filterCriteria is optional\n  }\n\n  if (!isLensFilterCriteria(value)) {\n    return {\n      valid: false,\n      errors: [\n        'filterCriteria must have numeric \"version\" and string \"kind\" fields',\n      ],\n    };\n  }\n\n  if (isTaxonomyFilterCriteriaV1(value)) {\n    return validateTaxonomyFilterV1(value);\n  }\n\n  // Cast to access properties — TypeScript narrows to `never` when all union\n  // members are exhausted, but at runtime unknown version/kind combos are possible.\n  const raw = value as { version: number; kind: string };\n  return {\n    valid: false,\n    errors: [\n      `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`,\n    ],\n  };\n}\n\nfunction validateTaxonomyFilterV1(\n  criteria: TaxonomyFilterCriteriaV1\n): FilterValidationResult {\n  const errors: string[] = [];\n\n  if (!Array.isArray(criteria.entityTypeFilters)) {\n    errors.push(\"entityTypeFilters must be an array\");\n    return { valid: false, errors };\n  }\n\n  if (criteria.entityTypeFilters.length === 0) {\n    errors.push(\"entityTypeFilters must contain at least one entry\");\n    return { valid: false, errors };\n  }\n\n  for (let i = 0; i < criteria.entityTypeFilters.length; i++) {\n    const filter = criteria.entityTypeFilters[i];\n    if (!filter || typeof filter.entityTypeValue !== \"string\") {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n      continue;\n    }\n    if (filter.entityTypeValue.trim().length === 0) {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n    }\n    if (\n      filter.subtypeValues !== undefined &&\n      !Array.isArray(filter.subtypeValues)\n    ) {\n      errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);\n    }\n  }\n\n  if (criteria.ontologyScope !== undefined) {\n    if (\n      typeof criteria.ontologyScope !== \"object\" ||\n      criteria.ontologyScope === null\n    ) {\n      errors.push(\"ontologyScope must be an object\");\n    }\n  }\n\n  return errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors };\n}\n"]}
+{"version":3,"sources":["../../src/contracts/lens-filter.contract.ts"],"names":[],"mappings":"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","file":"lensFilter.js","sourcesContent":["/**\n * Lens Filter Criteria Contract\n *\n * Version-discriminated filter DSL for lenses. Each filter criteria document\n * carries a `version` and `kind` discriminator so future shapes can coexist\n * without schema migrations. The Convex `filterCriteria` field remains v.any()\n * — all type enforcement happens here at the TypeScript contract layer.\n *\n * Forward-compatibility guarantees:\n * - `version` field: new versions add fields, never remove or rename existing ones\n * - `kind` field: new filter kinds (temporal, confidence-range) can be added\n *   without touching taxonomy code paths\n * - `entityTypeFilters` array items are open to extension in future versions\n * - Resolution logic switches on `version` + `kind` to select the right resolver\n *\n * @module lucern/contracts/src/lens-filter\n */\n\n// ---------------------------------------------------------------------------\n// V1: Taxonomy Filter — entity type + subtype matching\n// ---------------------------------------------------------------------------\n\n/**\n * A single entity type filter entry. Matches nodes whose `nodeType` equals\n * `entityTypeValue`, optionally further narrowed by subtype membership.\n *\n * V2 will add `propertyMatchers` here for arbitrary JSON Schema facet queries.\n */\nexport type EntityTypeFilterV1 = {\n  /** References ontologyVersion.entityTypes[].value, e.g. \"company\" */\n  entityTypeValue: string;\n\n  /** Optional subtype narrowing. If omitted or empty, all subtypes match. */\n  subtypeValues?: string[];\n};\n\n/**\n * Optional scope to restrict which ontology the filter resolves against.\n * If omitted, resolution uses whatever ontology is active in the workspace.\n */\nexport type OntologyScope = {\n  /** Restrict to a specific ontology by key, e.g. \"vc-investment\" */\n  ontologyKey?: string;\n};\n\n/**\n * Taxonomy filter criteria v1: entity type + subtype matching over ontology.\n */\nexport type TaxonomyFilterCriteriaV1 = {\n  version: 1;\n  kind: \"taxonomy\";\n  entityTypeFilters: EntityTypeFilterV1[];\n  ontologyScope?: OntologyScope;\n};\n\n// ---------------------------------------------------------------------------\n// Union: All filter criteria versions and kinds\n// ---------------------------------------------------------------------------\n\n/**\n * Discriminated union of all supported filter criteria.\n * Resolution logic switches on `version` + `kind`.\n *\n * To add a new filter kind:\n *   1. Define a new type (e.g., TemporalFilterCriteriaV1)\n *   2. Add it to this union\n *   3. Add a resolver in taxonomy-filter.ts\n *   4. No schema migration needed — filterCriteria is v.any()\n */\nexport type LensFilterCriteria = TaxonomyFilterCriteriaV1;\n// Future: | TemporalFilterCriteriaV1 | ConfidenceRangeFilterCriteriaV1 | ...\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport function isLensFilterCriteria(\n  value: unknown\n): value is LensFilterCriteria {\n  return isRecord(value) && typeof value.version === \"number\" && typeof value.kind === \"string\";\n}\n\nexport function isTaxonomyFilterCriteriaV1(\n  value: unknown\n): value is TaxonomyFilterCriteriaV1 {\n  if (!isLensFilterCriteria(value)) return false;\n  return value.version === 1 && value.kind === \"taxonomy\";\n}\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\nexport type FilterValidationResult =\n  | { valid: true }\n  | { valid: false; errors: string[] };\n\n/**\n * Validate a filter criteria document at the contract layer.\n * This runs before persisting to Convex.\n */\nexport function validateFilterCriteria(\n  value: unknown\n): FilterValidationResult {\n  if (value === undefined || value === null) {\n    return { valid: true }; // filterCriteria is optional\n  }\n\n  if (!isLensFilterCriteria(value)) {\n    return {\n      valid: false,\n      errors: [\n        'filterCriteria must have numeric \"version\" and string \"kind\" fields',\n      ],\n    };\n  }\n\n  if (isTaxonomyFilterCriteriaV1(value)) {\n    return validateTaxonomyFilterV1(value);\n  }\n\n  // Cast to access properties — TypeScript narrows to `never` when all union\n  // members are exhausted, but at runtime unknown version/kind combos are possible.\n  const raw = value as { version: number; kind: string };\n  return {\n    valid: false,\n    errors: [\n      `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`,\n    ],\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction validateTaxonomyFilterV1(\n  criteria: TaxonomyFilterCriteriaV1\n): FilterValidationResult {\n  const errors: string[] = [];\n\n  if (!Array.isArray(criteria.entityTypeFilters)) {\n    errors.push(\"entityTypeFilters must be an array\");\n    return { valid: false, errors };\n  }\n\n  if (criteria.entityTypeFilters.length === 0) {\n    errors.push(\"entityTypeFilters must contain at least one entry\");\n    return { valid: false, errors };\n  }\n\n  for (let i = 0; i < criteria.entityTypeFilters.length; i++) {\n    const filter = criteria.entityTypeFilters[i];\n    if (!filter || typeof filter.entityTypeValue !== \"string\") {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n      continue;\n    }\n    if (filter.entityTypeValue.trim().length === 0) {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n    }\n    if (\n      filter.subtypeValues !== undefined &&\n      !Array.isArray(filter.subtypeValues)\n    ) {\n      errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);\n    }\n  }\n\n  if (criteria.ontologyScope !== undefined) {\n    if (\n      typeof criteria.ontologyScope !== \"object\" ||\n      criteria.ontologyScope === null\n    ) {\n      errors.push(\"ontologyScope must be an object\");\n    }\n  }\n\n  return errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors };\n}\n"]}

package/dist/contracts/lensWorkflow.js

@@ -1,8 +1,6 @@
 // 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 isRecord(value) && typeof value.version === "number" && typeof value.kind === "string";
 }
 function isTaxonomyFilterCriteriaV1(value) {
   if (!isLensFilterCriteria(value)) return false;
@@ -31,6 +29,9 @@ function validateFilterCriteria(value) {
     ]
   };
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function validateTaxonomyFilterV1(criteria) {
   const errors = [];
   if (!Array.isArray(criteria.entityTypeFilters)) {

package/dist/contracts/lensWorkflow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/lens-filter.contract.ts","../../src/contracts/lens-workflow.contract.ts"],"names":[],"mappings":"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","file":"lensWorkflow.js","sourcesContent":["/**\n * Lens Filter Criteria Contract\n *\n * Version-discriminated filter DSL for lenses. Each filter criteria document\n * carries a `version` and `kind` discriminator so future shapes can coexist\n * without schema migrations. The Convex `filterCriteria` field remains v.any()\n * — all type enforcement happens here at the TypeScript contract layer.\n *\n * Forward-compatibility guarantees:\n * - `version` field: new versions add fields, never remove or rename existing ones\n * - `kind` field: new filter kinds (temporal, confidence-range) can be added\n *   without touching taxonomy code paths\n * - `entityTypeFilters` array items are open to extension in future versions\n * - Resolution logic switches on `version` + `kind` to select the right resolver\n *\n * @module lucern/contracts/src/lens-filter\n */\n\n// ---------------------------------------------------------------------------\n// V1: Taxonomy Filter — entity type + subtype matching\n// ---------------------------------------------------------------------------\n\n/**\n * A single entity type filter entry. Matches nodes whose `nodeType` equals\n * `entityTypeValue`, optionally further narrowed by subtype membership.\n *\n * V2 will add `propertyMatchers` here for arbitrary JSON Schema facet queries.\n */\nexport type EntityTypeFilterV1 = {\n  /** References ontologyVersion.entityTypes[].value, e.g. \"company\" */\n  entityTypeValue: string;\n\n  /** Optional subtype narrowing. If omitted or empty, all subtypes match. */\n  subtypeValues?: string[];\n};\n\n/**\n * Optional scope to restrict which ontology the filter resolves against.\n * If omitted, resolution uses whatever ontology is active in the workspace.\n */\nexport type OntologyScope = {\n  /** Restrict to a specific ontology by key, e.g. \"vc-investment\" */\n  ontologyKey?: string;\n};\n\n/**\n * Taxonomy filter criteria v1: entity type + subtype matching over ontology.\n */\nexport type TaxonomyFilterCriteriaV1 = {\n  version: 1;\n  kind: \"taxonomy\";\n  entityTypeFilters: EntityTypeFilterV1[];\n  ontologyScope?: OntologyScope;\n};\n\n// ---------------------------------------------------------------------------\n// Union: All filter criteria versions and kinds\n// ---------------------------------------------------------------------------\n\n/**\n * Discriminated union of all supported filter criteria.\n * Resolution logic switches on `version` + `kind`.\n *\n * To add a new filter kind:\n *   1. Define a new type (e.g., TemporalFilterCriteriaV1)\n *   2. Add it to this union\n *   3. Add a resolver in taxonomy-filter.ts\n *   4. No schema migration needed — filterCriteria is v.any()\n */\nexport type LensFilterCriteria = TaxonomyFilterCriteriaV1;\n// Future: | TemporalFilterCriteriaV1 | ConfidenceRangeFilterCriteriaV1 | ...\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport function isLensFilterCriteria(\n  value: unknown\n): value is LensFilterCriteria {\n  if (!value || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  return typeof obj.version === \"number\" && typeof obj.kind === \"string\";\n}\n\nexport function isTaxonomyFilterCriteriaV1(\n  value: unknown\n): value is TaxonomyFilterCriteriaV1 {\n  if (!isLensFilterCriteria(value)) return false;\n  return value.version === 1 && value.kind === \"taxonomy\";\n}\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\nexport type FilterValidationResult =\n  | { valid: true }\n  | { valid: false; errors: string[] };\n\n/**\n * Validate a filter criteria document at the contract layer.\n * This runs before persisting to Convex.\n */\nexport function validateFilterCriteria(\n  value: unknown\n): FilterValidationResult {\n  if (value === undefined || value === null) {\n    return { valid: true }; // filterCriteria is optional\n  }\n\n  if (!isLensFilterCriteria(value)) {\n    return {\n      valid: false,\n      errors: [\n        'filterCriteria must have numeric \"version\" and string \"kind\" fields',\n      ],\n    };\n  }\n\n  if (isTaxonomyFilterCriteriaV1(value)) {\n    return validateTaxonomyFilterV1(value);\n  }\n\n  // Cast to access properties — TypeScript narrows to `never` when all union\n  // members are exhausted, but at runtime unknown version/kind combos are possible.\n  const raw = value as { version: number; kind: string };\n  return {\n    valid: false,\n    errors: [\n      `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`,\n    ],\n  };\n}\n\nfunction validateTaxonomyFilterV1(\n  criteria: TaxonomyFilterCriteriaV1\n): FilterValidationResult {\n  const errors: string[] = [];\n\n  if (!Array.isArray(criteria.entityTypeFilters)) {\n    errors.push(\"entityTypeFilters must be an array\");\n    return { valid: false, errors };\n  }\n\n  if (criteria.entityTypeFilters.length === 0) {\n    errors.push(\"entityTypeFilters must contain at least one entry\");\n    return { valid: false, errors };\n  }\n\n  for (let i = 0; i < criteria.entityTypeFilters.length; i++) {\n    const filter = criteria.entityTypeFilters[i];\n    if (!filter || typeof filter.entityTypeValue !== \"string\") {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n      continue;\n    }\n    if (filter.entityTypeValue.trim().length === 0) {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n    }\n    if (\n      filter.subtypeValues !== undefined &&\n      !Array.isArray(filter.subtypeValues)\n    ) {\n      errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);\n    }\n  }\n\n  if (criteria.ontologyScope !== undefined) {\n    if (\n      typeof criteria.ontologyScope !== \"object\" ||\n      criteria.ontologyScope === null\n    ) {\n      errors.push(\"ontologyScope must be an object\");\n    }\n  }\n\n  return errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors };\n}\n","/**\n * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.\n */\n\n// Re-export filter criteria types for consumers who import from lens-workflow\nexport type {\n  LensFilterCriteria,\n  TaxonomyFilterCriteriaV1,\n  EntityTypeFilterV1,\n  OntologyScope,\n  FilterValidationResult,\n} from \"./lens-filter.contract\";\nexport {\n  validateFilterCriteria,\n  isLensFilterCriteria,\n  isTaxonomyFilterCriteriaV1,\n} from \"./lens-filter.contract\";\n\nexport const LENS_PERSPECTIVE_TYPES = [\n  \"investigation\",\n  \"monitoring\",\n  \"analysis\",\n  \"comparison\",\n  \"taxonomy\",\n] as const;\n\nexport type LensPerspectiveType = (typeof LENS_PERSPECTIVE_TYPES)[number];\n\nexport const LENS_STATUSES = [\"draft\", \"active\", \"archived\"] as const;\n\nexport type LensStatus = (typeof LENS_STATUSES)[number];\n\nexport const LENS_TASK_TEMPLATE_PRIORITIES = [\n  \"critical\",\n  \"high\",\n  \"medium\",\n  \"low\",\n] as const;\n\nexport type LensTaskTemplatePriority =\n  (typeof LENS_TASK_TEMPLATE_PRIORITIES)[number];\n\nexport type LensLooseMetadata = Record<string, unknown>;\n\nexport type LensPromptTemplateReference = {\n  key: string;\n  promptRef: string;\n  phase?: string;\n  role?: string;\n  version?: string;\n  required?: boolean;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowStepTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  promptTemplateKey?: string;\n  taskTemplateKeys?: string[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowTemplate = {\n  key: string;\n  name: string;\n  description?: string;\n  steps: LensWorkflowStepTemplate[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensTaskTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  priority?: LensTaskTemplatePriority;\n  phase?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensQuestionTemplate = {\n  key: string;\n  text: string;\n  priority?: LensTaskTemplatePriority;\n  linkedBeliefKey?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensBranchMigrationSuggestion = {\n  recommendedTool: \"create_lens\";\n  perspectiveType: LensPerspectiveType;\n  message: string;\n  suggestedPayload: {\n    name: string;\n    description?: string;\n    topicId?: string;\n    workspaceId?: string;\n    perspectiveType: LensPerspectiveType;\n  };\n};\n\nexport const BRANCH_DEPRECATION_MESSAGE =\n  \"Branches are deprecated for operational framing. Create a workspace-scoped lens instead.\";\n\nexport type DeprecatedBranchMetadata = {\n  deprecated: true;\n  deprecationMessage: string;\n  lensSuggestion: LensBranchMigrationSuggestion;\n};\n\nexport function inferLensPerspectiveTypeFromBranchSchema(\n  schema?: string | null\n): LensPerspectiveType {\n  const normalized = schema?.trim().toLowerCase();\n  if (normalized === \"phase\") {\n    return \"monitoring\";\n  }\n  if (normalized === \"axis\" || normalized === \"dimension\") {\n    return \"comparison\";\n  }\n  if (normalized === \"track\") {\n    return \"investigation\";\n  }\n  return \"analysis\";\n}\n\nexport function migrateBranchToLens(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): LensBranchMigrationSuggestion {\n  const perspectiveType = inferLensPerspectiveTypeFromBranchSchema(args.schema);\n  return {\n    recommendedTool: \"create_lens\",\n    perspectiveType,\n    message:\n      \"Branches are deprecated for operational framing. Create a workspace-scoped lens with the suggested payload instead.\",\n    suggestedPayload: {\n      name: args.name,\n      description: args.description,\n      topicId: args.topicId,\n      workspaceId: args.workspaceId,\n      perspectiveType,\n    },\n  };\n}\n\nexport function buildDeprecatedBranchMetadata(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): DeprecatedBranchMetadata {\n  return {\n    deprecated: true,\n    deprecationMessage: BRANCH_DEPRECATION_MESSAGE,\n    lensSuggestion: migrateBranchToLens(args),\n  };\n}\n"]}
+{"version":3,"sources":["../../src/contracts/lens-filter.contract.ts","../../src/contracts/lens-workflow.contract.ts"],"names":[],"mappings":"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","file":"lensWorkflow.js","sourcesContent":["/**\n * Lens Filter Criteria Contract\n *\n * Version-discriminated filter DSL for lenses. Each filter criteria document\n * carries a `version` and `kind` discriminator so future shapes can coexist\n * without schema migrations. The Convex `filterCriteria` field remains v.any()\n * — all type enforcement happens here at the TypeScript contract layer.\n *\n * Forward-compatibility guarantees:\n * - `version` field: new versions add fields, never remove or rename existing ones\n * - `kind` field: new filter kinds (temporal, confidence-range) can be added\n *   without touching taxonomy code paths\n * - `entityTypeFilters` array items are open to extension in future versions\n * - Resolution logic switches on `version` + `kind` to select the right resolver\n *\n * @module lucern/contracts/src/lens-filter\n */\n\n// ---------------------------------------------------------------------------\n// V1: Taxonomy Filter — entity type + subtype matching\n// ---------------------------------------------------------------------------\n\n/**\n * A single entity type filter entry. Matches nodes whose `nodeType` equals\n * `entityTypeValue`, optionally further narrowed by subtype membership.\n *\n * V2 will add `propertyMatchers` here for arbitrary JSON Schema facet queries.\n */\nexport type EntityTypeFilterV1 = {\n  /** References ontologyVersion.entityTypes[].value, e.g. \"company\" */\n  entityTypeValue: string;\n\n  /** Optional subtype narrowing. If omitted or empty, all subtypes match. */\n  subtypeValues?: string[];\n};\n\n/**\n * Optional scope to restrict which ontology the filter resolves against.\n * If omitted, resolution uses whatever ontology is active in the workspace.\n */\nexport type OntologyScope = {\n  /** Restrict to a specific ontology by key, e.g. \"vc-investment\" */\n  ontologyKey?: string;\n};\n\n/**\n * Taxonomy filter criteria v1: entity type + subtype matching over ontology.\n */\nexport type TaxonomyFilterCriteriaV1 = {\n  version: 1;\n  kind: \"taxonomy\";\n  entityTypeFilters: EntityTypeFilterV1[];\n  ontologyScope?: OntologyScope;\n};\n\n// ---------------------------------------------------------------------------\n// Union: All filter criteria versions and kinds\n// ---------------------------------------------------------------------------\n\n/**\n * Discriminated union of all supported filter criteria.\n * Resolution logic switches on `version` + `kind`.\n *\n * To add a new filter kind:\n *   1. Define a new type (e.g., TemporalFilterCriteriaV1)\n *   2. Add it to this union\n *   3. Add a resolver in taxonomy-filter.ts\n *   4. No schema migration needed — filterCriteria is v.any()\n */\nexport type LensFilterCriteria = TaxonomyFilterCriteriaV1;\n// Future: | TemporalFilterCriteriaV1 | ConfidenceRangeFilterCriteriaV1 | ...\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport function isLensFilterCriteria(\n  value: unknown\n): value is LensFilterCriteria {\n  return isRecord(value) && typeof value.version === \"number\" && typeof value.kind === \"string\";\n}\n\nexport function isTaxonomyFilterCriteriaV1(\n  value: unknown\n): value is TaxonomyFilterCriteriaV1 {\n  if (!isLensFilterCriteria(value)) return false;\n  return value.version === 1 && value.kind === \"taxonomy\";\n}\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\nexport type FilterValidationResult =\n  | { valid: true }\n  | { valid: false; errors: string[] };\n\n/**\n * Validate a filter criteria document at the contract layer.\n * This runs before persisting to Convex.\n */\nexport function validateFilterCriteria(\n  value: unknown\n): FilterValidationResult {\n  if (value === undefined || value === null) {\n    return { valid: true }; // filterCriteria is optional\n  }\n\n  if (!isLensFilterCriteria(value)) {\n    return {\n      valid: false,\n      errors: [\n        'filterCriteria must have numeric \"version\" and string \"kind\" fields',\n      ],\n    };\n  }\n\n  if (isTaxonomyFilterCriteriaV1(value)) {\n    return validateTaxonomyFilterV1(value);\n  }\n\n  // Cast to access properties — TypeScript narrows to `never` when all union\n  // members are exhausted, but at runtime unknown version/kind combos are possible.\n  const raw = value as { version: number; kind: string };\n  return {\n    valid: false,\n    errors: [\n      `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`,\n    ],\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction validateTaxonomyFilterV1(\n  criteria: TaxonomyFilterCriteriaV1\n): FilterValidationResult {\n  const errors: string[] = [];\n\n  if (!Array.isArray(criteria.entityTypeFilters)) {\n    errors.push(\"entityTypeFilters must be an array\");\n    return { valid: false, errors };\n  }\n\n  if (criteria.entityTypeFilters.length === 0) {\n    errors.push(\"entityTypeFilters must contain at least one entry\");\n    return { valid: false, errors };\n  }\n\n  for (let i = 0; i < criteria.entityTypeFilters.length; i++) {\n    const filter = criteria.entityTypeFilters[i];\n    if (!filter || typeof filter.entityTypeValue !== \"string\") {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n      continue;\n    }\n    if (filter.entityTypeValue.trim().length === 0) {\n      errors.push(\n        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`\n      );\n    }\n    if (\n      filter.subtypeValues !== undefined &&\n      !Array.isArray(filter.subtypeValues)\n    ) {\n      errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);\n    }\n  }\n\n  if (criteria.ontologyScope !== undefined) {\n    if (\n      typeof criteria.ontologyScope !== \"object\" ||\n      criteria.ontologyScope === null\n    ) {\n      errors.push(\"ontologyScope must be an object\");\n    }\n  }\n\n  return errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors };\n}\n","/**\n * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.\n */\n\n// Re-export filter criteria types for consumers who import from lens-workflow\nexport type {\n  LensFilterCriteria,\n  TaxonomyFilterCriteriaV1,\n  EntityTypeFilterV1,\n  OntologyScope,\n  FilterValidationResult,\n} from \"./lens-filter.contract\";\nexport {\n  validateFilterCriteria,\n  isLensFilterCriteria,\n  isTaxonomyFilterCriteriaV1,\n} from \"./lens-filter.contract\";\n\nexport const LENS_PERSPECTIVE_TYPES = [\n  \"investigation\",\n  \"monitoring\",\n  \"analysis\",\n  \"comparison\",\n  \"taxonomy\",\n] as const;\n\nexport type LensPerspectiveType = (typeof LENS_PERSPECTIVE_TYPES)[number];\n\nexport const LENS_STATUSES = [\"draft\", \"active\", \"archived\"] as const;\n\nexport type LensStatus = (typeof LENS_STATUSES)[number];\n\nexport const LENS_TASK_TEMPLATE_PRIORITIES = [\n  \"critical\",\n  \"high\",\n  \"medium\",\n  \"low\",\n] as const;\n\nexport type LensTaskTemplatePriority =\n  (typeof LENS_TASK_TEMPLATE_PRIORITIES)[number];\n\nexport type LensLooseMetadata = Record<string, unknown>;\n\nexport type LensPromptTemplateReference = {\n  key: string;\n  promptRef: string;\n  phase?: string;\n  role?: string;\n  version?: string;\n  required?: boolean;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowStepTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  promptTemplateKey?: string;\n  taskTemplateKeys?: string[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowTemplate = {\n  key: string;\n  name: string;\n  description?: string;\n  steps: LensWorkflowStepTemplate[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensTaskTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  priority?: LensTaskTemplatePriority;\n  phase?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensQuestionTemplate = {\n  key: string;\n  text: string;\n  priority?: LensTaskTemplatePriority;\n  linkedBeliefKey?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensBranchMigrationSuggestion = {\n  recommendedTool: \"create_lens\";\n  perspectiveType: LensPerspectiveType;\n  message: string;\n  suggestedPayload: {\n    name: string;\n    description?: string;\n    topicId?: string;\n    workspaceId?: string;\n    perspectiveType: LensPerspectiveType;\n  };\n};\n\nexport const BRANCH_DEPRECATION_MESSAGE =\n  \"Branches are deprecated for operational framing. Create a workspace-scoped lens instead.\";\n\nexport type DeprecatedBranchMetadata = {\n  deprecated: true;\n  deprecationMessage: string;\n  lensSuggestion: LensBranchMigrationSuggestion;\n};\n\nexport function inferLensPerspectiveTypeFromBranchSchema(\n  schema?: string | null\n): LensPerspectiveType {\n  const normalized = schema?.trim().toLowerCase();\n  if (normalized === \"phase\") {\n    return \"monitoring\";\n  }\n  if (normalized === \"axis\" || normalized === \"dimension\") {\n    return \"comparison\";\n  }\n  if (normalized === \"track\") {\n    return \"investigation\";\n  }\n  return \"analysis\";\n}\n\nexport function migrateBranchToLens(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): LensBranchMigrationSuggestion {\n  const perspectiveType = inferLensPerspectiveTypeFromBranchSchema(args.schema);\n  return {\n    recommendedTool: \"create_lens\",\n    perspectiveType,\n    message:\n      \"Branches are deprecated for operational framing. Create a workspace-scoped lens with the suggested payload instead.\",\n    suggestedPayload: {\n      name: args.name,\n      description: args.description,\n      topicId: args.topicId,\n      workspaceId: args.workspaceId,\n      perspectiveType,\n    },\n  };\n}\n\nexport function buildDeprecatedBranchMetadata(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): DeprecatedBranchMetadata {\n  return {\n    deprecated: true,\n    deprecationMessage: BRANCH_DEPRECATION_MESSAGE,\n    lensSuggestion: migrateBranchToLens(args),\n  };\n}\n"]}

package/dist/contracts/mcpTools.d.ts

@@ -1,2 +1,47 @@
+import { McpToolContract } from '@lucern/contracts/tool-contracts';
 export * from '@lucern/contracts/tool-contracts';
-import '@lucern/contracts/sdk-tools.contract';
+
+declare const MCP_ALWAYS_ALLOWED_TOOL_NAMES: readonly ["identity_whoami"];
+type McpToolInputSchema = {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+};
+type McpPermittedTool = {
+    toolName: string;
+    requiredRole?: string;
+    approvalGateId?: string;
+    isCore?: boolean;
+    category?: string;
+};
+type McpToolManifestEntry = {
+    name: string;
+    description: string;
+    inputSchema: McpToolInputSchema;
+    internal: boolean;
+    ownerModule: string;
+    ontologyPrimitive: McpToolContract["ontologyPrimitive"];
+    tier: McpToolContract["tier"];
+};
+type McpToolContractMap = Record<string, McpToolContract>;
+type BuildMcpToolContractsOptions = {
+    extensions?: McpToolContractMap;
+};
+type McpToolVisibilityOptions = {
+    contracts?: McpToolContractMap;
+    sessionType?: "agent" | "user";
+    permittedTools?: readonly McpPermittedTool[] | null;
+    allowedTools?: readonly string[] | null;
+    alwaysAllowedTools?: readonly string[];
+};
+declare function getMcpToolExposure(toolName: string): "public" | "internal" | "none";
+declare function buildMcpToolContracts(options?: BuildMcpToolContractsOptions): McpToolContractMap;
+declare function mcpContractToInputSchema(contract: McpToolContract): McpToolInputSchema;
+declare function mcpContractToManifestEntry(name: string, contract: McpToolContract): McpToolManifestEntry;
+declare function isMcpToolAllowed(toolName: string, options?: McpToolVisibilityOptions): boolean;
+declare function buildMcpToolManifest(args?: {
+    contracts?: McpToolContractMap;
+    visibility?: McpToolVisibilityOptions;
+}): McpToolManifestEntry[];
+
+export { type BuildMcpToolContractsOptions, MCP_ALWAYS_ALLOWED_TOOL_NAMES, type McpPermittedTool, type McpToolContractMap, type McpToolInputSchema, type McpToolManifestEntry, type McpToolVisibilityOptions, buildMcpToolContracts, buildMcpToolManifest, getMcpToolExposure, isMcpToolAllowed, mcpContractToInputSchema, mcpContractToManifestEntry };

package/dist/contracts/mcpTools.js

@@ -1,9 +1,14 @@
 import * as tool_contracts_star from '@lucern/contracts/tool-contracts';
+import { LUCERN_OPERATION_MANIFEST } from '@lucern/contracts/function-registry/manifest';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -16,6 +21,15 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 
 // src/contracts/mcpTools.ts
 var mcpTools_exports = {};
+__export(mcpTools_exports, {
+  MCP_ALWAYS_ALLOWED_TOOL_NAMES: () => MCP_ALWAYS_ALLOWED_TOOL_NAMES,
+  buildMcpToolContracts: () => buildMcpToolContracts,
+  buildMcpToolManifest: () => buildMcpToolManifest,
+  getMcpToolExposure: () => getMcpToolExposure,
+  isMcpToolAllowed: () => isMcpToolAllowed,
+  mcpContractToInputSchema: () => mcpContractToInputSchema,
+  mcpContractToManifestEntry: () => mcpContractToManifestEntry
+});
 
 // src/contracts/tool-contracts.ts
 var tool_contracts_exports = {};
@@ -23,5 +37,99 @@ __reExport(tool_contracts_exports, tool_contracts_star);
 
 // src/contracts/mcpTools.ts
 __reExport(mcpTools_exports, tool_contracts_exports);
+var OPERATION_MANIFEST = LUCERN_OPERATION_MANIFEST;
+var MCP_ALWAYS_ALLOWED_TOOL_NAMES = ["identity_whoami"];
+function getMcpToolExposure(toolName) {
+  return OPERATION_MANIFEST[toolName]?.surfaces.mcp ?? "none";
+}
+function decorateMcpToolContract(toolName, contract) {
+  const exposure = getMcpToolExposure(toolName);
+  if (exposure === "none") {
+    return null;
+  }
+  return exposure === "internal" || contract.internal ? { ...contract, internal: true } : contract;
+}
+function buildMcpToolContracts(options = {}) {
+  const merged = {
+    ...tool_contracts_exports.MCP_TOOL_CONTRACTS,
+    ...options.extensions ?? {}
+  };
+  return Object.fromEntries(
+    Object.entries(merged).flatMap(([toolName, contract]) => {
+      const decorated = decorateMcpToolContract(toolName, contract);
+      return decorated ? [[toolName, decorated]] : [];
+    })
+  );
+}
+function mcpContractToInputSchema(contract) {
+  const properties = {};
+  for (const [paramName, paramDef] of Object.entries(contract.parameters)) {
+    const prop = {
+      type: paramDef.type,
+      description: paramDef.description
+    };
+    if (paramDef.enum) {
+      prop.enum = paramDef.enum;
+    }
+    properties[paramName] = prop;
+  }
+  return {
+    type: "object",
+    properties,
+    required: contract.required
+  };
+}
+function mcpContractToManifestEntry(name, contract) {
+  return {
+    name,
+    description: contract.description,
+    inputSchema: mcpContractToInputSchema(contract),
+    internal: Boolean(contract.internal),
+    ownerModule: contract.ownerModule,
+    ontologyPrimitive: contract.ontologyPrimitive,
+    tier: contract.tier
+  };
+}
+function isMcpToolAllowed(toolName, options = {}) {
+  const contracts = options.contracts ?? buildMcpToolContracts();
+  const contract = contracts[toolName];
+  const alwaysAllowed = /* @__PURE__ */ new Set([
+    ...MCP_ALWAYS_ALLOWED_TOOL_NAMES,
+    ...options.alwaysAllowedTools ?? []
+  ]);
+  if (alwaysAllowed.has(toolName)) {
+    return true;
+  }
+  if (options.sessionType === "user" && contract?.internal) {
+    return false;
+  }
+  if (options.permittedTools !== void 0 && options.permittedTools !== null) {
+    return options.permittedTools.some((tool) => tool.toolName === toolName);
+  }
+  if (options.sessionType === "agent") {
+    if (options.allowedTools === null || options.allowedTools === void 0) {
+      return false;
+    }
+    return options.allowedTools.includes(toolName);
+  }
+  if (options.allowedTools === null || options.allowedTools === void 0) {
+    return true;
+  }
+  return options.allowedTools.includes(toolName);
+}
+function buildMcpToolManifest(args = {}) {
+  const contracts = args.contracts ?? buildMcpToolContracts();
+  return Object.entries(contracts).filter(([name, contract]) => {
+    if (args.visibility?.sessionType === "user" && contract.internal) {
+      return false;
+    }
+    return isMcpToolAllowed(name, {
+      ...args.visibility,
+      contracts
+    });
+  }).map(([name, contract]) => mcpContractToManifestEntry(name, contract));
+}
+
+export { MCP_ALWAYS_ALLOWED_TOOL_NAMES, buildMcpToolContracts, buildMcpToolManifest, getMcpToolExposure, isMcpToolAllowed, mcpContractToInputSchema, mcpContractToManifestEntry };
 //# sourceMappingURL=mcpTools.js.map
 //# sourceMappingURL=mcpTools.js.map

package/dist/contracts/mcpTools.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/mcpTools.ts","../../src/contracts/tool-contracts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAA,gBAAA,GAAA,EAAA;;;ACAA,IAAA,sBAAA,GAAA,EAAA;AAAA,UAAA,CAAA,sBAAA,EAAA,mBAAA,CAAA;;;ADAA,UAAA,CAAA,gBAAA,EAAc,sBAAA,CAAA","file":"mcpTools.js","sourcesContent":["export * from \"./tool-contracts\";\n","export * from \"@lucern/contracts/tool-contracts\";\n\n"]}
+{"version":3,"sources":["../../src/contracts/mcpTools.ts","../../src/contracts/tool-contracts.ts"],"names":[],"mappings":"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","file":"mcpTools.js","sourcesContent":["export * from \"./tool-contracts\";\n\nimport { LUCERN_OPERATION_MANIFEST } from \"@lucern/contracts/function-registry/manifest\";\nimport {\n  MCP_TOOL_CONTRACTS,\n  type McpToolContract,\n} from \"./tool-contracts\";\n\ntype OperationManifestEntry =\n  (typeof LUCERN_OPERATION_MANIFEST)[keyof typeof LUCERN_OPERATION_MANIFEST];\n\nconst OPERATION_MANIFEST = LUCERN_OPERATION_MANIFEST as Record<\n  string,\n  OperationManifestEntry | undefined\n>;\n\nexport const MCP_ALWAYS_ALLOWED_TOOL_NAMES = [\"identity_whoami\"] as const;\n\nexport type McpToolInputSchema = {\n  type: \"object\";\n  properties: Record<string, unknown>;\n  required: string[];\n};\n\nexport type McpPermittedTool = {\n  toolName: string;\n  requiredRole?: string;\n  approvalGateId?: string;\n  isCore?: boolean;\n  category?: string;\n};\n\nexport type McpToolManifestEntry = {\n  name: string;\n  description: string;\n  inputSchema: McpToolInputSchema;\n  internal: boolean;\n  ownerModule: string;\n  ontologyPrimitive: McpToolContract[\"ontologyPrimitive\"];\n  tier: McpToolContract[\"tier\"];\n};\n\nexport type McpToolContractMap = Record<string, McpToolContract>;\n\nexport type BuildMcpToolContractsOptions = {\n  extensions?: McpToolContractMap;\n};\n\nexport type McpToolVisibilityOptions = {\n  contracts?: McpToolContractMap;\n  sessionType?: \"agent\" | \"user\";\n  permittedTools?: readonly McpPermittedTool[] | null;\n  allowedTools?: readonly string[] | null;\n  alwaysAllowedTools?: readonly string[];\n};\n\nexport function getMcpToolExposure(\n  toolName: string\n): \"public\" | \"internal\" | \"none\" {\n  return OPERATION_MANIFEST[toolName]?.surfaces.mcp ?? \"none\";\n}\n\nfunction decorateMcpToolContract(\n  toolName: string,\n  contract: McpToolContract\n): McpToolContract | null {\n  const exposure = getMcpToolExposure(toolName);\n  if (exposure === \"none\") {\n    return null;\n  }\n  return exposure === \"internal\" || contract.internal\n    ? { ...contract, internal: true }\n    : contract;\n}\n\nexport function buildMcpToolContracts(\n  options: BuildMcpToolContractsOptions = {}\n): McpToolContractMap {\n  const merged = {\n    ...MCP_TOOL_CONTRACTS,\n    ...(options.extensions ?? {}),\n  };\n\n  return Object.fromEntries(\n    Object.entries(merged).flatMap(([toolName, contract]) => {\n      const decorated = decorateMcpToolContract(toolName, contract);\n      return decorated ? [[toolName, decorated]] : [];\n    })\n  );\n}\n\nexport function mcpContractToInputSchema(\n  contract: McpToolContract\n): McpToolInputSchema {\n  const properties: Record<string, unknown> = {};\n\n  for (const [paramName, paramDef] of Object.entries(contract.parameters)) {\n    const prop: Record<string, unknown> = {\n      type: paramDef.type,\n      description: paramDef.description,\n    };\n    if (paramDef.enum) {\n      prop.enum = paramDef.enum;\n    }\n    properties[paramName] = prop;\n  }\n\n  return {\n    type: \"object\",\n    properties,\n    required: contract.required,\n  };\n}\n\nexport function mcpContractToManifestEntry(\n  name: string,\n  contract: McpToolContract\n): McpToolManifestEntry {\n  return {\n    name,\n    description: contract.description,\n    inputSchema: mcpContractToInputSchema(contract),\n    internal: Boolean(contract.internal),\n    ownerModule: contract.ownerModule,\n    ontologyPrimitive: contract.ontologyPrimitive,\n    tier: contract.tier,\n  };\n}\n\nexport function isMcpToolAllowed(\n  toolName: string,\n  options: McpToolVisibilityOptions = {}\n): boolean {\n  const contracts = options.contracts ?? buildMcpToolContracts();\n  const contract = contracts[toolName];\n  const alwaysAllowed = new Set([\n    ...MCP_ALWAYS_ALLOWED_TOOL_NAMES,\n    ...(options.alwaysAllowedTools ?? []),\n  ]);\n\n  if (alwaysAllowed.has(toolName)) {\n    return true;\n  }\n  if (options.sessionType === \"user\" && contract?.internal) {\n    return false;\n  }\n\n  if (options.permittedTools !== undefined && options.permittedTools !== null) {\n    return options.permittedTools.some((tool) => tool.toolName === toolName);\n  }\n\n  if (options.sessionType === \"agent\") {\n    if (options.allowedTools === null || options.allowedTools === undefined) {\n      return false;\n    }\n    return options.allowedTools.includes(toolName);\n  }\n\n  if (options.allowedTools === null || options.allowedTools === undefined) {\n    return true;\n  }\n  return options.allowedTools.includes(toolName);\n}\n\nexport function buildMcpToolManifest(args: {\n  contracts?: McpToolContractMap;\n  visibility?: McpToolVisibilityOptions;\n} = {}): McpToolManifestEntry[] {\n  const contracts = args.contracts ?? buildMcpToolContracts();\n  return Object.entries(contracts)\n    .filter(([name, contract]) => {\n      if (args.visibility?.sessionType === \"user\" && contract.internal) {\n        return false;\n      }\n      return isMcpToolAllowed(name, {\n        ...args.visibility,\n        contracts,\n      });\n    })\n    .map(([name, contract]) => mcpContractToManifestEntry(name, contract));\n}\n","export * from \"@lucern/contracts/tool-contracts\";\n\n"]}

package/dist/contradictions/index.d.ts

@@ -1,11 +1,13 @@
 import { PlatformGatewaySuccess } from '../coreClient.js';
-import { L as LucernClientConfig } from '../client-B6aWUUwp.js';
+import { LucernClientConfig } from '../client.js';
 import * as v1 from '@lucern/contracts/graph/v1';
 export { v1 as graphContracts };
 import * as sdkMethods_contract from '@lucern/contracts/sdk-methods.contract';
 export { sdkMethods_contract as methodSchemas };
 import * as toolContracts from '@lucern/contracts/tool-contracts';
 export { toolContracts as toolSchemas };
+import '../authContext.js';
+import '../contracts/auth-session.contract.js';
 import '../types.js';
 import '../contracts/workflow-runtime.contract.js';
 import '../contracts/lens-workflow.contract.js';
@@ -13,28 +15,47 @@ import '../contracts/lens-filter.contract.js';
 import '../audiencesClient.js';
 import '../schemaClient.js';
 import '../harnessClient.js';
-import '../identityClient.js';
 import '../adminClient.js';
 import '../controlObjectOwnership.js';
 import '../beliefsClient.js';
 import '../opinion.js';
+import '../authDeviceClient.js';
+import '../mcpClient.js';
+import '@lucern/contracts/mcp-gateway-boundary.contract';
+import '../identityClient.js';
+import '../accessControl.js';
 import '../packsClient.js';
-import '../customTools.js';
-import 'zod';
+import '../toolRegistryClient.js';
+import '../telemetryClient.js';
+import '../jobsClient.js';
+import '../modelRuntimeClient.js';
+import '../graphStateClassifierClient.js';
+import '../boundaryClientSurface.js';
+import '../ontologyLinksClient.js';
+import '../orgGraphSearchClient.js';
+import '../graphRecommendationsClient.js';
+import '../graphAnalysisClient.js';
+import '@lucern/contracts';
+import '../embeddingsClient.js';
 import '../policyClient.js';
 import '../ontologyClient.js';
 import '../contextTypes.js';
 import '../topicsClient.js';
+import '../functionSurface.js';
 import '../answersClient.js';
 import '../auditClient.js';
 import '../contextClient.js';
+import '../customTools.js';
+import 'zod';
 import '../decisionsClient.js';
 import '../evidenceClient.js';
+import '../eventingClient.js';
 import '../graphClient.js';
 import '../learningClient.js';
 import '../reportsClient.js';
 import '../sourcesClient.js';
 import '../workflowClient.js';
+import '../clientHelpers.js';
 
 type ContradictionsClientConfig = LucernClientConfig;
 type ContradictionsClient = ReturnType<typeof createContradictionsClient>;