@lucern/contracts 0.3.0-alpha.12 → 0.3.0-alpha.14

package/dist/function-registry/manifest.d.ts

@@ -1,7 +1,7 @@
 import { SurfaceClass, FunctionSurfaceIntent, FunctionSurfaceMap, SurfaceExposure } from './types.js';
 import 'zod';
 import '../defineFunction-DO97DKs4.js';
-import '../tool-contracts-BevD9Ho2.js';
+import '../tool-contracts-C_xvM9q2.js';
 
 type LucernOperationManifestEntry = {
     name: string;
@@ -10,7 +10,7 @@ type LucernOperationManifestEntry = {
     surfaces: FunctionSurfaceMap;
     rationale: string;
 };
-declare const MCP_CORE_OPERATION_NAMES: readonly ["compile_context", "identity_whoami", "check_permission", "filter_by_permission", "create_belief", "get_belief", "list_beliefs", "refine_belief", "modulate_confidence", "fork_belief", "archive_belief", "search_beliefs", "bisect_confidence", "create_evidence", "get_evidence", "list_evidence", "search_evidence", "link_evidence_to_belief", "link_evidence_to_question", "create_question", "get_question", "list_questions", "refine_question", "update_question_status", "archive_question", "create_answer", "get_answer", "find_missing_questions", "get_high_priority_questions", "get_falsification_questions", "create_epistemic_node", "get_epistemic_node", "list_epistemic_nodes", "update_epistemic_node", "archive_epistemic_node", "verify_epistemic_node", "supersede_epistemic_node", "batch_create_epistemic_nodes", "create_topic", "get_topic", "list_topics", "update_topic", "get_topic_tree", "materialize_topic_graph", "get_topic_graph_spine"];
+declare const MCP_CORE_OPERATION_NAMES: readonly ["compile_context", "identity_whoami", "resolve_interactive_principal", "check_permission", "filter_by_permission", "create_belief", "get_belief", "list_beliefs", "refine_belief", "modulate_confidence", "fork_belief", "archive_belief", "search_beliefs", "bisect_confidence", "create_evidence", "get_evidence", "list_evidence", "search_evidence", "link_evidence_to_belief", "link_evidence_to_question", "create_question", "get_question", "list_questions", "refine_question", "update_question_status", "archive_question", "create_answer", "get_answer", "find_missing_questions", "get_high_priority_questions", "get_falsification_questions", "create_epistemic_node", "get_epistemic_node", "list_epistemic_nodes", "update_epistemic_node", "archive_epistemic_node", "verify_epistemic_node", "supersede_epistemic_node", "batch_create_epistemic_nodes", "create_topic", "get_topic", "list_topics", "update_topic", "get_topic_tree", "materialize_topic_graph", "get_topic_graph_spine"];
 declare const MCP_ANALYSIS_PLATFORM_OPERATION_NAMES: readonly ["create_edge", "update_edge", "remove_edge", "remove_edges_between", "batch_create_edges", "query_lineage", "traverse_graph", "get_graph_neighborhood", "get_graph_structure_analysis", "list_graph_intelligence_queries", "run_graph_intelligence_query", "find_contradictions", "flag_contradiction", "detect_confirmation_bias", "get_topic_coverage", "get_graph_gaps"];
 declare const MCP_ANALYSIS_TENANT_OPERATION_NAMES: readonly ["analyze_topic_density", "discover_entity_connections", "trace_entity_impact"];
 declare const MCP_WORKFLOW_PLATFORM_OPERATION_NAMES: readonly ["list_lenses", "apply_lens_to_topic", "remove_lens_from_topic", "get_ontology", "list_ontologies", "apply_ontology", "match_entity_type", "resolve_effective_ontology", "add_worktree", "activate_worktree", "list_worktrees", "list_all_worktrees", "list_campaigns", "update_worktree_targets", "update_worktree_metadata", "create_task", "list_tasks", "update_task", "complete_task"];
@@ -19,7 +19,7 @@ declare const MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES: readonly ["create_lens",
 declare const MCP_GOVERNANCE_TENANT_OPERATION_NAMES: readonly ["create_epistemic_contract", "evaluate_contract", "get_contract_status", "publish_ontology_version", "deprecate_ontology_version", "manage_write_policy"];
 declare const MCP_AUTOMATION_OPERATION_NAMES: readonly ["apply_auto_branching", "trigger_belief_review"];
 declare const DUPLICATE_OPERATION_NAMES: readonly ["link_evidence"];
-declare const PLATFORM_PUBLIC_OPERATION_NAMES: readonly ["compile_context", "identity_whoami", "check_permission", "filter_by_permission", "create_belief", "get_belief", "list_beliefs", "refine_belief", "modulate_confidence", "fork_belief", "archive_belief", "search_beliefs", "bisect_confidence", "create_evidence", "get_evidence", "list_evidence", "search_evidence", "link_evidence_to_belief", "link_evidence_to_question", "create_question", "get_question", "list_questions", "refine_question", "update_question_status", "archive_question", "create_answer", "get_answer", "find_missing_questions", "get_high_priority_questions", "get_falsification_questions", "create_epistemic_node", "get_epistemic_node", "list_epistemic_nodes", "update_epistemic_node", "archive_epistemic_node", "verify_epistemic_node", "supersede_epistemic_node", "batch_create_epistemic_nodes", "create_topic", "get_topic", "list_topics", "update_topic", "get_topic_tree", "materialize_topic_graph", "get_topic_graph_spine", "create_edge", "update_edge", "remove_edge", "remove_edges_between", "batch_create_edges", "query_lineage", "traverse_graph", "get_graph_neighborhood", "get_graph_structure_analysis", "list_graph_intelligence_queries", "run_graph_intelligence_query", "find_contradictions", "flag_contradiction", "detect_confirmation_bias", "get_topic_coverage", "get_graph_gaps", "list_lenses", "apply_lens_to_topic", "remove_lens_from_topic", "get_ontology", "list_ontologies", "apply_ontology", "match_entity_type", "resolve_effective_ontology", "add_worktree", "activate_worktree", "list_worktrees", "list_all_worktrees", "list_campaigns", "update_worktree_targets", "update_worktree_metadata", "create_task", "list_tasks", "update_task", "complete_task", "create_lens", "create_ontology", "update_ontology", "archive_ontology", "create_ontology_version", "link_evidence"];
+declare const PLATFORM_PUBLIC_OPERATION_NAMES: readonly ["compile_context", "identity_whoami", "resolve_interactive_principal", "check_permission", "filter_by_permission", "create_belief", "get_belief", "list_beliefs", "refine_belief", "modulate_confidence", "fork_belief", "archive_belief", "search_beliefs", "bisect_confidence", "create_evidence", "get_evidence", "list_evidence", "search_evidence", "link_evidence_to_belief", "link_evidence_to_question", "create_question", "get_question", "list_questions", "refine_question", "update_question_status", "archive_question", "create_answer", "get_answer", "find_missing_questions", "get_high_priority_questions", "get_falsification_questions", "create_epistemic_node", "get_epistemic_node", "list_epistemic_nodes", "update_epistemic_node", "archive_epistemic_node", "verify_epistemic_node", "supersede_epistemic_node", "batch_create_epistemic_nodes", "create_topic", "get_topic", "list_topics", "update_topic", "get_topic_tree", "materialize_topic_graph", "get_topic_graph_spine", "create_edge", "update_edge", "remove_edge", "remove_edges_between", "batch_create_edges", "query_lineage", "traverse_graph", "get_graph_neighborhood", "get_graph_structure_analysis", "list_graph_intelligence_queries", "run_graph_intelligence_query", "find_contradictions", "flag_contradiction", "detect_confirmation_bias", "get_topic_coverage", "get_graph_gaps", "list_lenses", "apply_lens_to_topic", "remove_lens_from_topic", "get_ontology", "list_ontologies", "apply_ontology", "match_entity_type", "resolve_effective_ontology", "add_worktree", "activate_worktree", "list_worktrees", "list_all_worktrees", "list_campaigns", "update_worktree_targets", "update_worktree_metadata", "create_task", "list_tasks", "update_task", "complete_task", "create_lens", "create_ontology", "update_ontology", "archive_ontology", "create_ontology_version", "link_evidence"];
 declare const TENANT_PUBLIC_OPERATION_NAMES: readonly ["analyze_topic_density", "discover_entity_connections", "trace_entity_impact", "resolve_effective_ontology", "get_observation_context", "ingest_observation", "merge", "create_epistemic_contract", "evaluate_contract", "get_contract_status", "publish_ontology_version", "deprecate_ontology_version", "manage_write_policy", "apply_auto_branching", "trigger_belief_review"];
 declare const PLATFORM_INTERNAL_OPERATION_NAMES: readonly ["register_session", "heartbeat_session", "end_session", "list_active_sessions", "send_agent_message", "broadcast_message", "get_agent_inbox", "claim_files", "generate_session_handoff", "record_scope_learning", "pipeline_snapshot", "seed_belief_lattice", "get_lattice_coverage", "get_code_context", "get_change_history", "get_failure_log", "record_attempt", "begin_build_session", "push", "open_pull_request", "record_judgment", "get_audit_trail"];
 declare const LEGACY_COMPAT_OPERATION_NAMES: readonly ["discover", "add_evidence", "answer_question", "get_confidence_history"];

package/dist/function-registry/manifest.js

@@ -52,6 +52,7 @@ function entries(names, surfaceClass, surfaceIntent, surfaces, rationale) {
 var MCP_CORE_OPERATION_NAMES = [
   "compile_context",
   "identity_whoami",
+  "resolve_interactive_principal",
   "check_permission",
   "filter_by_permission",
   "create_belief",

package/dist/function-registry/manifest.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/function-registry/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["import type {\n  FunctionSurfaceIntent,\n  SurfaceClass,\n  SurfaceExposure,\n  FunctionSurfaceMap,\n} from \"./types.js\";\n\nexport type LucernOperationManifestEntry = {\n  name: string;\n  surfaceClass: SurfaceClass;\n  surfaceIntent: FunctionSurfaceIntent;\n  surfaces: FunctionSurfaceMap;\n  rationale: string;\n};\n\nconst publicEverywhere: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"public\",\n  cli: \"public\",\n};\n\nconst internalSystem: FunctionSurfaceMap = {\n  sdk: \"internal\",\n  rest: \"internal\",\n  mcp: \"internal\",\n  cli: \"internal\",\n};\n\nconst publicWithInternalMcp: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"internal\",\n  cli: \"public\",\n};\n\nconst publicWithoutMcp: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"none\",\n  cli: \"none\",\n};\n\nconst sdkOnlyPublic: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"none\",\n  mcp: \"none\",\n  cli: \"none\",\n};\n\nconst mcpOnlyInternal: FunctionSurfaceMap = {\n  sdk: \"none\",\n  rest: \"none\",\n  mcp: \"internal\",\n  cli: \"none\",\n};\n\nfunction entries(\n  names: readonly string[],\n  surfaceClass: SurfaceClass,\n  surfaceIntent: FunctionSurfaceIntent,\n  surfaces: FunctionSurfaceMap,\n  rationale: string\n): Record<string, LucernOperationManifestEntry> {\n  return Object.fromEntries(\n    names.map((name) => [\n      name,\n      {\n        name,\n        surfaceClass,\n        surfaceIntent,\n        surfaces,\n        rationale,\n      },\n    ])\n  );\n}\n\nexport const MCP_CORE_OPERATION_NAMES = [\n  \"compile_context\",\n  \"identity_whoami\",\n  \"check_permission\",\n  \"filter_by_permission\",\n  \"create_belief\",\n  \"get_belief\",\n  \"list_beliefs\",\n  \"refine_belief\",\n  \"modulate_confidence\",\n  \"fork_belief\",\n  \"archive_belief\",\n  \"search_beliefs\",\n  \"bisect_confidence\",\n  \"create_evidence\",\n  \"get_evidence\",\n  \"list_evidence\",\n  \"search_evidence\",\n  \"link_evidence_to_belief\",\n  \"link_evidence_to_question\",\n  \"create_question\",\n  \"get_question\",\n  \"list_questions\",\n  \"refine_question\",\n  \"update_question_status\",\n  \"archive_question\",\n  \"create_answer\",\n  \"get_answer\",\n  \"find_missing_questions\",\n  \"get_high_priority_questions\",\n  \"get_falsification_questions\",\n  \"create_epistemic_node\",\n  \"get_epistemic_node\",\n  \"list_epistemic_nodes\",\n  \"update_epistemic_node\",\n  \"archive_epistemic_node\",\n  \"verify_epistemic_node\",\n  \"supersede_epistemic_node\",\n  \"batch_create_epistemic_nodes\",\n  \"create_topic\",\n  \"get_topic\",\n  \"list_topics\",\n  \"update_topic\",\n  \"get_topic_tree\",\n  \"materialize_topic_graph\",\n  \"get_topic_graph_spine\",\n] as const;\n\nexport const MCP_ANALYSIS_PLATFORM_OPERATION_NAMES = [\n  \"create_edge\",\n  \"update_edge\",\n  \"remove_edge\",\n  \"remove_edges_between\",\n  \"batch_create_edges\",\n  \"query_lineage\",\n  \"traverse_graph\",\n  \"get_graph_neighborhood\",\n  \"get_graph_structure_analysis\",\n  \"list_graph_intelligence_queries\",\n  \"run_graph_intelligence_query\",\n  \"find_contradictions\",\n  \"flag_contradiction\",\n  \"detect_confirmation_bias\",\n  \"get_topic_coverage\",\n  \"get_graph_gaps\",\n] as const;\n\nexport const MCP_ANALYSIS_TENANT_OPERATION_NAMES = [\n  \"analyze_topic_density\",\n  \"discover_entity_connections\",\n  \"trace_entity_impact\",\n] as const;\n\nexport const MCP_WORKFLOW_PLATFORM_OPERATION_NAMES = [\n  \"list_lenses\",\n  \"apply_lens_to_topic\",\n  \"remove_lens_from_topic\",\n  \"get_ontology\",\n  \"list_ontologies\",\n  \"apply_ontology\",\n  \"match_entity_type\",\n  \"resolve_effective_ontology\",\n  \"add_worktree\",\n  \"activate_worktree\",\n  \"list_worktrees\",\n  \"list_all_worktrees\",\n  \"list_campaigns\",\n  \"update_worktree_targets\",\n  \"update_worktree_metadata\",\n  \"create_task\",\n  \"list_tasks\",\n  \"update_task\",\n  \"complete_task\",\n] as const;\n\nexport const MCP_WORKFLOW_TENANT_OPERATION_NAMES = [\n  \"resolve_effective_ontology\",\n  \"get_observation_context\",\n  \"ingest_observation\",\n  \"merge\",\n] as const;\n\nexport const MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES = [\n  \"create_lens\",\n  \"create_ontology\",\n  \"update_ontology\",\n  \"archive_ontology\",\n  \"create_ontology_version\",\n] as const;\n\nexport const MCP_GOVERNANCE_TENANT_OPERATION_NAMES = [\n  \"create_epistemic_contract\",\n  \"evaluate_contract\",\n  \"get_contract_status\",\n  \"publish_ontology_version\",\n  \"deprecate_ontology_version\",\n  \"manage_write_policy\",\n] as const;\n\nexport const MCP_AUTOMATION_OPERATION_NAMES = [\n  \"apply_auto_branching\",\n  \"trigger_belief_review\",\n] as const;\n\nexport const DUPLICATE_OPERATION_NAMES = [\n  \"link_evidence\",\n] as const;\n\nexport const PLATFORM_PUBLIC_OPERATION_NAMES = [\n  ...MCP_CORE_OPERATION_NAMES,\n  ...MCP_ANALYSIS_PLATFORM_OPERATION_NAMES,\n  ...MCP_WORKFLOW_PLATFORM_OPERATION_NAMES,\n  ...MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES,\n  ...DUPLICATE_OPERATION_NAMES,\n] as const;\n\nexport const TENANT_PUBLIC_OPERATION_NAMES = [\n  ...MCP_ANALYSIS_TENANT_OPERATION_NAMES,\n  ...MCP_WORKFLOW_TENANT_OPERATION_NAMES,\n  ...MCP_GOVERNANCE_TENANT_OPERATION_NAMES,\n  ...MCP_AUTOMATION_OPERATION_NAMES,\n] as const;\n\nexport const PLATFORM_INTERNAL_OPERATION_NAMES = [\n  \"register_session\",\n  \"heartbeat_session\",\n  \"end_session\",\n  \"list_active_sessions\",\n  \"send_agent_message\",\n  \"broadcast_message\",\n  \"get_agent_inbox\",\n  \"claim_files\",\n  \"generate_session_handoff\",\n  \"record_scope_learning\",\n  \"pipeline_snapshot\",\n  \"seed_belief_lattice\",\n  \"get_lattice_coverage\",\n  \"get_code_context\",\n  \"get_change_history\",\n  \"get_failure_log\",\n  \"record_attempt\",\n  \"begin_build_session\",\n  \"push\",\n  \"open_pull_request\",\n  \"record_judgment\",\n  \"get_audit_trail\",\n] as const;\n\nexport const LEGACY_COMPAT_OPERATION_NAMES = [\n  \"discover\",\n  \"add_evidence\",\n  \"answer_question\",\n  \"get_confidence_history\",\n] as const;\n\nexport const SDK_ONLY_OPERATION_NAMES = [\n  \"start_worktree\",\n  \"update_worktree_phase\",\n  \"advance_worktree_phase\",\n  \"add_note_to_worktree\",\n  \"link_document_to_worktree\",\n  \"link_evidence_to_worktree\",\n  \"link_question_to_worktree\",\n  \"link_belief_to_worktree\",\n  \"create_synthesized_belief\",\n  \"complete_hypothesis_formation\",\n  \"complete_evidence_review\",\n  \"refine_worktree_belief\",\n  \"trace_provenance\",\n  \"get_belief_relationships\",\n  \"get_belief_support_chain\",\n  \"explore_connections\",\n  \"get_deep_lineage\",\n  \"graph_aware_search\",\n  \"get_collection_conviction\",\n  \"get_conviction_trend\",\n  \"analyze_belief_criticality\",\n  \"analyze_belief_cluster_candidates\",\n  \"create_belief_conditional\",\n  \"get_necessary_evidence\",\n  \"analyze_reasoning_depth\",\n  \"get_evidence_by_methodology\",\n  \"create_evidence_task\",\n  \"get_task_counts\",\n  \"add_research_action\",\n  \"get_predictions\",\n  \"get_surprise_detection\",\n  \"get_challenged_beliefs\",\n  \"get_causal_chains\",\n  \"get_non_consensus_beliefs\",\n  \"get_beliefs_by_epistemic_status\",\n  \"detect_anchoring_bias\",\n  \"detect_source_concentration\",\n  \"find_soft_contradictions\",\n  \"find_semantic_bridges\",\n  \"find_semantic_orphans\",\n] as const;\n\nexport const MCP_ONLY_INTERNAL_OPERATION_NAMES = [\n  \"evaluate_engineering_contract\",\n  \"evaluate_research_contract\",\n] as const;\n\nexport const FORBIDDEN_APPLICATION_OPERATION_NAMES = [\n  \"execute_deep_research\",\n  \"search_sources\",\n  \"search_resources\",\n  \"get_privileged_evidence\",\n  \"get_privileged_signals\",\n  \"get_thesis_artifacts\",\n] as const;\n\nexport const LUCERN_OPERATION_MANIFEST = {\n  ...entries(\n    MCP_CORE_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_core\",\n    publicEverywhere,\n    \"Default conversational Lucern MCP primitive for reading, writing, and shaping the reasoning graph.\"\n  ),\n  ...entries(\n    MCP_ANALYSIS_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"High-signal graph analysis operation that belongs in chat/MCP because users naturally ask for gaps, contradictions, lineage, and coverage.\"\n  ),\n  ...entries(\n    MCP_ANALYSIS_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"Tenant-scoped analysis operation that remains MCP-visible because agents can answer graph-quality and impact questions from chat.\"\n  ),\n  ...entries(\n    MCP_WORKFLOW_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_workflow\",\n    publicEverywhere,\n    \"Workflow operation expected by coding agents and human MCP users managing Lucern worktrees, tasks, lenses, and observations.\"\n  ),\n  ...entries(\n    MCP_WORKFLOW_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_workflow\",\n    publicEverywhere,\n    \"Tenant-scoped workflow operation expected by coding agents and human MCP users managing observations and worktree lifecycle.\"\n  ),\n  ...entries(\n    MCP_AUTOMATION_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"Tenant-scoped automation that remains MCP-visible because agents can explicitly request review or branching assistance.\"\n  ),\n  ...entries(\n    MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_governance\",\n    publicWithInternalMcp,\n    \"Governance/admin operation. SDK, REST, and CLI remain public, but MCP is internal by default to keep chat surfaces focused.\"\n  ),\n  ...entries(\n    MCP_GOVERNANCE_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_governance\",\n    publicWithInternalMcp,\n    \"Governance/admin operation. SDK, REST, and CLI remain public, but MCP is internal by default to keep chat surfaces focused.\"\n  ),\n  ...entries(\n    DUPLICATE_OPERATION_NAMES,\n    \"platform_public\",\n    \"compatibility\",\n    publicWithoutMcp,\n    \"Duplicate compatibility operation kept for SDK/REST callers, removed from MCP/CLI discovery in favor of the canonical specific tool.\"\n  ),\n  ...entries(\n    PLATFORM_INTERNAL_OPERATION_NAMES,\n    \"platform_internal\",\n    \"system\",\n    internalSystem,\n    \"Lucern system/background operation. Available to platform code paths, hidden from public MCP discovery.\"\n  ),\n  ...entries(\n    LEGACY_COMPAT_OPERATION_NAMES,\n    \"legacy_compat\",\n    \"compatibility\",\n    publicWithoutMcp,\n    \"Temporary compatibility operation. Must name a canonical replacement before removal.\"\n  ),\n  ...entries(\n    SDK_ONLY_OPERATION_NAMES,\n    \"tenant_public\",\n    \"sdk_granular\",\n    sdkOnlyPublic,\n    \"Granular Lucern SDK operation. Not an MCP, REST, or CLI tool until backed by the generated function pipe.\"\n  ),\n  ...entries(\n    MCP_ONLY_INTERNAL_OPERATION_NAMES,\n    \"platform_internal\",\n    \"system\",\n    mcpOnlyInternal,\n    \"Lucern MCP-only platform operation for local agent/bootstrap or verification workflows. Hidden from public discovery.\"\n  ),\n} as const satisfies Record<string, LucernOperationManifestEntry>;\n\nexport type LucernOperationName = keyof typeof LUCERN_OPERATION_MANIFEST;\n\nexport function surfaceEnabled(exposure: SurfaceExposure): boolean {\n  return exposure !== \"none\";\n}\n\nexport function surfaceIntentGateViolations(\n  entry: LucernOperationManifestEntry\n): string[] {\n  const violations: string[] = [];\n  if (entry.surfaceIntent === \"system\" && entry.surfaces.mcp === \"public\") {\n    violations.push(\"system operations cannot be public MCP tools\");\n  }\n  if (\n    entry.surfaceIntent === \"compatibility\" &&\n    entry.surfaces.mcp !== \"none\"\n  ) {\n    violations.push(\"compatibility operations must not be MCP tools\");\n  }\n  if (entry.surfaceIntent === \"sdk_granular\" && entry.surfaces.mcp !== \"none\") {\n    violations.push(\"SDK-granular operations must not be MCP tools\");\n  }\n  if (\n    entry.surfaceIntent === \"mcp_governance\" &&\n    entry.surfaces.mcp === \"public\"\n  ) {\n    violations.push(\"governance operations must be internal or absent from MCP\");\n  }\n  return violations;\n}\n"]}
+{"version":3,"sources":["../../src/function-registry/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["import type {\n  FunctionSurfaceIntent,\n  SurfaceClass,\n  SurfaceExposure,\n  FunctionSurfaceMap,\n} from \"./types.js\";\n\nexport type LucernOperationManifestEntry = {\n  name: string;\n  surfaceClass: SurfaceClass;\n  surfaceIntent: FunctionSurfaceIntent;\n  surfaces: FunctionSurfaceMap;\n  rationale: string;\n};\n\nconst publicEverywhere: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"public\",\n  cli: \"public\",\n};\n\nconst internalSystem: FunctionSurfaceMap = {\n  sdk: \"internal\",\n  rest: \"internal\",\n  mcp: \"internal\",\n  cli: \"internal\",\n};\n\nconst publicWithInternalMcp: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"internal\",\n  cli: \"public\",\n};\n\nconst publicWithoutMcp: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"public\",\n  mcp: \"none\",\n  cli: \"none\",\n};\n\nconst sdkOnlyPublic: FunctionSurfaceMap = {\n  sdk: \"public\",\n  rest: \"none\",\n  mcp: \"none\",\n  cli: \"none\",\n};\n\nconst mcpOnlyInternal: FunctionSurfaceMap = {\n  sdk: \"none\",\n  rest: \"none\",\n  mcp: \"internal\",\n  cli: \"none\",\n};\n\nfunction entries(\n  names: readonly string[],\n  surfaceClass: SurfaceClass,\n  surfaceIntent: FunctionSurfaceIntent,\n  surfaces: FunctionSurfaceMap,\n  rationale: string\n): Record<string, LucernOperationManifestEntry> {\n  return Object.fromEntries(\n    names.map((name) => [\n      name,\n      {\n        name,\n        surfaceClass,\n        surfaceIntent,\n        surfaces,\n        rationale,\n      },\n    ])\n  );\n}\n\nexport const MCP_CORE_OPERATION_NAMES = [\n  \"compile_context\",\n  \"identity_whoami\",\n  \"resolve_interactive_principal\",\n  \"check_permission\",\n  \"filter_by_permission\",\n  \"create_belief\",\n  \"get_belief\",\n  \"list_beliefs\",\n  \"refine_belief\",\n  \"modulate_confidence\",\n  \"fork_belief\",\n  \"archive_belief\",\n  \"search_beliefs\",\n  \"bisect_confidence\",\n  \"create_evidence\",\n  \"get_evidence\",\n  \"list_evidence\",\n  \"search_evidence\",\n  \"link_evidence_to_belief\",\n  \"link_evidence_to_question\",\n  \"create_question\",\n  \"get_question\",\n  \"list_questions\",\n  \"refine_question\",\n  \"update_question_status\",\n  \"archive_question\",\n  \"create_answer\",\n  \"get_answer\",\n  \"find_missing_questions\",\n  \"get_high_priority_questions\",\n  \"get_falsification_questions\",\n  \"create_epistemic_node\",\n  \"get_epistemic_node\",\n  \"list_epistemic_nodes\",\n  \"update_epistemic_node\",\n  \"archive_epistemic_node\",\n  \"verify_epistemic_node\",\n  \"supersede_epistemic_node\",\n  \"batch_create_epistemic_nodes\",\n  \"create_topic\",\n  \"get_topic\",\n  \"list_topics\",\n  \"update_topic\",\n  \"get_topic_tree\",\n  \"materialize_topic_graph\",\n  \"get_topic_graph_spine\",\n] as const;\n\nexport const MCP_ANALYSIS_PLATFORM_OPERATION_NAMES = [\n  \"create_edge\",\n  \"update_edge\",\n  \"remove_edge\",\n  \"remove_edges_between\",\n  \"batch_create_edges\",\n  \"query_lineage\",\n  \"traverse_graph\",\n  \"get_graph_neighborhood\",\n  \"get_graph_structure_analysis\",\n  \"list_graph_intelligence_queries\",\n  \"run_graph_intelligence_query\",\n  \"find_contradictions\",\n  \"flag_contradiction\",\n  \"detect_confirmation_bias\",\n  \"get_topic_coverage\",\n  \"get_graph_gaps\",\n] as const;\n\nexport const MCP_ANALYSIS_TENANT_OPERATION_NAMES = [\n  \"analyze_topic_density\",\n  \"discover_entity_connections\",\n  \"trace_entity_impact\",\n] as const;\n\nexport const MCP_WORKFLOW_PLATFORM_OPERATION_NAMES = [\n  \"list_lenses\",\n  \"apply_lens_to_topic\",\n  \"remove_lens_from_topic\",\n  \"get_ontology\",\n  \"list_ontologies\",\n  \"apply_ontology\",\n  \"match_entity_type\",\n  \"resolve_effective_ontology\",\n  \"add_worktree\",\n  \"activate_worktree\",\n  \"list_worktrees\",\n  \"list_all_worktrees\",\n  \"list_campaigns\",\n  \"update_worktree_targets\",\n  \"update_worktree_metadata\",\n  \"create_task\",\n  \"list_tasks\",\n  \"update_task\",\n  \"complete_task\",\n] as const;\n\nexport const MCP_WORKFLOW_TENANT_OPERATION_NAMES = [\n  \"resolve_effective_ontology\",\n  \"get_observation_context\",\n  \"ingest_observation\",\n  \"merge\",\n] as const;\n\nexport const MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES = [\n  \"create_lens\",\n  \"create_ontology\",\n  \"update_ontology\",\n  \"archive_ontology\",\n  \"create_ontology_version\",\n] as const;\n\nexport const MCP_GOVERNANCE_TENANT_OPERATION_NAMES = [\n  \"create_epistemic_contract\",\n  \"evaluate_contract\",\n  \"get_contract_status\",\n  \"publish_ontology_version\",\n  \"deprecate_ontology_version\",\n  \"manage_write_policy\",\n] as const;\n\nexport const MCP_AUTOMATION_OPERATION_NAMES = [\n  \"apply_auto_branching\",\n  \"trigger_belief_review\",\n] as const;\n\nexport const DUPLICATE_OPERATION_NAMES = [\n  \"link_evidence\",\n] as const;\n\nexport const PLATFORM_PUBLIC_OPERATION_NAMES = [\n  ...MCP_CORE_OPERATION_NAMES,\n  ...MCP_ANALYSIS_PLATFORM_OPERATION_NAMES,\n  ...MCP_WORKFLOW_PLATFORM_OPERATION_NAMES,\n  ...MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES,\n  ...DUPLICATE_OPERATION_NAMES,\n] as const;\n\nexport const TENANT_PUBLIC_OPERATION_NAMES = [\n  ...MCP_ANALYSIS_TENANT_OPERATION_NAMES,\n  ...MCP_WORKFLOW_TENANT_OPERATION_NAMES,\n  ...MCP_GOVERNANCE_TENANT_OPERATION_NAMES,\n  ...MCP_AUTOMATION_OPERATION_NAMES,\n] as const;\n\nexport const PLATFORM_INTERNAL_OPERATION_NAMES = [\n  \"register_session\",\n  \"heartbeat_session\",\n  \"end_session\",\n  \"list_active_sessions\",\n  \"send_agent_message\",\n  \"broadcast_message\",\n  \"get_agent_inbox\",\n  \"claim_files\",\n  \"generate_session_handoff\",\n  \"record_scope_learning\",\n  \"pipeline_snapshot\",\n  \"seed_belief_lattice\",\n  \"get_lattice_coverage\",\n  \"get_code_context\",\n  \"get_change_history\",\n  \"get_failure_log\",\n  \"record_attempt\",\n  \"begin_build_session\",\n  \"push\",\n  \"open_pull_request\",\n  \"record_judgment\",\n  \"get_audit_trail\",\n] as const;\n\nexport const LEGACY_COMPAT_OPERATION_NAMES = [\n  \"discover\",\n  \"add_evidence\",\n  \"answer_question\",\n  \"get_confidence_history\",\n] as const;\n\nexport const SDK_ONLY_OPERATION_NAMES = [\n  \"start_worktree\",\n  \"update_worktree_phase\",\n  \"advance_worktree_phase\",\n  \"add_note_to_worktree\",\n  \"link_document_to_worktree\",\n  \"link_evidence_to_worktree\",\n  \"link_question_to_worktree\",\n  \"link_belief_to_worktree\",\n  \"create_synthesized_belief\",\n  \"complete_hypothesis_formation\",\n  \"complete_evidence_review\",\n  \"refine_worktree_belief\",\n  \"trace_provenance\",\n  \"get_belief_relationships\",\n  \"get_belief_support_chain\",\n  \"explore_connections\",\n  \"get_deep_lineage\",\n  \"graph_aware_search\",\n  \"get_collection_conviction\",\n  \"get_conviction_trend\",\n  \"analyze_belief_criticality\",\n  \"analyze_belief_cluster_candidates\",\n  \"create_belief_conditional\",\n  \"get_necessary_evidence\",\n  \"analyze_reasoning_depth\",\n  \"get_evidence_by_methodology\",\n  \"create_evidence_task\",\n  \"get_task_counts\",\n  \"add_research_action\",\n  \"get_predictions\",\n  \"get_surprise_detection\",\n  \"get_challenged_beliefs\",\n  \"get_causal_chains\",\n  \"get_non_consensus_beliefs\",\n  \"get_beliefs_by_epistemic_status\",\n  \"detect_anchoring_bias\",\n  \"detect_source_concentration\",\n  \"find_soft_contradictions\",\n  \"find_semantic_bridges\",\n  \"find_semantic_orphans\",\n] as const;\n\nexport const MCP_ONLY_INTERNAL_OPERATION_NAMES = [\n  \"evaluate_engineering_contract\",\n  \"evaluate_research_contract\",\n] as const;\n\nexport const FORBIDDEN_APPLICATION_OPERATION_NAMES = [\n  \"execute_deep_research\",\n  \"search_sources\",\n  \"search_resources\",\n  \"get_privileged_evidence\",\n  \"get_privileged_signals\",\n  \"get_thesis_artifacts\",\n] as const;\n\nexport const LUCERN_OPERATION_MANIFEST = {\n  ...entries(\n    MCP_CORE_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_core\",\n    publicEverywhere,\n    \"Default conversational Lucern MCP primitive for reading, writing, and shaping the reasoning graph.\"\n  ),\n  ...entries(\n    MCP_ANALYSIS_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"High-signal graph analysis operation that belongs in chat/MCP because users naturally ask for gaps, contradictions, lineage, and coverage.\"\n  ),\n  ...entries(\n    MCP_ANALYSIS_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"Tenant-scoped analysis operation that remains MCP-visible because agents can answer graph-quality and impact questions from chat.\"\n  ),\n  ...entries(\n    MCP_WORKFLOW_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_workflow\",\n    publicEverywhere,\n    \"Workflow operation expected by coding agents and human MCP users managing Lucern worktrees, tasks, lenses, and observations.\"\n  ),\n  ...entries(\n    MCP_WORKFLOW_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_workflow\",\n    publicEverywhere,\n    \"Tenant-scoped workflow operation expected by coding agents and human MCP users managing observations and worktree lifecycle.\"\n  ),\n  ...entries(\n    MCP_AUTOMATION_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_analysis\",\n    publicEverywhere,\n    \"Tenant-scoped automation that remains MCP-visible because agents can explicitly request review or branching assistance.\"\n  ),\n  ...entries(\n    MCP_GOVERNANCE_PLATFORM_OPERATION_NAMES,\n    \"platform_public\",\n    \"mcp_governance\",\n    publicWithInternalMcp,\n    \"Governance/admin operation. SDK, REST, and CLI remain public, but MCP is internal by default to keep chat surfaces focused.\"\n  ),\n  ...entries(\n    MCP_GOVERNANCE_TENANT_OPERATION_NAMES,\n    \"tenant_public\",\n    \"mcp_governance\",\n    publicWithInternalMcp,\n    \"Governance/admin operation. SDK, REST, and CLI remain public, but MCP is internal by default to keep chat surfaces focused.\"\n  ),\n  ...entries(\n    DUPLICATE_OPERATION_NAMES,\n    \"platform_public\",\n    \"compatibility\",\n    publicWithoutMcp,\n    \"Duplicate compatibility operation kept for SDK/REST callers, removed from MCP/CLI discovery in favor of the canonical specific tool.\"\n  ),\n  ...entries(\n    PLATFORM_INTERNAL_OPERATION_NAMES,\n    \"platform_internal\",\n    \"system\",\n    internalSystem,\n    \"Lucern system/background operation. Available to platform code paths, hidden from public MCP discovery.\"\n  ),\n  ...entries(\n    LEGACY_COMPAT_OPERATION_NAMES,\n    \"legacy_compat\",\n    \"compatibility\",\n    publicWithoutMcp,\n    \"Temporary compatibility operation. Must name a canonical replacement before removal.\"\n  ),\n  ...entries(\n    SDK_ONLY_OPERATION_NAMES,\n    \"tenant_public\",\n    \"sdk_granular\",\n    sdkOnlyPublic,\n    \"Granular Lucern SDK operation. Not an MCP, REST, or CLI tool until backed by the generated function pipe.\"\n  ),\n  ...entries(\n    MCP_ONLY_INTERNAL_OPERATION_NAMES,\n    \"platform_internal\",\n    \"system\",\n    mcpOnlyInternal,\n    \"Lucern MCP-only platform operation for local agent/bootstrap or verification workflows. Hidden from public discovery.\"\n  ),\n} as const satisfies Record<string, LucernOperationManifestEntry>;\n\nexport type LucernOperationName = keyof typeof LUCERN_OPERATION_MANIFEST;\n\nexport function surfaceEnabled(exposure: SurfaceExposure): boolean {\n  return exposure !== \"none\";\n}\n\nexport function surfaceIntentGateViolations(\n  entry: LucernOperationManifestEntry\n): string[] {\n  const violations: string[] = [];\n  if (entry.surfaceIntent === \"system\" && entry.surfaces.mcp === \"public\") {\n    violations.push(\"system operations cannot be public MCP tools\");\n  }\n  if (\n    entry.surfaceIntent === \"compatibility\" &&\n    entry.surfaces.mcp !== \"none\"\n  ) {\n    violations.push(\"compatibility operations must not be MCP tools\");\n  }\n  if (entry.surfaceIntent === \"sdk_granular\" && entry.surfaces.mcp !== \"none\") {\n    violations.push(\"SDK-granular operations must not be MCP tools\");\n  }\n  if (\n    entry.surfaceIntent === \"mcp_governance\" &&\n    entry.surfaces.mcp === \"public\"\n  ) {\n    violations.push(\"governance operations must be internal or absent from MCP\");\n  }\n  return violations;\n}\n"]}

package/dist/function-registry/nodes.d.ts

@@ -115,7 +115,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -155,7 +155,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -195,7 +195,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -235,7 +235,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -275,7 +275,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -315,7 +315,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -355,7 +355,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;
@@ -395,7 +395,7 @@ declare const nodesContracts: readonly [{
     };
     auth: {
         scopes: string[];
-        allowedPrincipalTypes: ("user" | "service" | "agent")[];
+        allowedPrincipalTypes: ("user" | "service" | "agent" | "group" | "external_viewer")[];
     };
     convex: FunctionConvexTarget | undefined;
     gateway: FunctionGatewayTarget | undefined;

package/dist/function-registry/nodes.js

@@ -2328,7 +2328,7 @@ var IDENTITY_WHOAMI = {
     description: "Canonical identity summary for the current session",
     fields: {
       principalId: "string \u2014 canonical federated principal identifier",
-      principalType: "string \u2014 human, service, or agent",
+      principalType: "string \u2014 human, service, agent, group, or external_viewer",
       tenantId: "string | undefined \u2014 resolved tenant scope",
       workspaceId: "string | undefined \u2014 resolved workspace scope",
       scopes: "string[] | undefined \u2014 granted scopes for this session",
@@ -2339,6 +2339,49 @@ var IDENTITY_WHOAMI = {
   ontologyPrimitive: "identity",
   tier: "workhorse"
 };
+var RESOLVE_INTERACTIVE_PRINCIPAL = {
+  name: "resolve_interactive_principal",
+  description: "Read the Permit-backed Lucern principal context for an authenticated Clerk user. Like `git config --get user.email` plus the repository ACL \u2014 resolves the identity alias into the canonical authorization subject.",
+  parameters: {
+    clerkId: {
+      type: "string",
+      description: "Authenticated Clerk subject (`sub`). Clerk proves identity only; it is not the authorization record."
+    },
+    tenantId: {
+      type: "string",
+      description: "Optional tenant scope. Omit only when the Clerk alias is globally unambiguous."
+    },
+    workspaceId: {
+      type: "string",
+      description: "Optional workspace scope. Required when the principal has access to multiple workspaces and no default can be inferred."
+    },
+    providerProjectId: {
+      type: "string",
+      description: "Optional Clerk project or provider instance id for tenants with multiple identity providers."
+    }
+  },
+  required: ["clerkId"],
+  response: {
+    description: "Permit-backed Lucern principal context for tenant SDK bootstrap",
+    fields: {
+      principalId: "string \u2014 canonical Lucern principal identifier",
+      principalType: "string \u2014 human, service, agent, group, or external_viewer",
+      clerkId: "string \u2014 authenticated Clerk subject alias",
+      tenantId: "string \u2014 resolved tenant scope",
+      workspaceId: "string | null \u2014 resolved workspace scope",
+      roles: "string[] \u2014 effective Permit roles",
+      scopes: "string[] \u2014 effective scopes derived from Permit/control-plane projection",
+      groupIds: "string[] \u2014 active Permit group memberships",
+      principalStatus: "string \u2014 active, invited, suspended, disabled, revoked, or missing",
+      tenantStatus: "string \u2014 projected tenant resource status",
+      workspaceStatus: "string \u2014 projected workspace resource status",
+      permit: "object \u2014 Permit subject, tenant, and optional workspace tuple"
+    }
+  },
+  ownerModule: "control-plane",
+  ontologyPrimitive: "identity",
+  tier: "workhorse"
+};
 var COMPILE_CONTEXT = {
   name: "compile_context",
   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.",
@@ -4241,6 +4284,7 @@ var MCP_TOOL_CONTRACTS = {
   update_worktree_targets: UPDATE_WORKTREE_TARGETS,
   update_worktree_metadata: UPDATE_WORKTREE_METADATA,
   identity_whoami: IDENTITY_WHOAMI,
+  resolve_interactive_principal: RESOLVE_INTERACTIVE_PRINCIPAL,
   compile_context: COMPILE_CONTEXT,
   record_scope_learning: RECORD_SCOPE_LEARNING,
   pipeline_snapshot: PIPELINE_SNAPSHOT,
@@ -4358,6 +4402,7 @@ function entries(names, surfaceClass, surfaceIntent, surfaces, rationale) {
 var MCP_CORE_OPERATION_NAMES = [
   "compile_context",
   "identity_whoami",
+  "resolve_interactive_principal",
   "check_permission",
   "filter_by_permission",
   "create_belief",
@@ -4915,7 +4960,13 @@ function surfaceContract(args) {
       scopes: args.scopes ?? [
         args.kind === "query" ? `${args.domain}.read` : `${args.domain}.write`
       ],
-      allowedPrincipalTypes: ["user", "service", "agent"]
+      allowedPrincipalTypes: [
+        "user",
+        "service",
+        "agent",
+        "group",
+        "external_viewer"
+      ]
     },
     convex: args.convex,
     gateway: args.gateway,