@lucern/contracts 1.0.7 → 1.0.9

package/dist/tool-contracts.embeddings.js

@@ -16,6 +16,10 @@ var sharedEmbeddingParameters = {
     type: "string",
     description: "Optional embedding model filter."
   },
+  includeInactive: {
+    type: "boolean",
+    description: "Include archived, superseded, or otherwise inactive epistemic nodes in coverage checks."
+  },
   limit: {
     type: "number",
     description: "Maximum rows to return."

package/dist/tool-contracts.embeddings.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-contracts.embeddings.ts"],"names":[],"mappings":"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","file":"tool-contracts.embeddings.js","sourcesContent":["import type { McpToolContract } from \"./tool-contracts.types\";\n\nconst sharedEmbeddingParameters = {\n  topicId: {\n    type: \"string\",\n    description: \"Topic whose epistemic node embedding index should be queried.\",\n  },\n  workspaceId: {\n    type: \"string\",\n    description: \"Workspace scope for the embedding operation.\",\n  },\n  nodeType: {\n    type: \"string\",\n    description: \"Optional epistemic node type filter.\",\n  },\n  embeddingModel: {\n    type: \"string\",\n    description: \"Optional embedding model filter.\",\n  },\n  limit: {\n    type: \"number\",\n    description: \"Maximum rows to return.\",\n  },\n} satisfies McpToolContract[\"parameters\"];\n\nexport const LIST_MISSING_EMBEDDINGS: McpToolContract = {\n  name: \"list_missing_embeddings\",\n  description:\n    \"List epistemic nodes missing fresh Convex embeddings. \" +\n    \"Like `git status` for the semantic index — shows which graph nodes still need indexing before retrieval can be trusted.\",\n  parameters: sharedEmbeddingParameters,\n  required: [\"topicId\", \"workspaceId\"],\n  response: {\n    description: \"Missing or stale embedding candidates\",\n    fields: {\n      nodes: \"array — node candidates missing fresh embeddings\",\n      total: \"number — candidate count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const SEARCH_EMBEDDINGS: McpToolContract = {\n  name: \"search_embeddings\",\n  description:\n    \"Search topic-scoped epistemic nodes through the Convex vector index. \" +\n    \"Like `git grep` with semantic distance — finds matching beliefs, questions, evidence, and other nodes even when wording differs.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    queryText: {\n      type: \"string\",\n      description: \"Natural-language query to embed and search with.\",\n    },\n    queryVector: {\n      type: \"array\",\n      description: \"Optional precomputed query vector.\",\n    },\n    minScore: {\n      type: \"number\",\n      description: \"Optional minimum cosine-similarity score.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\"],\n  response: {\n    description: \"Vector search matches\",\n    fields: {\n      results: \"array — semantic matches with nodeId, nodeType, score, text, and provenance\",\n      total: \"number — match count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const GET_EMBEDDINGS_BY_NODE_IDS: McpToolContract = {\n  name: \"get_embeddings_by_node_ids\",\n  description:\n    \"Fetch embedding records for explicit epistemic node IDs. \" +\n    \"Like `git show` for semantic-index rows — inspects exactly which vectors exist for named graph nodes.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    nodeIds: {\n      type: \"array\",\n      description: \"Epistemic node IDs to inspect.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\", \"nodeIds\"],\n  response: {\n    description: \"Embedding records for explicit node IDs\",\n    fields: {\n      embeddings: \"array — embedding metadata records\",\n      total: \"number — embedding count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const QUEUE_EMBEDDING_BACKFILL: McpToolContract = {\n  name: \"queue_embedding_backfill\",\n  description:\n    \"Queue background embedding generation for explicit epistemic nodes. \" +\n    \"Like `git add` for semantic-index work — stages graph nodes for the kernel backfill scheduler.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    nodeIds: {\n      type: \"array\",\n      description: \"Epistemic node IDs to queue for embedding generation.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\", \"nodeIds\"],\n  response: {\n    description: \"Backfill queue receipt\",\n    fields: {\n      queued: \"number — queued node count\",\n      nodeIds: \"array — node IDs queued for embedding generation\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n"]}
+{"version":3,"sources":["../src/tool-contracts.embeddings.ts"],"names":[],"mappings":"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","file":"tool-contracts.embeddings.js","sourcesContent":["import type { McpToolContract } from \"./tool-contracts.types\";\n\nconst sharedEmbeddingParameters = {\n  topicId: {\n    type: \"string\",\n    description: \"Topic whose epistemic node embedding index should be queried.\",\n  },\n  workspaceId: {\n    type: \"string\",\n    description: \"Workspace scope for the embedding operation.\",\n  },\n  nodeType: {\n    type: \"string\",\n    description: \"Optional epistemic node type filter.\",\n  },\n  embeddingModel: {\n    type: \"string\",\n    description: \"Optional embedding model filter.\",\n  },\n  includeInactive: {\n    type: \"boolean\",\n    description: \"Include archived, superseded, or otherwise inactive epistemic nodes in coverage checks.\",\n  },\n  limit: {\n    type: \"number\",\n    description: \"Maximum rows to return.\",\n  },\n} satisfies McpToolContract[\"parameters\"];\n\nexport const LIST_MISSING_EMBEDDINGS: McpToolContract = {\n  name: \"list_missing_embeddings\",\n  description:\n    \"List epistemic nodes missing fresh Convex embeddings. \" +\n    \"Like `git status` for the semantic index — shows which graph nodes still need indexing before retrieval can be trusted.\",\n  parameters: sharedEmbeddingParameters,\n  required: [\"topicId\", \"workspaceId\"],\n  response: {\n    description: \"Missing or stale embedding candidates\",\n    fields: {\n      nodes: \"array — node candidates missing fresh embeddings\",\n      total: \"number — candidate count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const SEARCH_EMBEDDINGS: McpToolContract = {\n  name: \"search_embeddings\",\n  description:\n    \"Search topic-scoped epistemic nodes through the Convex vector index. \" +\n    \"Like `git grep` with semantic distance — finds matching beliefs, questions, evidence, and other nodes even when wording differs.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    queryText: {\n      type: \"string\",\n      description: \"Natural-language query to embed and search with.\",\n    },\n    queryVector: {\n      type: \"array\",\n      description: \"Optional precomputed query vector.\",\n    },\n    minScore: {\n      type: \"number\",\n      description: \"Optional minimum cosine-similarity score.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\"],\n  response: {\n    description: \"Vector search matches\",\n    fields: {\n      results: \"array — semantic matches with nodeId, nodeType, score, text, and provenance\",\n      total: \"number — match count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const GET_EMBEDDINGS_BY_NODE_IDS: McpToolContract = {\n  name: \"get_embeddings_by_node_ids\",\n  description:\n    \"Fetch embedding records for explicit epistemic node IDs. \" +\n    \"Like `git show` for semantic-index rows — inspects exactly which vectors exist for named graph nodes.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    nodeIds: {\n      type: \"array\",\n      description: \"Epistemic node IDs to inspect.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\", \"nodeIds\"],\n  response: {\n    description: \"Embedding records for explicit node IDs\",\n    fields: {\n      embeddings: \"array — embedding metadata records\",\n      total: \"number — embedding count\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const QUEUE_EMBEDDING_BACKFILL: McpToolContract = {\n  name: \"queue_embedding_backfill\",\n  description:\n    \"Queue background embedding generation for explicit epistemic nodes. \" +\n    \"Like `git add` for semantic-index work — stages graph nodes for the kernel backfill scheduler.\",\n  parameters: {\n    ...sharedEmbeddingParameters,\n    nodeIds: {\n      type: \"array\",\n      description: \"Epistemic node IDs to queue for embedding generation.\",\n    },\n  },\n  required: [\"topicId\", \"workspaceId\", \"nodeIds\"],\n  response: {\n    description: \"Backfill queue receipt\",\n    fields: {\n      queued: \"number — queued node count\",\n      nodeIds: \"array — node IDs queued for embedding generation\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n"]}

package/dist/tool-contracts.js

@@ -1075,6 +1075,10 @@ var sharedEmbeddingParameters = {
     type: "string",
     description: "Optional embedding model filter."
   },
+  includeInactive: {
+    type: "boolean",
+    description: "Include archived, superseded, or otherwise inactive epistemic nodes in coverage checks."
+  },
   limit: {
     type: "number",
     description: "Maximum rows to return."