@lucern/contracts 1.0.38 → 1.0.39

package/dist/function-registry/index.js

@@ -10,12 +10,16 @@ import { coordinationContracts } from './coordination.js';
 export { coordinationContracts } from './coordination.js';
 import { edgesContracts } from './edges.js';
 export { edgesContracts } from './edges.js';
-import { z } from 'zod';
-import 'convex/values';
+import { embeddingsContracts } from './embeddings.js';
+export { embeddingsContracts } from './embeddings.js';
 import { evidenceContracts } from './evidence.js';
 export { evidenceContracts } from './evidence.js';
 import { graphContracts } from './graph.js';
 export { graphContracts } from './graph.js';
+import { z } from 'zod';
+import 'convex/values';
+import { hybridContracts } from './hybrid.js';
+export { hybridContracts } from './hybrid.js';
 import { identityContracts } from './identity.js';
 export { identityContracts } from './identity.js';
 import { judgmentsContracts } from './judgments.js';
@@ -30,6 +34,8 @@ import { ontologiesContracts } from './ontologies.js';
 export { ontologiesContracts } from './ontologies.js';
 import { pipelineContracts } from './pipeline.js';
 export { pipelineContracts } from './pipeline.js';
+import { policyContracts } from './policy.js';
+export { policyContracts } from './policy.js';
 import { questionsContracts } from './questions.js';
 export { questionsContracts } from './questions.js';
 import { tasksContracts } from './tasks.js';
@@ -6339,256 +6345,6 @@ function assertSurfaceCoverage(contracts) {
     }
   }
 }
