@lucern/sdk 1.0.11 → 1.0.12

package/dist/contracts/lensWorkflow.js

@@ -1,124 +1,2 @@
-// src/contracts/lens-filter.contract.ts
-function isLensFilterCriteria(value) {
-  return isRecord(value) && typeof value.version === "number" && typeof value.kind === "string";
-}
-function isTaxonomyFilterCriteriaV1(value) {
-  if (!isLensFilterCriteria(value)) return false;
-  return value.version === 1 && value.kind === "taxonomy";
-}
-function validateFilterCriteria(value) {
-  if (value === void 0 || value === null) {
-    return { valid: true };
-  }
-  if (!isLensFilterCriteria(value)) {
-    return {
-      valid: false,
-      errors: [
-        'filterCriteria must have numeric "version" and string "kind" fields'
-      ]
-    };
-  }
-  if (isTaxonomyFilterCriteriaV1(value)) {
-    return validateTaxonomyFilterV1(value);
-  }
-  const raw = value;
-  return {
-    valid: false,
-    errors: [
-      `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`
-    ]
-  };
-}
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function validateTaxonomyFilterV1(criteria) {
-  const errors = [];
-  if (!Array.isArray(criteria.entityTypeFilters)) {
-    errors.push("entityTypeFilters must be an array");
-    return { valid: false, errors };
-  }
-  if (criteria.entityTypeFilters.length === 0) {
-    errors.push("entityTypeFilters must contain at least one entry");
-    return { valid: false, errors };
-  }
-  for (let i = 0; i < criteria.entityTypeFilters.length; i++) {
-    const filter = criteria.entityTypeFilters[i];
-    if (!filter || typeof filter.entityTypeValue !== "string") {
-      errors.push(
-        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`
-      );
-      continue;
-    }
-    if (filter.entityTypeValue.trim().length === 0) {
-      errors.push(
-        `entityTypeFilters[${i}].entityTypeValue must be a non-empty string`
-      );
-    }
-    if (filter.subtypeValues !== void 0 && !Array.isArray(filter.subtypeValues)) {
-      errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);
-    }
-  }
-  if (criteria.ontologyScope !== void 0) {
-    if (typeof criteria.ontologyScope !== "object" || criteria.ontologyScope === null) {
-      errors.push("ontologyScope must be an object");
-    }
-  }
-  return errors.length === 0 ? { valid: true } : { valid: false, errors };
-}
-
-// src/contracts/lens-workflow.contract.ts
-var LENS_PERSPECTIVE_TYPES = [
-  "investigation",
-  "monitoring",
-  "analysis",
-  "comparison",
-  "taxonomy"
-];
-var LENS_STATUSES = ["draft", "active", "archived"];
-var LENS_TASK_TEMPLATE_PRIORITIES = [
-  "critical",
-  "high",
-  "medium",
-  "low"
-];
-var BRANCH_DEPRECATION_MESSAGE = "Branches are deprecated for operational framing. Create a workspace-scoped lens instead.";
-function inferLensPerspectiveTypeFromBranchSchema(schema) {
-  const normalized = schema?.trim().toLowerCase();
-  if (normalized === "phase") {
-    return "monitoring";
-  }
-  if (normalized === "axis" || normalized === "dimension") {
-    return "comparison";
-  }
-  if (normalized === "track") {
-    return "investigation";
-  }
-  return "analysis";
-}
-function migrateBranchToLens(args) {
-  const perspectiveType = inferLensPerspectiveTypeFromBranchSchema(args.schema);
-  return {
-    recommendedTool: "create_lens",
-    perspectiveType,
-    message: "Branches are deprecated for operational framing. Create a workspace-scoped lens with the suggested payload instead.",
-    suggestedPayload: {
-      name: args.name,
-      description: args.description,
-      topicId: args.topicId,
-      workspaceId: args.workspaceId,
-      perspectiveType
-    }
-  };
-}
-function buildDeprecatedBranchMetadata(args) {
-  return {
-    deprecated: true,
-    deprecationMessage: BRANCH_DEPRECATION_MESSAGE,
-    lensSuggestion: migrateBranchToLens(args)
-  };
-}
-
-export { BRANCH_DEPRECATION_MESSAGE, LENS_PERSPECTIVE_TYPES, LENS_STATUSES, LENS_TASK_TEMPLATE_PRIORITIES, buildDeprecatedBranchMetadata, inferLensPerspectiveTypeFromBranchSchema, isLensFilterCriteria, isTaxonomyFilterCriteriaV1, migrateBranchToLens, validateFilterCriteria };
-//# sourceMappingURL=lensWorkflow.js.map
+export * from "./lens-workflow.contract.js";
 //# sourceMappingURL=lensWorkflow.js.map

package/dist/contracts/mcpTools.d.ts

@@ -1,20 +1,19 @@
-import { McpToolContract } from '@lucern/contracts/tool-contracts';
-export * from '@lucern/contracts/tool-contracts';
-
-declare const MCP_ALWAYS_ALLOWED_TOOL_NAMES: readonly ["identity_whoami"];
-type McpToolInputSchema = {
+export * from "./tool-contracts";
+import { type McpToolContract } from "./tool-contracts";
+export declare const MCP_ALWAYS_ALLOWED_TOOL_NAMES: readonly ["identity_whoami", "lucern_orient"];
+export type McpToolInputSchema = {
     type: "object";
     properties: Record<string, unknown>;
     required: string[];
 };
-type McpPermittedTool = {
+export type McpPermittedTool = {
     toolName: string;
     requiredRole?: string;
     approvalGateId?: string;
     isCore?: boolean;
     category?: string;
 };
-type McpToolManifestEntry = {
+export type McpToolManifestEntry = {
     name: string;
     description: string;
     inputSchema: McpToolInputSchema;
@@ -23,25 +22,24 @@ type McpToolManifestEntry = {
     ontologyPrimitive: McpToolContract["ontologyPrimitive"];
     tier: McpToolContract["tier"];
 };
-type McpToolContractMap = Record<string, McpToolContract>;
-type BuildMcpToolContractsOptions = {
+export type McpToolContractMap = Record<string, McpToolContract>;
+export type BuildMcpToolContractsOptions = {
     extensions?: McpToolContractMap;
 };
-type McpToolVisibilityOptions = {
+export type McpToolVisibilityOptions = {
     contracts?: McpToolContractMap;
     sessionType?: "agent" | "user";
     permittedTools?: readonly McpPermittedTool[] | null;
     allowedTools?: readonly string[] | null;
     alwaysAllowedTools?: readonly string[];
 };
-declare function getMcpToolExposure(toolName: string): "public" | "internal" | "none";
-declare function buildMcpToolContracts(options?: BuildMcpToolContractsOptions): McpToolContractMap;
-declare function mcpContractToInputSchema(contract: McpToolContract): McpToolInputSchema;
-declare function mcpContractToManifestEntry(name: string, contract: McpToolContract): McpToolManifestEntry;
-declare function isMcpToolAllowed(toolName: string, options?: McpToolVisibilityOptions): boolean;
-declare function buildMcpToolManifest(args?: {
+export declare function getMcpToolExposure(toolName: string): "public" | "internal" | "none";
+export declare function buildMcpToolContracts(options?: BuildMcpToolContractsOptions): McpToolContractMap;
+export declare function mcpContractToInputSchema(contract: McpToolContract): McpToolInputSchema;
+export declare function mcpContractToManifestEntry(name: string, contract: McpToolContract): McpToolManifestEntry;
+export declare function isMcpToolAllowed(toolName: string, options?: McpToolVisibilityOptions): boolean;
+export declare function buildMcpToolManifest(args?: {
     contracts?: McpToolContractMap;
     visibility?: McpToolVisibilityOptions;
 }): McpToolManifestEntry[];
-
-export { type BuildMcpToolContractsOptions, MCP_ALWAYS_ALLOWED_TOOL_NAMES, type McpPermittedTool, type McpToolContractMap, type McpToolInputSchema, type McpToolManifestEntry, type McpToolVisibilityOptions, buildMcpToolContracts, buildMcpToolManifest, getMcpToolExposure, isMcpToolAllowed, mcpContractToInputSchema, mcpContractToManifestEntry };
+//# sourceMappingURL=mcpTools.d.ts.map

package/dist/contracts/mcpTools.js

@@ -1,135 +1,101 @@
-import * as tool_contracts_star from '@lucern/contracts/tool-contracts';
-import { LUCERN_OPERATION_MANIFEST } from '@lucern/contracts/function-registry/manifest';
-
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
-
-// src/contracts/mcpTools.ts
-var mcpTools_exports = {};
-__export(mcpTools_exports, {
-  MCP_ALWAYS_ALLOWED_TOOL_NAMES: () => MCP_ALWAYS_ALLOWED_TOOL_NAMES,
-  buildMcpToolContracts: () => buildMcpToolContracts,
-  buildMcpToolManifest: () => buildMcpToolManifest,
-  getMcpToolExposure: () => getMcpToolExposure,
-  isMcpToolAllowed: () => isMcpToolAllowed,
-  mcpContractToInputSchema: () => mcpContractToInputSchema,
-  mcpContractToManifestEntry: () => mcpContractToManifestEntry
-});
-
-// src/contracts/tool-contracts.ts
-var tool_contracts_exports = {};
-__reExport(tool_contracts_exports, tool_contracts_star);
-
-// src/contracts/mcpTools.ts
-__reExport(mcpTools_exports, tool_contracts_exports);
-var OPERATION_MANIFEST = LUCERN_OPERATION_MANIFEST;
-var MCP_ALWAYS_ALLOWED_TOOL_NAMES = ["identity_whoami"];
-function getMcpToolExposure(toolName) {
-  return OPERATION_MANIFEST[toolName]?.surfaces.mcp ?? "none";
+export * from "./tool-contracts.js";
+import { LUCERN_OPERATION_MANIFEST } from "@lucern/contracts/function-registry/manifest";
+import { MCP_TOOL_CONTRACTS, } from "./tool-contracts.js";
+const OPERATION_MANIFEST = LUCERN_OPERATION_MANIFEST;
+export const MCP_ALWAYS_ALLOWED_TOOL_NAMES = [
+    "identity_whoami",
+    "lucern_orient",
+];
+export function getMcpToolExposure(toolName) {
+    return OPERATION_MANIFEST[toolName]?.surfaces.mcp ?? "none";
 }
 function decorateMcpToolContract(toolName, contract) {
-  const exposure = getMcpToolExposure(toolName);
-  if (exposure === "none") {
-    return null;
-  }
-  return exposure === "internal" || contract.internal ? { ...contract, internal: true } : contract;
-}
-function buildMcpToolContracts(options = {}) {
-  const merged = {
-    ...tool_contracts_exports.MCP_TOOL_CONTRACTS,
-    ...options.extensions ?? {}
-  };
-  return Object.fromEntries(
-    Object.entries(merged).flatMap(([toolName, contract]) => {
-      const decorated = decorateMcpToolContract(toolName, contract);
-      return decorated ? [[toolName, decorated]] : [];
-    })
-  );
+    const exposure = getMcpToolExposure(toolName);
+    if (exposure === "none") {
+        return null;
+    }
+    return exposure === "internal" || contract.internal
+        ? { ...contract, internal: true }
+        : contract;
 }
-function mcpContractToInputSchema(contract) {
-  const properties = {};
-  for (const [paramName, paramDef] of Object.entries(contract.parameters)) {
-    const prop = {
-      type: paramDef.type,
-      description: paramDef.description
+export function buildMcpToolContracts(options = {}) {
+    const merged = {
+        ...MCP_TOOL_CONTRACTS,
+        ...(options.extensions ?? {}),
     };
-    if (paramDef.enum) {
-      prop.enum = paramDef.enum;
+    return Object.fromEntries(Object.entries(merged).flatMap(([toolName, contract]) => {
+        const decorated = decorateMcpToolContract(toolName, contract);
+        return decorated ? [[toolName, decorated]] : [];
+    }));
+}
+export function mcpContractToInputSchema(contract) {
+    const properties = {};
+    for (const [paramName, paramDef] of Object.entries(contract.parameters)) {
+        const prop = {
+            type: paramDef.type,
+            description: paramDef.description,
+        };
+        if (paramDef.enum) {
+            prop.enum = paramDef.enum;
+        }
+        properties[paramName] = prop;
     }
-    properties[paramName] = prop;
-  }
-  return {
-    type: "object",
-    properties,
-    required: contract.required
-  };
+    return {
+        type: "object",
+        properties,
+        required: contract.required,
+    };
 }
-function mcpContractToManifestEntry(name, contract) {
-  return {
-    name,
-    description: contract.description,
-    inputSchema: mcpContractToInputSchema(contract),
-    internal: Boolean(contract.internal),
-    ownerModule: contract.ownerModule,
-    ontologyPrimitive: contract.ontologyPrimitive,
-    tier: contract.tier
-  };
+export function mcpContractToManifestEntry(name, contract) {
+    return {
+        name,
+        description: contract.description,
+        inputSchema: mcpContractToInputSchema(contract),
+        internal: Boolean(contract.internal),
+        ownerModule: contract.ownerModule,
+        ontologyPrimitive: contract.ontologyPrimitive,
+        tier: contract.tier,
+    };
 }
-function isMcpToolAllowed(toolName, options = {}) {
-  const contracts = options.contracts ?? buildMcpToolContracts();
-  const contract = contracts[toolName];
-  const alwaysAllowed = /* @__PURE__ */ new Set([
-    ...MCP_ALWAYS_ALLOWED_TOOL_NAMES,
-    ...options.alwaysAllowedTools ?? []
-  ]);
-  if (alwaysAllowed.has(toolName)) {
-    return true;
-  }
-  if (options.sessionType === "user" && contract?.internal) {
-    return false;
-  }
-  if (options.permittedTools !== void 0 && options.permittedTools !== null) {
-    return options.permittedTools.some((tool) => tool.toolName === toolName);
-  }
-  if (options.sessionType === "agent") {
-    if (options.allowedTools === null || options.allowedTools === void 0) {
-      return false;
+export function isMcpToolAllowed(toolName, options = {}) {
+    const contracts = options.contracts ?? buildMcpToolContracts();
+    const contract = contracts[toolName];
+    const alwaysAllowed = new Set([
+        ...MCP_ALWAYS_ALLOWED_TOOL_NAMES,
+        ...(options.alwaysAllowedTools ?? []),
+    ]);
+    if (alwaysAllowed.has(toolName)) {
+        return true;
+    }
+    if (options.sessionType === "user" && contract?.internal) {
+        return false;
+    }
+    if (options.permittedTools !== undefined && options.permittedTools !== null) {
+        return options.permittedTools.some((tool) => tool.toolName === toolName);
+    }
+    if (options.sessionType === "agent") {
+        if (options.allowedTools === null || options.allowedTools === undefined) {
+            return false;
+        }
+        return options.allowedTools.includes(toolName);
+    }
+    if (options.allowedTools === null || options.allowedTools === undefined) {
+        return true;
     }
     return options.allowedTools.includes(toolName);
-  }
-  if (options.allowedTools === null || options.allowedTools === void 0) {
-    return true;
-  }
-  return options.allowedTools.includes(toolName);
 }
-function buildMcpToolManifest(args = {}) {
-  const contracts = args.contracts ?? buildMcpToolContracts();
-  return Object.entries(contracts).filter(([name, contract]) => {
-    if (args.visibility?.sessionType === "user" && contract.internal) {
-      return false;
-    }
-    return isMcpToolAllowed(name, {
-      ...args.visibility,
-      contracts
-    });
-  }).map(([name, contract]) => mcpContractToManifestEntry(name, contract));
+export function buildMcpToolManifest(args = {}) {
+    const contracts = args.contracts ?? buildMcpToolContracts();
+    return Object.entries(contracts)
+        .filter(([name, contract]) => {
+        if (args.visibility?.sessionType === "user" && contract.internal) {
+            return false;
+        }
+        return isMcpToolAllowed(name, {
+            ...args.visibility,
+            contracts,
+        });
+    })
+        .map(([name, contract]) => mcpContractToManifestEntry(name, contract));
 }
-
-export { MCP_ALWAYS_ALLOWED_TOOL_NAMES, buildMcpToolContracts, buildMcpToolManifest, getMcpToolExposure, isMcpToolAllowed, mcpContractToInputSchema, mcpContractToManifestEntry };
-//# sourceMappingURL=mcpTools.js.map
 //# sourceMappingURL=mcpTools.js.map

package/dist/contracts/prompt.contract.d.ts

@@ -1,8 +1,8 @@
 /**
  * Prompt contract for portable, provider-agnostic prompt artifacts.
  */
-type LucernPromptModelHint = "fast" | "balanced" | "strong";
-type LucernPrompt = {
+export type LucernPromptModelHint = "fast" | "balanced" | "strong";
+export type LucernPrompt = {
     /** Stable prompt identifier, e.g. "lucern/classify-evidence" */
     slug: string;
     /** Semver-ish prompt version, e.g. "1.0.0" */
@@ -21,6 +21,5 @@ type LucernPrompt = {
         tags: string[];
     };
 };
-declare function isLucernPrompt(value: unknown): value is LucernPrompt;
-
-export { type LucernPrompt, type LucernPromptModelHint, isLucernPrompt };
+export declare function isLucernPrompt(value: unknown): value is LucernPrompt;
+//# sourceMappingURL=prompt.contract.d.ts.map

package/dist/contracts/prompt.contract.js

@@ -1,12 +1,25 @@
-// src/contracts/prompt.contract.ts
-function isLucernPrompt(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const prompt = value;
-  return typeof prompt.slug === "string" && typeof prompt.version === "string" && typeof prompt.template === "string" && Array.isArray(prompt.variables) && prompt.variables.every((entry) => typeof entry === "string") && (prompt.modelHint === "fast" || prompt.modelHint === "balanced" || prompt.modelHint === "strong") && !!prompt.metadata && typeof prompt.metadata === "object" && typeof prompt.metadata.author === "string" && typeof prompt.metadata.createdAt === "string" && typeof prompt.metadata.description === "string" && Array.isArray(prompt.metadata.tags) && prompt.metadata.tags.every((entry) => typeof entry === "string");
+/**
+ * Prompt contract for portable, provider-agnostic prompt artifacts.
+ */
+export function isLucernPrompt(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const prompt = value;
+    return (typeof prompt.slug === "string" &&
+        typeof prompt.version === "string" &&
+        typeof prompt.template === "string" &&
+        Array.isArray(prompt.variables) &&
+        prompt.variables.every((entry) => typeof entry === "string") &&
+        (prompt.modelHint === "fast" ||
+            prompt.modelHint === "balanced" ||
+            prompt.modelHint === "strong") &&
+        !!prompt.metadata &&
+        typeof prompt.metadata === "object" &&
+        typeof prompt.metadata.author === "string" &&
+        typeof prompt.metadata.createdAt === "string" &&
+        typeof prompt.metadata.description === "string" &&
+        Array.isArray(prompt.metadata.tags) &&
+        prompt.metadata.tags.every((entry) => typeof entry === "string"));
 }
-
-export { isLucernPrompt };
-//# sourceMappingURL=prompt.contract.js.map
 //# sourceMappingURL=prompt.contract.js.map

package/dist/contracts/prompt.d.ts

@@ -1 +1,2 @@
-export { LucernPrompt, LucernPromptModelHint, isLucernPrompt } from './prompt.contract.js';
+export * from "./prompt.contract";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/contracts/prompt.js

@@ -1,12 +1,2 @@
-// src/contracts/prompt.contract.ts
-function isLucernPrompt(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const prompt = value;
-  return typeof prompt.slug === "string" && typeof prompt.version === "string" && typeof prompt.template === "string" && Array.isArray(prompt.variables) && prompt.variables.every((entry) => typeof entry === "string") && (prompt.modelHint === "fast" || prompt.modelHint === "balanced" || prompt.modelHint === "strong") && !!prompt.metadata && typeof prompt.metadata === "object" && typeof prompt.metadata.author === "string" && typeof prompt.metadata.createdAt === "string" && typeof prompt.metadata.description === "string" && Array.isArray(prompt.metadata.tags) && prompt.metadata.tags.every((entry) => typeof entry === "string");
-}
-
-export { isLucernPrompt };
-//# sourceMappingURL=prompt.js.map
+export * from "./prompt.contract.js";
 //# sourceMappingURL=prompt.js.map

package/dist/contracts/sdk-tools.contract.d.ts

@@ -1 +1,2 @@
-export * from '@lucern/contracts/sdk-tools.contract';
+export * from "@lucern/contracts/sdk-tools.contract";
+//# sourceMappingURL=sdk-tools.contract.d.ts.map

package/dist/contracts/sdk-tools.contract.js

@@ -1,3 +1,2 @@
-export * from '@lucern/contracts/sdk-tools.contract';
-//# sourceMappingURL=sdk-tools.contract.js.map
+export * from "@lucern/contracts/sdk-tools.contract";
 //# sourceMappingURL=sdk-tools.contract.js.map

package/dist/contracts/sdkTools.d.ts

@@ -1 +1,2 @@
-export * from '@lucern/contracts/sdk-tools.contract';
+export * from "./sdk-tools.contract";
+//# sourceMappingURL=sdkTools.d.ts.map

package/dist/contracts/sdkTools.js

@@ -1,27 +1,2 @@
-import * as sdk_tools_star from '@lucern/contracts/sdk-tools.contract';
-
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
-
-// src/contracts/sdkTools.ts
-var sdkTools_exports = {};
-
-// src/contracts/sdk-tools.contract.ts
-var sdk_tools_contract_exports = {};
-__reExport(sdk_tools_contract_exports, sdk_tools_star);
-
-// src/contracts/sdkTools.ts
-__reExport(sdkTools_exports, sdk_tools_contract_exports);
-//# sourceMappingURL=sdkTools.js.map
+export * from "./sdk-tools.contract.js";
 //# sourceMappingURL=sdkTools.js.map

package/dist/contracts/tool-contracts.d.ts

@@ -1 +1,2 @@
-export * from '@lucern/contracts/tool-contracts';
+export * from "@lucern/contracts/tool-contracts";
+//# sourceMappingURL=tool-contracts.d.ts.map

package/dist/contracts/tool-contracts.js

@@ -1,3 +1,2 @@
-export * from '@lucern/contracts/tool-contracts';
-//# sourceMappingURL=tool-contracts.js.map
+export * from "@lucern/contracts/tool-contracts";
 //# sourceMappingURL=tool-contracts.js.map