@lucern/mcp 0.3.0-alpha.16 → 0.3.0-alpha.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/runtime.js CHANGED
@@ -1015,7 +1015,7 @@ defineTable({
1015
1015
  shape: z.object({
1016
1016
  "tenantId": idOf("tenants").optional(),
1017
1017
  "apiKeyId": idOf("apiKeys").optional(),
1018
- "action": z.enum(["key_created", "key_revoked", "key_expired", "key_used", "tenant_secret_created", "tenant_secret_rotated", "tenant_secret_revoked", "tenant_slot_binding_upserted", "tenant_slot_binding_revoked", "proxy_token_minted", "proxy_token_lease_issued", "proxy_token_lease_renewed", "proxy_token_lease_revoked", "proxy_request_recorded", "tenant_created", "tenant_updated", "tenant_suspended", "tenant_archived", "tenant_reactivated", "principal_created", "principal_updated", "principal_suspended", "principal_identity_alias_upserted", "principal_identity_alias_revoked", "membership_created", "membership_updated", "membership_revoked", "group_created", "group_updated", "group_deleted", "group_member_added", "group_member_removed", "workspace_created", "workspace_updated", "workspace_archived", "workspace_deployment_set", "workspace_deployment_removed", "deployment_host_registered", "deployment_host_revoked", "service_key_created", "service_key_rotated", "service_key_revoked", "service_key_used", "service_key_auth_failed", "session_created", "session_validated", "session_revoked", "session_cascade_revoked", "session_expired", "sandbox_created", "sandbox_secret_injected", "sandbox_execution_started", "sandbox_execution_completed", "sandbox_limit_violated", "policy_created", "policy_updated", "policy_enforced", "policy_archived", "permit_sync_enqueued", "permit_sync_succeeded", "permit_sync_failed", "permit_sync_skipped", "agent_registered", "agent_updated", "tool_registered", "tool_updated", "pack_entitled", "pack_installed", "pack_enabled", "pack_disabled", "pack_entitlement_revoked", "pack_upgraded", "pack_upgrade_committed", "pack_upgrade_rolled_back", "pack_group_assigned", "pack_group_unassigned", "methodology_pack_created", "methodology_pack_updated", "methodology_pack_assigned", "methodology_pack_removed", "pack_assigned_to_group", "pack_revoked_from_group", "pack_ontology_materialized", "pack_ontology_topic_bound", "cutover_flag_set", "cutover_flag_cleared"]),
1018
+ "action": z.enum(["key_created", "key_revoked", "key_expired", "key_used", "tenant_secret_created", "tenant_secret_rotated", "tenant_secret_revoked", "tenant_slot_binding_upserted", "tenant_slot_binding_revoked", "proxy_token_minted", "proxy_token_lease_issued", "proxy_token_lease_renewed", "proxy_token_lease_revoked", "proxy_request_recorded", "tenant_created", "tenant_updated", "tenant_suspended", "tenant_archived", "tenant_reactivated", "tenant_clerk_organization_linked", "principal_created", "principal_updated", "principal_suspended", "principal_identity_alias_upserted", "principal_identity_alias_revoked", "membership_created", "membership_updated", "membership_revoked", "group_created", "group_updated", "group_deleted", "group_member_added", "group_member_removed", "workspace_created", "workspace_updated", "workspace_archived", "workspace_deployment_set", "workspace_deployment_removed", "deployment_host_registered", "deployment_host_revoked", "service_key_created", "service_key_rotated", "service_key_revoked", "service_key_used", "service_key_auth_failed", "session_created", "session_validated", "session_revoked", "session_cascade_revoked", "session_expired", "sandbox_created", "sandbox_secret_injected", "sandbox_execution_started", "sandbox_execution_completed", "sandbox_limit_violated", "policy_created", "policy_updated", "policy_enforced", "policy_archived", "permit_sync_enqueued", "permit_sync_succeeded", "permit_sync_failed", "permit_sync_skipped", "agent_registered", "agent_updated", "tool_registered", "tool_updated", "pack_entitled", "pack_installed", "pack_enabled", "pack_disabled", "pack_entitlement_revoked", "pack_upgraded", "pack_upgrade_committed", "pack_upgrade_rolled_back", "pack_group_assigned", "pack_group_unassigned", "methodology_pack_created", "methodology_pack_updated", "methodology_pack_assigned", "methodology_pack_removed", "pack_assigned_to_group", "pack_revoked_from_group", "pack_ontology_materialized", "pack_ontology_topic_bound", "cutover_flag_set", "cutover_flag_cleared"]),
1019
1019
  "actorClerkId": z.string(),
1020
1020
  "details": z.any().optional(),
1021
1021
  "createdAt": z.number()
@@ -9722,7 +9722,7 @@ var IDENTITY_WHOAMI = {
9722
9722
  response: {
9723
9723
  description: "Canonical identity summary for the current session",
9724
9724
  fields: {
9725
- principalId: "string \u2014 canonical federated principal identifier",
9725
+ principalId: "string \u2014 canonical principal identifier; for humans this is the Clerk user_... ID",
9726
9726
  principalType: "string \u2014 human, service, agent, group, or external_viewer",
9727
9727
  tenantId: "string | undefined \u2014 resolved tenant scope",
9728
9728
  workspaceId: "string | undefined \u2014 resolved workspace scope",
@@ -9736,7 +9736,7 @@ var IDENTITY_WHOAMI = {
9736
9736
  };
9737
9737
  var RESOLVE_INTERACTIVE_PRINCIPAL = {
9738
9738
  name: "resolve_interactive_principal",
9739
- 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.",
9739
+ 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 Clerk subject into tenant/workspace authorization context.",
9740
9740
  parameters: {
9741
9741
  clerkId: {
9742
9742
  type: "string",
@@ -9759,7 +9759,7 @@ var RESOLVE_INTERACTIVE_PRINCIPAL = {
9759
9759
  response: {
9760
9760
  description: "Permit-backed Lucern principal context for tenant SDK bootstrap",
9761
9761
  fields: {
9762
- principalId: "string \u2014 canonical Lucern principal identifier",
9762
+ principalId: "string \u2014 canonical Clerk user_... ID for human sessions",
9763
9763
  principalType: "string \u2014 human, service, agent, group, or external_viewer",
9764
9764
  clerkId: "string \u2014 authenticated Clerk subject alias",
9765
9765
  tenantId: "string \u2014 resolved tenant scope",
@@ -10587,7 +10587,7 @@ var MANAGE_WRITE_POLICY = {
10587
10587
  },
10588
10588
  role: {
10589
10589
  type: "string",
10590
- description: "Role to set policy for (required for 'set'). E.g. 'agent:internal', 'user:analyst'."
10590
+ description: "Role to set policy for (required for 'set'). E.g. 'agent:internal' or a Permit role key such as 'workspace_admin'."
10591
10591
  },
10592
10592
  permission: {
10593
10593
  type: "string",
@@ -14368,6 +14368,19 @@ var worktreeEvidenceSignalInputSchema = z.object({
14368
14368
  progress: z.string().optional().describe("Collection progress note for the signal."),
14369
14369
  notes: z.string().optional().describe("Additional evidence collection notes.")
14370
14370
  }).passthrough().describe("Evidence signal embedded in the worktree plan.");
14371
+ var worktreeDocCompanionTargetSchema = z.object({
14372
+ docPath: z.string().describe(
14373
+ "Repo-relative path to a documentation file the worktree promises to update."
14374
+ ),
14375
+ sectionAnchor: z.string().optional().describe(
14376
+ "Markdown heading anchor (e.g. '## Function-surface manifest') that scopes the promised update."
14377
+ ),
14378
+ reason: z.string().describe(
14379
+ "Why this doc section must be updated for the worktree to be complete."
14380
+ )
14381
+ }).passthrough().describe(
14382
+ "Intent-driven docs companion target. pr-gate-reviewer verifies that the PR actually touches each declared (docPath, sectionAnchor). Distinct from the touch-driven docs-loop. See docs/development/docs-sync-discipline.md Lock 3."
14383
+ );
14371
14384
  var worktreeDecisionGateInputSchema = z.object({
14372
14385
  goCriteria: z.array(z.string()).describe("Criteria that must hold for the worktree to proceed."),
14373
14386
  noGoSignals: z.array(z.string()).describe("Signals that stop or redirect the worktree."),
@@ -14400,6 +14413,9 @@ var addWorktreeArgs = z.object({
14400
14413
  keyQuestions: z.array(worktreeKeyQuestionInputSchema).optional().describe("Inline key questions captured as part of the worktree plan."),
14401
14414
  evidenceSignals: z.array(worktreeEvidenceSignalInputSchema).optional().describe("Evidence signals the worktree needs to collect or validate."),
14402
14415
  decisionGate: worktreeDecisionGateInputSchema.optional(),
14416
+ docCompanionTargets: z.array(worktreeDocCompanionTargetSchema).optional().describe(
14417
+ "Doc sections the worktree promises to update at PR time. Enforced by pr-gate-reviewer (Lock 3)."
14418
+ ),
14403
14419
  goCriteria: z.array(z.string()).optional().describe("Shorthand go criteria used to build decisionGate."),
14404
14420
  noGoSignals: z.array(z.string()).optional().describe("Shorthand no-go signals used to build decisionGate."),
14405
14421
  proofArtifacts: z.array(z.unknown()).optional().describe("Expected proof artifacts required to close the worktree."),
@@ -19191,7 +19207,7 @@ async function resolveBeliefTopicId(ctx, beliefId) {
19191
19207
  if (!normalizedBeliefId) {
19192
19208
  return void 0;
19193
19209
  }
19194
- return fetchRecordTopicId(ctx, api.epistemicBeliefs.getById, {
19210
+ return fetchRecordTopicId(ctx, api.beliefs.getById, {
19195
19211
  beliefId: normalizedBeliefId,
19196
19212
  nodeId: normalizedBeliefId
19197
19213
  });