-
-// src/function-registry/embeddings.ts
-var nodeType = z.string().optional().describe("Optional epistemic node type filter.");
-var embeddingScopeArgs = z.object({
-  topicId: uuidV7StringSchema.describe(
-    "Topic scope for the embedding operation."
-  ),
-  workspaceId: z.string().optional().describe("Workspace scope for the embedding operation."),
-  nodeType,
-  embeddingModel: z.string().optional().describe("Optional embedding model filter."),
-  includeInactive: z.boolean().optional().describe(
-    "Include archived, superseded, or otherwise inactive epistemic nodes in coverage checks."
-  ),
-  limit: z.number().optional().describe("Maximum rows to return."),
-  cursor: z.string().optional().describe("Pagination cursor.")
-});
-var searchEmbeddingsArgs = embeddingScopeArgs.extend({
-  queryText: z.string().optional().describe("Natural-language query to embed and search with."),
-  queryVector: z.array(z.number()).optional().describe("Optional precomputed query vector."),
-  minScore: z.number().optional().describe("Minimum vector score.")
-});
-var getEmbeddingsArgs = embeddingScopeArgs.extend({
-  nodeIds: z.array(uuidV7StringSchema).describe("Epistemic node IDs to inspect.")
-});
-var queueEmbeddingBackfillArgs = getEmbeddingsArgs.extend({
-  metadata: z.record(z.unknown()).optional().describe("Backfill scheduling metadata.")
-});
-var passthroughInput = (input) => compactRecord(input);
-var embeddingsContracts = [
-  surfaceContract({
-    name: "list_missing_embeddings",
-    kind: "query",
-    domain: "embeddings",
-    surfaceClass: "platform_public",
-    method: "GET",
-    path: "/embeddings/missing",
-    sdkNamespace: "embeddings",
-    sdkMethod: "listMissingForTopic",
-    summary: "List epistemic nodes missing fresh Convex embeddings.",
-    convex: {
-      module: "embeddings",
-      functionName: "listMissingForTopic",
-      kind: "query",
-      componentPath: "lucern",
-      inputProjection: passthroughInput
-    },
-    args: embeddingScopeArgs
-  }),
-  surfaceContract({
-    name: "search_embeddings",
-    kind: "action",
-    domain: "embeddings",
-    surfaceClass: "platform_public",
-    path: "/embeddings/vector-search",
-    sdkNamespace: "embeddings",
-    sdkMethod: "vectorSearchByTopic",
-    summary: "Search topic-scoped epistemic nodes through the Convex vector index.",
-    idempotent: false,
-    effects: ["read"],
-    scopes: ["embeddings.read"],
-    convex: {
-      module: "embeddings",
-      functionName: "vectorSearchByTopic",
-      kind: "action",
-      componentPath: "lucern",
-      inputProjection: passthroughInput
-    },
-    args: searchEmbeddingsArgs
-  }),
-  surfaceContract({
-    name: "get_embeddings_by_node_ids",
-    kind: "query",
-    domain: "embeddings",
-    surfaceClass: "platform_public",
-    path: "/embeddings/by-node-ids",
-    sdkNamespace: "embeddings",
-    sdkMethod: "getByNodeIds",
-    summary: "Fetch embedding records for explicit epistemic node IDs.",
-    convex: {
-      module: "embeddings",
-      functionName: "getByNodeIds",
-      kind: "query",
-      componentPath: "lucern",
-      inputProjection: passthroughInput
-    },
-    args: getEmbeddingsArgs
-  }),
-  surfaceContract({
-    name: "queue_embedding_backfill",
-    kind: "mutation",
-    domain: "embeddings",
-    surfaceClass: "platform_public",
-    path: "/embeddings/backfill-queued",
-    sdkNamespace: "embeddings",
-    sdkMethod: "markEmbeddingBackfillQueued",
-    summary: "Queue background embedding generation for explicit epistemic nodes.",
-    convex: {
-      module: "embeddings",
-      functionName: "markEmbeddingBackfillQueued",
-      kind: "mutation",
-      componentPath: "lucern",
-      inputProjection: passthroughInput
-    },
-    args: queueEmbeddingBackfillArgs
-  })
-];
-var includeKindSchema = z.enum([
-  "topics",
-  "nodes",
-  "worktrees",
-  "tasks",
-  "evidence",
-  "edges"
-]);
-var viaKindSchema = z.enum([
-  "bm25",
-  "embeddings",
-  "edges",
-  "topic-tree",
-  "state",
-  "graph-algorithms"
-]);
-var hybridPlannerArgs = z.object({
-  query: z.string().optional().describe("Natural-language query text."),
-  queryText: z.string().optional().describe("Explicit query text alias."),
-  text: z.string().optional().describe("Raw pasted text to use as query input."),
-  topicId: uuidV7StringSchema.optional().describe("Optional topic scope."),
-  workspaceId: z.string().optional().describe("Optional workspace scope."),
-  nodeId: uuidV7StringSchema.optional().describe("Optional source node."),
-  include: z.array(includeKindSchema).optional().describe("Result families to include."),
-  via: z.array(viaKindSchema).optional().describe("Retrieval methods to use."),
-  depth: z.number().optional().describe("Graph expansion depth."),
-  limit: z.number().optional().describe("Maximum rows per result family."),
-  minScore: z.number().optional().describe("Minimum fused score."),
-  campaign: z.number().optional().describe("Optional worktree campaign filter."),
-  lane: z.string().optional().describe("Optional worktree lane filter."),
-  status: z.string().optional().describe("Optional state/status filter."),
-  nodeType: z.string().optional().describe("Single node type filter."),
-  nodeTypes: z.array(z.string()).optional().describe("Node type filters."),
-  changedPaths: z.array(z.string()).optional().describe("Changed file path signals."),
-  metadata: z.record(z.unknown()).optional().describe("Planner metadata.")
-});
-var modeInput = (mode) => (input) => compactRecord({
-  ...input,
-  mode,
-  queryText: input.queryText ?? input.query ?? input.text
-});
-function hybridContract(args) {
-  return surfaceContract({
-    name: args.name,
-    kind: "action",
-    domain: "hybrid",
-    surfaceClass: "platform_public",
-    path: args.path,
-    sdkNamespace: "hybrid",
-    sdkMethod: args.sdkMethod,
-    summary: args.summary,
-    idempotent: false,
-    effects: ["read"],
-    scopes: ["hybrid.read"],
-    convex: {
-      module: "hybridDiscovery",
-      functionName: args.sdkMethod,
-      kind: "action",
-      componentPath: "lucern",
-      inputProjection: modeInput(args.mode)
-    },
-    args: hybridPlannerArgs
-  });
-}
-var hybridContracts = [
-  hybridContract({
-    name: "hybrid_discover",
-    path: "/hybrid/discover",
-    sdkMethod: "hybridDiscover",
-    summary: "Discover typed graph context with BM25, embeddings, topic tree traversal, and graph neighborhoods.",
-    mode: "discover"
-  }),
-  hybridContract({
-    name: "resolve_topic_semantic",
-    path: "/hybrid/topics/resolve",
-    sdkMethod: "resolveTopicSemantic",
-    summary: "Resolve an ambiguous topic using BM25, vector candidates, and topic-tree context.",
-    mode: "resolve_topic"
-  }),
-  hybridContract({
-    name: "expand_graph_neighborhood",
-    path: "/hybrid/neighborhood",
-    sdkMethod: "expandGraphNeighborhood",
-    summary: "Expand a typed graph neighborhood around a query, topic, or node.",
-    mode: "neighborhood"
-  }),
-  hybridContract({
-    name: "find_related_nodes",
-    path: "/hybrid/related-nodes",
-    sdkMethod: "findRelatedNodes",
-    summary: "Find semantically and structurally related nodes across the reasoning graph.",
-    mode: "related_nodes"
-  }),
-  hybridContract({
-    name: "analyze_graph_impact",
-    path: "/hybrid/impact",
-    sdkMethod: "analyzeGraphImpact",
-    summary: "Analyze which graph objects are affected by files, PR text, incidents, or campaign objectives.",
-    mode: "impact"
-  }),
-  hybridContract({
-    name: "detect_graph_drift",
-    path: "/hybrid/drift",
-    sdkMethod: "detectGraphDrift",
-    summary: "Detect duplicate, stale, orphaned, or weakly linked reasoning graph surface.",
-    mode: "drift"
-  })
-];
-var graphPolicyFactsSchema = z.object({
-  principal: z.record(z.unknown()).optional(),
-  resource: z.record(z.unknown()),
-  request: z.record(z.unknown())
-}).strict();
-var permitDecisionSchema = z.record(z.unknown());
-var policyContracts = [
-  surfaceContract({
-    name: "compile_capability_slice",
-    kind: "query",
-    domain: "policy",
-    surfaceClass: "platform_public",
-    path: "/policy/capability-slice",
-    sdkNamespace: "policy",
-    sdkMethod: "compileCapabilitySlice",
-    summary: "Compile a Permit-filtered graph context package with public-safe omission records.",
-    gateway: {
-      handler: "policy.compileCapabilitySlice"
-    },
-    args: z.object({
-      sliceUuid: z.string().min(1).optional(),
-      context: z.string().min(1).optional(),
-      surface: z.string().min(1).optional(),
-      baseFacts: graphPolicyFactsSchema,
-      nodes: z.array(z.record(z.unknown())),
-      edges: z.array(z.record(z.unknown())).optional(),
-      fallbackPermitDecision: permitDecisionSchema.optional(),
-      permitDecision: permitDecisionSchema.optional(),
-      permitDecisionsByResourceId: z.record(permitDecisionSchema).optional(),
-      policyDecisionId: z.string().min(1).optional(),
-      decisionLogId: z.string().min(1).optional(),
-      traceId: z.string().min(1).optional(),
-      decisionProof: z.string().min(1).optional()
-    }).strict()
-  })
-];
 var ALL_FUNCTION_CONTRACTS = [
   ...contextContracts,
   ...identityContracts,
@@ -6624,4 +6380,4 @@ var getFunctionContract = FUNCTION_CONTRACTS_BY_NAME.get.bind(
   FUNCTION_CONTRACTS_BY_NAME
 );
 
-export { ALL_FUNCTION_CONTRACTS, DUPLICATE_OPERATION_NAMES, FORBIDDEN_APPLICATION_OPERATION_NAMES, FUNCTION_CONTRACTS_BY_NAME, FUNCTION_SURFACE_CONTRACTS, LEGACY_COMPAT_OPERATION_NAMES, LUCERN_OPERATION_MANIFEST, MCP_ANALYSIS_PLATFORM_OPERATION_NAMES, MCP_ANALYSIS_TENANT_OPERATION_NAMES, MCP_AUTOMATION_OPERATION_NAMES, MCP_CORE_OPERATION_NAMES, MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES, MCP_GOVERNANCE_TENANT_OPERATION_NAMES, MCP_ONLY_INTERNAL_OPERATION_NAMES, MCP_WORKFLOW_PLATFORM_OPERATION_NAMES, MCP_WORKFLOW_TENANT_OPERATION_NAMES, NODE_TYPE, PLATFORM_INTERNAL_OPERATION_NAMES, PLATFORM_PUBLIC_OPERATION_NAMES, SDK_ONLY_OPERATION_NAMES, TENANT_PUBLIC_OPERATION_NAMES, TOPIC_TYPE_VALUES, WORKTREE_TYPE_VALUES, actingPrincipalId, argsSchemaFromMcpContract, assertSurfaceCoverage, authUserId, classifyContract, compactRecord, defineFunctionContract, embeddingsContracts, generateUuidV7, getFunctionContract, hybridContracts, inputSchemaFromMcpContract, isUuidV7, jsonObjectSchema, policyContracts, recordValue, surfaceContract, surfaceEnabled, surfaceIntentGateViolations, surfaceMcpContract, uuidV7StringSchema, withCreatedBy, withCreatedByAndOwnerPrincipal, withUserId };
+export { ALL_FUNCTION_CONTRACTS, DUPLICATE_OPERATION_NAMES, FORBIDDEN_APPLICATION_OPERATION_NAMES, FUNCTION_CONTRACTS_BY_NAME, FUNCTION_SURFACE_CONTRACTS, LEGACY_COMPAT_OPERATION_NAMES, LUCERN_OPERATION_MANIFEST, MCP_ANALYSIS_PLATFORM_OPERATION_NAMES, MCP_ANALYSIS_TENANT_OPERATION_NAMES, MCP_AUTOMATION_OPERATION_NAMES, MCP_CORE_OPERATION_NAMES, MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES, MCP_GOVERNANCE_TENANT_OPERATION_NAMES, MCP_ONLY_INTERNAL_OPERATION_NAMES, MCP_WORKFLOW_PLATFORM_OPERATION_NAMES, MCP_WORKFLOW_TENANT_OPERATION_NAMES, NODE_TYPE, PLATFORM_INTERNAL_OPERATION_NAMES, PLATFORM_PUBLIC_OPERATION_NAMES, SDK_ONLY_OPERATION_NAMES, TENANT_PUBLIC_OPERATION_NAMES, TOPIC_TYPE_VALUES, WORKTREE_TYPE_VALUES, actingPrincipalId, argsSchemaFromMcpContract, assertSurfaceCoverage, authUserId, classifyContract, compactRecord, defineFunctionContract, generateUuidV7, getFunctionContract, inputSchemaFromMcpContract, isUuidV7, jsonObjectSchema, recordValue, surfaceContract, surfaceEnabled, surfaceIntentGateViolations, surfaceMcpContract, uuidV7StringSchema, withCreatedBy, withCreatedByAndOwnerPrincipal, withUserId };