@lucern/contracts 0.3.0-alpha.2 → 0.3.0-alpha.4

package/dist/tenant-client.contract.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Tenant client contract
+ *
+ * Defines the generic boundary for any customer-owned product that consumes
+ * Lucern through the SDK, hosted API, or MCP server. Tenant clients may run
+ * their own UI, auth provider, deployment, and data plane, but reasoning
+ * operations must enter through the published packages below.
+ */
+declare const TENANT_CLIENT_CONTRACT_VERSION: "2026-04-27";
+declare const TENANT_CLIENT_AUTH_MODES: readonly ["interactive_user", "service_principal", "tenant_api_key", "session_token"];
+type TenantClientAuthMode = (typeof TENANT_CLIENT_AUTH_MODES)[number];
+declare const TENANT_CLIENT_PRINCIPAL_TYPES: readonly ["human", "service", "agent"];
+type TenantClientPrincipalType = (typeof TENANT_CLIENT_PRINCIPAL_TYPES)[number];
+declare const TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+type TenantClientRequiredContextField = (typeof TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS)[number];
+declare const TENANT_CLIENT_OPTIONAL_CONTEXT_FIELDS: readonly ["principalType", "roles", "sessionId", "delegationChain"];
+type TenantClientOptionalContextField = (typeof TENANT_CLIENT_OPTIONAL_CONTEXT_FIELDS)[number];
+declare const TENANT_CLIENT_INSTALL_TOKEN_ENV: "INSTALL_LUCERN_NPM";
+declare const TENANT_CLIENT_INSTALL_TOKEN_INFISICAL_PATH: "tenants/shared";
+declare const TENANT_CLIENT_FORBIDDEN_INSTALL_TOKEN_INFISICAL_PATHS: readonly ["/platform/publish"];
+declare const TENANT_CLIENT_FORBIDDEN_SECRET_ENV: readonly ["NPM_TOKEN"];
+type TenantClientForbiddenInstallTokenInfisicalPath = (typeof TENANT_CLIENT_FORBIDDEN_INSTALL_TOKEN_INFISICAL_PATHS)[number];
+type TenantClientForbiddenSecretEnv = (typeof TENANT_CLIENT_FORBIDDEN_SECRET_ENV)[number];
+declare const TENANT_CLIENT_INSTALLABLE_PACKAGES: readonly [{
+    readonly packageName: "@lucern/access-control";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/agent";
+    readonly role: "platform_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/auth";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/cli";
+    readonly role: "developer_tool";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/client-core";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/confidence";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/config";
+    readonly role: "configuration";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/contracts";
+    readonly role: "contract_entrypoint";
+    readonly directTenantImport: true;
+}, {
+    readonly packageName: "@lucern/control-plane";
+    readonly role: "platform_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/developer-kit";
+    readonly role: "developer_tool";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/events";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/graph-primitives";
+    readonly role: "sdk_dependency";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/identity";
+    readonly role: "component_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/mcp";
+    readonly role: "runtime_entrypoint";
+    readonly directTenantImport: true;
+}, {
+    readonly packageName: "@lucern/pack-host";
+    readonly role: "platform_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/pack-installer";
+    readonly role: "developer_tool";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/proof-compiler";
+    readonly role: "developer_tool";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/react";
+    readonly role: "runtime_entrypoint";
+    readonly directTenantImport: true;
+}, {
+    readonly packageName: "@lucern/reasoning-kernel";
+    readonly role: "component_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/sdk";
+    readonly role: "runtime_entrypoint";
+    readonly directTenantImport: true;
+}, {
+    readonly packageName: "@lucern/server-core";
+    readonly role: "platform_runtime";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/testing";
+    readonly role: "test_support";
+    readonly directTenantImport: false;
+}, {
+    readonly packageName: "@lucern/types";
+    readonly role: "contract_entrypoint";
+    readonly directTenantImport: true;
+}];
+type TenantClientInstallablePackage = (typeof TENANT_CLIENT_INSTALLABLE_PACKAGES)[number];
+type TenantClientPackageRole = TenantClientInstallablePackage["role"];
+type TenantClientInstallablePackageName = TenantClientInstallablePackage["packageName"];
+/**
+ * Direct imports tenant-owned product code may use. This is intentionally
+ * smaller than TENANT_CLIENT_INSTALLABLE_PACKAGES: several publishable packages
+ * are installed as SDK dependencies, tooling, or platform runtimes but should
+ * not become the application integration surface.
+ */
+declare const TENANT_CLIENT_PUBLIC_IMPORTS: readonly [{
+    readonly packageName: "@lucern/sdk";
+    readonly surface: "runtime";
+    readonly subpaths: "published_exports";
+    readonly description: "TypeScript SDK runtime and generated operation namespaces.";
+}, {
+    readonly packageName: "@lucern/react";
+    readonly surface: "runtime";
+    readonly subpaths: "published_exports";
+    readonly description: "React bindings for tenant-owned UI applications.";
+}, {
+    readonly packageName: "@lucern/mcp";
+    readonly surface: "runtime";
+    readonly subpaths: "published_exports";
+    readonly description: "MCP client/server entry points and hosted route helpers.";
+}, {
+    readonly packageName: "@lucern/contracts";
+    readonly surface: "contract";
+    readonly subpaths: "published_exports";
+    readonly description: "Published type and manifest contracts.";
+}, {
+    readonly packageName: "@lucern/types";
+    readonly surface: "contract";
+    readonly subpaths: "published_exports";
+    readonly description: "Published type-only helpers for tenant integration code.";
+}];
+type TenantClientPublicImport = (typeof TENANT_CLIENT_PUBLIC_IMPORTS)[number];
+type TenantClientPublicPackage = TenantClientPublicImport["packageName"];
+type TenantClientPublicSurface = TenantClientPublicImport["surface"];
+declare const TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS: readonly [{
+    readonly packageName: "@lucern/identity";
+    readonly importPath: "@lucern/identity/convex.config";
+    readonly surface: "component_config";
+    readonly description: "Convex component binding config for tenant deployments that install Lucern identity.";
+}, {
+    readonly packageName: "@lucern/reasoning-kernel";
+    readonly importPath: "@lucern/reasoning-kernel/convex.config";
+    readonly surface: "component_config";
+    readonly description: "Convex component binding config for tenant deployments that install the Lucern reasoning kernel.";
+}, {
+    readonly packageName: "@lucern/reasoning-kernel";
+    readonly importPath: "@lucern/reasoning-kernel/runtime.config";
+    readonly surface: "component_config";
+    readonly description: "Runtime config alias for tenant deployments that install the Lucern reasoning kernel.";
+}];
+type TenantClientComponentConfigImport = (typeof TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS)[number];
+type TenantClientAllowedImport = TenantClientPublicImport | TenantClientComponentConfigImport;
+declare function findTenantClientInstallablePackage(packageName: string): TenantClientInstallablePackage | undefined;
+declare function isTenantClientInstallablePackage(packageName: string): boolean;
+declare const TENANT_CLIENT_REQUIRED_SDK_NAMESPACES: readonly ["bootstrap", "context", "beliefs", "evidence", "questions", "graph", "worktrees", "topics", "edges", "contradictions", "contracts", "graphAnalysis", "graphRecommendations", "orgGraphSearch", "embeddings", "ontologyLinks", "graphStateClassifier", "tools", "identity", "modelRuntime", "events", "jobs", "telemetry"];
+type TenantClientRequiredSdkNamespace = (typeof TENANT_CLIENT_REQUIRED_SDK_NAMESPACES)[number];
+declare const TENANT_CLIENT_CAPABILITIES: readonly [{
+    readonly id: "identity.bootstrap_session";
+    readonly description: "Start a scoped Lucern session for a tenant principal.";
+    readonly surfaces: readonly ["@lucern/sdk", "@lucern/mcp"];
+    readonly requiredContextFields: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+}, {
+    readonly id: "reasoning.context.compile";
+    readonly description: "Compile tenant and workspace scoped reasoning context.";
+    readonly surfaces: readonly ["@lucern/sdk", "@lucern/react", "@lucern/mcp"];
+    readonly requiredContextFields: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+}, {
+    readonly id: "reasoning.graph.read";
+    readonly description: "Read beliefs, evidence, questions, topics, and lineage.";
+    readonly surfaces: readonly ["@lucern/sdk", "@lucern/react", "@lucern/mcp"];
+    readonly requiredContextFields: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+}, {
+    readonly id: "reasoning.graph.write";
+    readonly description: "Create and update graph objects through authorized APIs.";
+    readonly surfaces: readonly ["@lucern/sdk", "@lucern/mcp"];
+    readonly requiredContextFields: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+}, {
+    readonly id: "workflow.worktree_lifecycle";
+    readonly description: "Create, review, merge, and close scoped worktrees.";
+    readonly surfaces: readonly ["@lucern/sdk", "@lucern/react", "@lucern/mcp"];
+    readonly requiredContextFields: readonly ["tenantId", "workspaceId", "principalId", "authMode", "scopes"];
+}];
+type TenantClientCapability = (typeof TENANT_CLIENT_CAPABILITIES)[number];
+type TenantClientCapabilityId = TenantClientCapability["id"];
+declare const TENANT_CLIENT_ISOLATION_RULES: readonly [{
+    readonly id: "tenant_workspace_scope_required";
+    readonly description: "Runtime operations must resolve both tenantId and workspaceId before reaching Lucern reasoning state.";
+}, {
+    readonly id: "principal_audit_required";
+    readonly description: "Runtime operations must carry principalId, authMode, and scopes for audit attribution.";
+}, {
+    readonly id: "no_private_lucern_imports";
+    readonly description: "Tenant code must not import Lucern source, Convex internals, generated adapters, or unpublished package internals.";
+}];
+type TenantClientIsolationRule = (typeof TENANT_CLIENT_ISOLATION_RULES)[number];
+declare const TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS: readonly [{
+    readonly id: "deep_src_import";
+    readonly pattern: "^@lucern/[^/]+/src(?:/|$)";
+    readonly description: "Published packages must not be bypassed through src paths.";
+}, {
+    readonly id: "deep_dist_import";
+    readonly pattern: "^@lucern/[^/]+/dist(?:/|$)";
+    readonly description: "Published package exports must be used instead of dist file paths.";
+}, {
+    readonly id: "generated_adapter_import";
+    readonly pattern: "^@lucern/[^/]+/(?:adapters/)?_generated(?:/|$)";
+    readonly description: "Generated Lucern adapters are internal deployment artifacts.";
+}, {
+    readonly id: "private_runtime_import";
+    readonly pattern: "^@lucern/[^/]+/(?:internal|private)(?:/|$)";
+    readonly description: "Internal and private package subpaths are not public SDK API.";
+}, {
+    readonly id: "workspace_source_import";
+    readonly pattern: "^(?:packages|modules|services|lucern|apps)/(?:.+/)?src(?:/|$)";
+    readonly description: "Tenant clients must not import source files from the Lucern monorepo.";
+}, {
+    readonly id: "root_alias_lucern_import";
+    readonly pattern: "^@/(?:lucern|packages|modules|services|apps)(?:/|$)";
+    readonly description: "Tenant clients must not depend on Lucern repo-local path aliases.";
+}, {
+    readonly id: "relative_lucern_source_import";
+    readonly pattern: "^\\.\\.?/(?:.+/)?(?:packages|modules|services|lucern|apps)(?:/|$)";
+    readonly description: "Tenant clients must not reach back into Lucern source through relative paths.";
+}, {
+    readonly id: "monorepo_path_import";
+    readonly pattern: "lucern-repo";
+    readonly description: "Absolute imports that name the Lucern repository are not portable tenant code.";
+}];
+type TenantClientForbiddenImportPattern = (typeof TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS)[number];
+type TenantClientForbiddenImportPatternId = TenantClientForbiddenImportPattern["id"];
+type TenantClientImportDecision = "public" | "forbidden" | "local" | "external";
+type TenantClientImportClassification = {
+    importPath: string;
+    decision: TenantClientImportDecision;
+    publicImport?: TenantClientAllowedImport;
+    pattern?: TenantClientForbiddenImportPattern;
+    reason: string;
+};
+declare function classifyTenantClientImport(importPath: string): TenantClientImportClassification;
+declare function isTenantClientPublicImport(importPath: string): boolean;
+declare function isTenantClientComponentConfigImport(importPath: string): boolean;
+declare function isTenantClientAllowedImport(importPath: string): boolean;
+declare function assertTenantClientImportAllowed(importPath: string): void;
+declare function formatTenantClientImportViolation(classification: TenantClientImportClassification): string;
+
+export { TENANT_CLIENT_AUTH_MODES, TENANT_CLIENT_CAPABILITIES, TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS, TENANT_CLIENT_CONTRACT_VERSION, TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS, TENANT_CLIENT_FORBIDDEN_INSTALL_TOKEN_INFISICAL_PATHS, TENANT_CLIENT_FORBIDDEN_SECRET_ENV, TENANT_CLIENT_INSTALLABLE_PACKAGES, TENANT_CLIENT_INSTALL_TOKEN_ENV, TENANT_CLIENT_INSTALL_TOKEN_INFISICAL_PATH, TENANT_CLIENT_ISOLATION_RULES, TENANT_CLIENT_OPTIONAL_CONTEXT_FIELDS, TENANT_CLIENT_PRINCIPAL_TYPES, TENANT_CLIENT_PUBLIC_IMPORTS, TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS, TENANT_CLIENT_REQUIRED_SDK_NAMESPACES, type TenantClientAllowedImport, type TenantClientAuthMode, type TenantClientCapability, type TenantClientCapabilityId, type TenantClientComponentConfigImport, type TenantClientForbiddenImportPattern, type TenantClientForbiddenImportPatternId, type TenantClientForbiddenInstallTokenInfisicalPath, type TenantClientForbiddenSecretEnv, type TenantClientImportClassification, type TenantClientImportDecision, type TenantClientInstallablePackage, type TenantClientInstallablePackageName, type TenantClientIsolationRule, type TenantClientOptionalContextField, type TenantClientPackageRole, type TenantClientPrincipalType, type TenantClientPublicImport, type TenantClientPublicPackage, type TenantClientPublicSurface, type TenantClientRequiredContextField, type TenantClientRequiredSdkNamespace, assertTenantClientImportAllowed, classifyTenantClientImport, findTenantClientInstallablePackage, formatTenantClientImportViolation, isTenantClientAllowedImport, isTenantClientComponentConfigImport, isTenantClientInstallablePackage, isTenantClientPublicImport };

