@lucern/sdk 0.2.0-alpha.5 → 0.2.0-alpha.7

package/src/contracts/mcpTools.ts

@@ -0,0 +1 @@
+export * from "./mcp-tools.contract";

package/src/contracts/prompt.contract.ts

@@ -0,0 +1,50 @@
+/**
+ * Prompt contract for portable, provider-agnostic prompt artifacts.
+ */
+
+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" */
+  version: string;
+  /** Prompt template text (supports {{variable}} interpolation) */
+  template: string;
+  /** Variables expected by the template */
+  variables: string[];
+  /** Model family hint for runtime model routing */
+  modelHint: LucernPromptModelHint;
+  /** Metadata used for ownership and discovery */
+  metadata: {
+    author: string;
+    createdAt: string;
+    description: string;
+    tags: string[];
+  };
+};
+
+export function isLucernPrompt(value: unknown): value is LucernPrompt {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const prompt = value as Partial<LucernPrompt>;
+
+  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")
+  );
+}

package/src/contracts/prompt.ts

@@ -0,0 +1 @@
+export * from "./prompt.contract";