package/dist/tenant-client.contract.js

@@ -0,0 +1,404 @@
+// src/tenant-client.contract.ts
+var TENANT_CLIENT_CONTRACT_VERSION = "2026-04-27";
+var TENANT_CLIENT_AUTH_MODES = [
+  "interactive_user",
+  "service_principal",
+  "tenant_api_key",
+  "session_token"
+];
+var TENANT_CLIENT_PRINCIPAL_TYPES = [
+  "human",
+  "service",
+  "agent"
+];
+var TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS = [
+  "tenantId",
+  "workspaceId",
+  "principalId",
+  "authMode",
+  "scopes"
+];
+var TENANT_CLIENT_OPTIONAL_CONTEXT_FIELDS = [
+  "principalType",
+  "roles",
+  "sessionId",
+  "delegationChain"
+];
+var TENANT_CLIENT_INSTALL_TOKEN_ENV = "INSTALL_LUCERN_NPM";
+var TENANT_CLIENT_INSTALL_TOKEN_INFISICAL_PATH = "tenants/shared";
+var TENANT_CLIENT_FORBIDDEN_INSTALL_TOKEN_INFISICAL_PATHS = [
+  "/platform/publish"
+];
+var TENANT_CLIENT_FORBIDDEN_SECRET_ENV = ["NPM_TOKEN"];
+var TENANT_CLIENT_INSTALLABLE_PACKAGES = [
+  {
+    packageName: "@lucern/access-control",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/agent",
+    role: "platform_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/auth",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/cli",
+    role: "developer_tool",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/client-core",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/confidence",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/config",
+    role: "configuration",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/contracts",
+    role: "contract_entrypoint",
+    directTenantImport: true
+  },
+  {
+    packageName: "@lucern/control-plane",
+    role: "platform_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/developer-kit",
+    role: "developer_tool",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/events",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/graph-primitives",
+    role: "sdk_dependency",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/identity",
+    role: "component_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/mcp",
+    role: "runtime_entrypoint",
+    directTenantImport: true
+  },
+  {
+    packageName: "@lucern/pack-host",
+    role: "platform_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/pack-installer",
+    role: "developer_tool",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/proof-compiler",
+    role: "developer_tool",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/react",
+    role: "runtime_entrypoint",
+    directTenantImport: true
+  },
+  {
+    packageName: "@lucern/reasoning-kernel",
+    role: "component_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/sdk",
+    role: "runtime_entrypoint",
+    directTenantImport: true
+  },
+  {
+    packageName: "@lucern/server-core",
+    role: "platform_runtime",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/testing",
+    role: "test_support",
+    directTenantImport: false
+  },
+  {
+    packageName: "@lucern/types",
+    role: "contract_entrypoint",
+    directTenantImport: true
+  }
+];
+var TENANT_CLIENT_PUBLIC_IMPORTS = [
+  {
+    packageName: "@lucern/sdk",
+    surface: "runtime",
+    subpaths: "published_exports",
+    description: "TypeScript SDK runtime and generated operation namespaces."
+  },
+  {
+    packageName: "@lucern/react",
+    surface: "runtime",
+    subpaths: "published_exports",
+    description: "React bindings for tenant-owned UI applications."
+  },
+  {
+    packageName: "@lucern/mcp",
+    surface: "runtime",
+    subpaths: "published_exports",
+    description: "MCP client/server entry points and hosted route helpers."
+  },
+  {
+    packageName: "@lucern/contracts",
+    surface: "contract",
+    subpaths: "published_exports",
+    description: "Published type and manifest contracts."
+  },
+  {
+    packageName: "@lucern/types",
+    surface: "contract",
+    subpaths: "published_exports",
+    description: "Published type-only helpers for tenant integration code."
+  }
+];
+var TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS = [
+  {
+    packageName: "@lucern/identity",
+    importPath: "@lucern/identity/convex.config",
+    surface: "component_config",
+    description: "Convex component binding config for tenant deployments that install Lucern identity."
+  },
+  {
+    packageName: "@lucern/reasoning-kernel",
+    importPath: "@lucern/reasoning-kernel/convex.config",
+    surface: "component_config",
+    description: "Convex component binding config for tenant deployments that install the Lucern reasoning kernel."
+  },
+  {
+    packageName: "@lucern/reasoning-kernel",
+    importPath: "@lucern/reasoning-kernel/runtime.config",
+    surface: "component_config",
+    description: "Runtime config alias for tenant deployments that install the Lucern reasoning kernel."
+  }
+];
+function findTenantClientInstallablePackage(packageName) {
+  return TENANT_CLIENT_INSTALLABLE_PACKAGES.find(
+    (entry) => entry.packageName === packageName
+  );
+}
+function isTenantClientInstallablePackage(packageName) {
+  return Boolean(findTenantClientInstallablePackage(packageName));
+}
+var TENANT_CLIENT_REQUIRED_SDK_NAMESPACES = [
+  "bootstrap",
+  "context",
+  "beliefs",
+  "evidence",
+  "questions",
+  "graph",
+  "worktrees",
+  "topics",
+  "edges",
+  "contradictions",
+  "contracts",
+  "graphAnalysis",
+  "graphRecommendations",
+  "orgGraphSearch",
+  "embeddings",
+  "ontologyLinks",
+  "graphStateClassifier",
+  "tools",
+  "identity",
+  "modelRuntime",
+  "events",
+  "jobs",
+  "telemetry"
+];
+var TENANT_CLIENT_CAPABILITIES = [
+  {
+    id: "identity.bootstrap_session",
+    description: "Start a scoped Lucern session for a tenant principal.",
+    surfaces: ["@lucern/sdk", "@lucern/mcp"],
+    requiredContextFields: TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS
+  },
+  {
+    id: "reasoning.context.compile",
+    description: "Compile tenant and workspace scoped reasoning context.",
+    surfaces: ["@lucern/sdk", "@lucern/react", "@lucern/mcp"],
+    requiredContextFields: TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS
+  },
+  {
+    id: "reasoning.graph.read",
+    description: "Read beliefs, evidence, questions, topics, and lineage.",
+    surfaces: ["@lucern/sdk", "@lucern/react", "@lucern/mcp"],
+    requiredContextFields: TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS
+  },
+  {
+    id: "reasoning.graph.write",
+    description: "Create and update graph objects through authorized APIs.",
+    surfaces: ["@lucern/sdk", "@lucern/mcp"],
+    requiredContextFields: TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS
+  },
+  {
+    id: "workflow.worktree_lifecycle",
+    description: "Create, review, merge, and close scoped worktrees.",
+    surfaces: ["@lucern/sdk", "@lucern/react", "@lucern/mcp"],
+    requiredContextFields: TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS
+  }
+];
+var TENANT_CLIENT_ISOLATION_RULES = [
+  {
+    id: "tenant_workspace_scope_required",
+    description: "Runtime operations must resolve both tenantId and workspaceId before reaching Lucern reasoning state."
+  },
+  {
+    id: "principal_audit_required",
+    description: "Runtime operations must carry principalId, authMode, and scopes for audit attribution."
+  },
+  {
+    id: "no_private_lucern_imports",
+    description: "Tenant code must not import Lucern source, Convex internals, generated adapters, or unpublished package internals."
+  }
+];
+var TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS = [
+  {
+    id: "deep_src_import",
+    pattern: "^@lucern/[^/]+/src(?:/|$)",
+    description: "Published packages must not be bypassed through src paths."
+  },
+  {
+    id: "deep_dist_import",
+    pattern: "^@lucern/[^/]+/dist(?:/|$)",
+    description: "Published package exports must be used instead of dist file paths."
+  },
+  {
+    id: "generated_adapter_import",
+    pattern: "^@lucern/[^/]+/(?:adapters/)?_generated(?:/|$)",
+    description: "Generated Lucern adapters are internal deployment artifacts."
+  },
+  {
+    id: "private_runtime_import",
+    pattern: "^@lucern/[^/]+/(?:internal|private)(?:/|$)",
+    description: "Internal and private package subpaths are not public SDK API."
+  },
+  {
+    id: "workspace_source_import",
+    pattern: "^(?:packages|modules|services|lucern|apps)/(?:.+/)?src(?:/|$)",
+    description: "Tenant clients must not import source files from the Lucern monorepo."
+  },
+  {
+    id: "root_alias_lucern_import",
+    pattern: "^@/(?:lucern|packages|modules|services|apps)(?:/|$)",
+    description: "Tenant clients must not depend on Lucern repo-local path aliases."
+  },
+  {
+    id: "relative_lucern_source_import",
+    pattern: "^\\.\\.?/(?:.+/)?(?:packages|modules|services|lucern|apps)(?:/|$)",
+    description: "Tenant clients must not reach back into Lucern source through relative paths."
+  },
+  {
+    id: "monorepo_path_import",
+    pattern: "lucern-repo",
+    description: "Absolute imports that name the Lucern repository are not portable tenant code."
+  }
+];
+function matchesPublicImport(importPath) {
+  const componentConfig = TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS.find(
+    (entry) => importPath === entry.importPath
+  );
+  if (componentConfig) {
+    return componentConfig;
+  }
+  return TENANT_CLIENT_PUBLIC_IMPORTS.find(
+    (entry) => importPath === entry.packageName || importPath.startsWith(`${entry.packageName}/`)
+  );
+}
+function matchesForbiddenPattern(importPath) {
+  return TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS.find(
+    (entry) => new RegExp(entry.pattern, "u").test(importPath)
+  );
+}
+function classifyTenantClientImport(importPath) {
+  const normalizedImportPath = importPath.trim();
+  const pattern = matchesForbiddenPattern(normalizedImportPath);
+  if (pattern) {
+    return {
+      importPath: normalizedImportPath,
+      decision: "forbidden",
+      pattern,
+      reason: pattern.description
+    };
+  }
+  const publicImport = matchesPublicImport(normalizedImportPath);
+  if (publicImport) {
+    return {
+      importPath: normalizedImportPath,
+      decision: "public",
+      publicImport,
+      reason: publicImport.description
+    };
+  }
+  if (normalizedImportPath.startsWith("@lucern/")) {
+    return {
+      importPath: normalizedImportPath,
+      decision: "forbidden",
+      reason: "This @lucern package is not part of the tenant client public surface."
+    };
+  }
+  if (normalizedImportPath.startsWith("./") || normalizedImportPath.startsWith("../")) {
+    return {
+      importPath: normalizedImportPath,
+      decision: "local",
+      reason: "Local tenant-owned import."
+    };
+  }
+  return {
+    importPath: normalizedImportPath,
+    decision: "external",
+    reason: "External dependency outside the Lucern package namespace."
+  };
+}
+function isTenantClientPublicImport(importPath) {
+  return classifyTenantClientImport(importPath).decision === "public";
+}
+function isTenantClientComponentConfigImport(importPath) {
+  return TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS.some(
+    (entry) => importPath === entry.importPath
+  );
+}
+function isTenantClientAllowedImport(importPath) {
+  return classifyTenantClientImport(importPath).decision === "public";
+}
+function assertTenantClientImportAllowed(importPath) {
+  const classification = classifyTenantClientImport(importPath);
+  if (classification.decision !== "forbidden") {
+    return;
+  }
+  throw new Error(formatTenantClientImportViolation(classification));
+}
+function formatTenantClientImportViolation(classification) {
+  const patternId = classification.pattern ? ` [${classification.pattern.id}]` : "";
+  return `Tenant client import is not allowed${patternId}: ${classification.importPath}. ${classification.reason}`;
+}
+
+export { TENANT_CLIENT_AUTH_MODES, TENANT_CLIENT_CAPABILITIES, TENANT_CLIENT_COMPONENT_CONFIG_IMPORTS, TENANT_CLIENT_CONTRACT_VERSION, TENANT_CLIENT_FORBIDDEN_IMPORT_PATTERNS, TENANT_CLIENT_FORBIDDEN_INSTALL_TOKEN_INFISICAL_PATHS, TENANT_CLIENT_FORBIDDEN_SECRET_ENV, TENANT_CLIENT_INSTALLABLE_PACKAGES, TENANT_CLIENT_INSTALL_TOKEN_ENV, TENANT_CLIENT_INSTALL_TOKEN_INFISICAL_PATH, TENANT_CLIENT_ISOLATION_RULES, TENANT_CLIENT_OPTIONAL_CONTEXT_FIELDS, TENANT_CLIENT_PRINCIPAL_TYPES, TENANT_CLIENT_PUBLIC_IMPORTS, TENANT_CLIENT_REQUIRED_CONTEXT_FIELDS, TENANT_CLIENT_REQUIRED_SDK_NAMESPACES, assertTenantClientImportAllowed, classifyTenantClientImport, findTenantClientInstallablePackage, formatTenantClientImportViolation, isTenantClientAllowedImport, isTenantClientComponentConfigImport, isTenantClientInstallablePackage, isTenantClientPublicImport };
+//# sourceMappingURL=tenant-client.contract.js.map
+//# sourceMappingURL=tenant-client.contract.js.map