@fabricorg/experiments-prompts 0.1.0

package/README.md

@@ -0,0 +1,10 @@
+# @fabricorg/experiments-prompts
+
+Typed prompt messages, model parameters, variable rendering, and content-hash
+version identity for Fabric Experiments AI Quality suites.
+
+```ts
+import { hashTemplate, renderPrompt } from '@fabricorg/experiments-prompts';
+```
+
+See [experiments.fabric.pro/docs/ai-quality/overview](https://experiments.fabric.pro/docs/ai-quality/overview).

package/dist/index.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+var zod = require('zod');
+var experimentsDatasets = require('@fabricorg/experiments-datasets');
+
+// src/schema.ts
+var PromptId = zod.z.string().min(2).max(64).regex(/^[a-z][a-z0-9-]*$/, "lowercase kebab-case, must start with a letter");
+var PromptMessage = zod.z.object({
+  role: zod.z.enum(["system", "user", "assistant"]),
+  /** Template text; {{variable}} placeholders are substituted at render time. */
+  content: zod.z.string().min(1).max(1e5)
+});
+var ModelParams = zod.z.object({
+  /** Model Serving endpoint or model name; resolution happens in the control plane. */
+  model: zod.z.string().max(256).optional(),
+  temperature: zod.z.number().min(0).max(2).optional(),
+  maxTokens: zod.z.number().int().min(1).max(2e5).optional(),
+  topP: zod.z.number().min(0).max(1).optional()
+});
+var PromptTemplate = zod.z.object({
+  messages: zod.z.array(PromptMessage).min(1).max(50),
+  params: ModelParams.default({})
+});
+var Prompt = zod.z.object({
+  tenantId: zod.z.string().min(1),
+  id: PromptId,
+  name: zod.z.string().min(1).max(120),
+  description: zod.z.string().max(2e3).optional(),
+  latestVersion: zod.z.number().int().min(0),
+  createdAtIso: zod.z.string().datetime(),
+  updatedAtIso: zod.z.string().datetime()
+});
+var PromptVersion = zod.z.object({
+  promptId: PromptId,
+  version: zod.z.number().int().min(1),
+  template: PromptTemplate,
+  contentHash: zod.z.string().regex(/^[a-f0-9]{64}$/),
+  createdAtIso: zod.z.string().datetime(),
+  note: zod.z.string().max(500).optional()
+});
+var VARIABLE_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
+function templateVariables(template) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of template.messages) {
+    for (const match of m.content.matchAll(VARIABLE_RE)) {
+      const name = match[1];
+      if (!seen.has(name)) {
+        seen.add(name);
+        out.push(name);
+      }
+    }
+  }
+  return out;
+}
+function renderPrompt(template, variables) {
+  const missing = templateVariables(template).filter((v) => !(v in variables));
+  const messages = template.messages.map((m) => ({
+    role: m.role,
+    content: m.content.replace(VARIABLE_RE, (_, name) => variables[name] ?? "")
+  }));
+  return { messages, missing };
+}
+function hashTemplate(template) {
+  return experimentsDatasets.sha256Hex(experimentsDatasets.canonicalJson(template));
+}
+
+exports.ModelParams = ModelParams;
+exports.Prompt = Prompt;
+exports.PromptId = PromptId;
+exports.PromptMessage = PromptMessage;
+exports.PromptTemplate = PromptTemplate;
+exports.PromptVersion = PromptVersion;
+exports.hashTemplate = hashTemplate;
+exports.renderPrompt = renderPrompt;
+exports.templateVariables = templateVariables;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/render.ts"],"names":["z","sha256Hex","canonicalJson"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod';\n\nexport const PromptId = z\n  .string()\n  .min(2)\n  .max(64)\n  .regex(/^[a-z][a-z0-9-]*$/, 'lowercase kebab-case, must start with a letter');\nexport type PromptId = z.infer<typeof PromptId>;\n\nexport const PromptMessage = z.object({\n  role: z.enum(['system', 'user', 'assistant']),\n  /** Template text; {{variable}} placeholders are substituted at render time. */\n  content: z.string().min(1).max(100000),\n});\nexport type PromptMessage = z.infer<typeof PromptMessage>;\n\nexport const ModelParams = z.object({\n  /** Model Serving endpoint or model name; resolution happens in the control plane. */\n  model: z.string().max(256).optional(),\n  temperature: z.number().min(0).max(2).optional(),\n  maxTokens: z.number().int().min(1).max(200000).optional(),\n  topP: z.number().min(0).max(1).optional(),\n});\nexport type ModelParams = z.infer<typeof ModelParams>;\n\n/** The versionable content of a prompt — what the content hash covers. */\nexport const PromptTemplate = z.object({\n  messages: z.array(PromptMessage).min(1).max(50),\n  params: ModelParams.default({}),\n});\nexport type PromptTemplate = z.infer<typeof PromptTemplate>;\n\nexport const Prompt = z.object({\n  tenantId: z.string().min(1),\n  id: PromptId,\n  name: z.string().min(1).max(120),\n  description: z.string().max(2000).optional(),\n  latestVersion: z.number().int().min(0),\n  createdAtIso: z.string().datetime(),\n  updatedAtIso: z.string().datetime(),\n});\nexport type Prompt = z.infer<typeof Prompt>;\n\n/**\n * Immutable prompt version. Content-addressed like dataset versions and the\n * edge manifest: identical templates always yield identical hashes, so a\n * judge's provenance promptHash can be traced back to a registry version.\n */\nexport const PromptVersion = z.object({\n  promptId: PromptId,\n  version: z.number().int().min(1),\n  template: PromptTemplate,\n  contentHash: z.string().regex(/^[a-f0-9]{64}$/),\n  createdAtIso: z.string().datetime(),\n  note: z.string().max(500).optional(),\n});\nexport type PromptVersion = z.infer<typeof PromptVersion>;\n","import { canonicalJson, sha256Hex } from '@fabricorg/experiments-datasets';\nimport type { PromptMessage, PromptTemplate } from './schema.js';\n\n/** {{variable}} — same placeholder syntax as the evals judge templates. */\nconst VARIABLE_RE = /\\{\\{\\s*([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\}\\}/g;\n\n/** Distinct variable names referenced by a template, in first-appearance order. */\nexport function templateVariables(template: PromptTemplate): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of template.messages) {\n    for (const match of m.content.matchAll(VARIABLE_RE)) {\n      const name = match[1]!;\n      if (!seen.has(name)) {\n        seen.add(name);\n        out.push(name);\n      }\n    }\n  }\n  return out;\n}\n\nexport interface RenderResult {\n  messages: PromptMessage[];\n  /** Variables referenced by the template but absent from the input. */\n  missing: string[];\n}\n\n/**\n * Substitute variables into every message. Missing variables render as empty\n * strings and are reported — the playground surfaces them as a warning\n * rather than refusing to run (matching judge-template render semantics).\n */\nexport function renderPrompt(\n  template: PromptTemplate,\n  variables: Record<string, string>,\n): RenderResult {\n  const missing = templateVariables(template).filter((v) => !(v in variables));\n  const messages = template.messages.map((m) => ({\n    role: m.role,\n    content: m.content.replace(VARIABLE_RE, (_, name: string) => variables[name] ?? ''),\n  }));\n  return { messages, missing };\n}\n\n/** Content hash over the canonical template JSON — version identity. */\nexport function hashTemplate(template: PromptTemplate): string {\n  return sha256Hex(canonicalJson(template));\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,233 @@
+import { z } from 'zod';
+
+declare const PromptId: z.ZodString;
+type PromptId = z.infer<typeof PromptId>;
+declare const PromptMessage: z.ZodObject<{
+    role: z.ZodEnum<["system", "user", "assistant"]>;
+    /** Template text; {{variable}} placeholders are substituted at render time. */
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}>;
+type PromptMessage = z.infer<typeof PromptMessage>;
+declare const ModelParams: z.ZodObject<{
+    /** Model Serving endpoint or model name; resolution happens in the control plane. */
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    topP?: number | undefined;
+}, {
+    model?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    topP?: number | undefined;
+}>;
+type ModelParams = z.infer<typeof ModelParams>;
+/** The versionable content of a prompt — what the content hash covers. */
+declare const PromptTemplate: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["system", "user", "assistant"]>;
+        /** Template text; {{variable}} placeholders are substituted at render time. */
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }, {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }>, "many">;
+    params: z.ZodDefault<z.ZodObject<{
+        /** Model Serving endpoint or model name; resolution happens in the control plane. */
+        model: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    }, {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    params: {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    };
+    messages: {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }[];
+}, {
+    messages: {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }[];
+    params?: {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    } | undefined;
+}>;
+type PromptTemplate = z.infer<typeof PromptTemplate>;
+declare const Prompt: z.ZodObject<{
+    tenantId: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    latestVersion: z.ZodNumber;
+    createdAtIso: z.ZodString;
+    updatedAtIso: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    id: string;
+    name: string;
+    latestVersion: number;
+    createdAtIso: string;
+    updatedAtIso: string;
+    description?: string | undefined;
+}, {
+    tenantId: string;
+    id: string;
+    name: string;
+    latestVersion: number;
+    createdAtIso: string;
+    updatedAtIso: string;
+    description?: string | undefined;
+}>;
+type Prompt = z.infer<typeof Prompt>;
+/**
+ * Immutable prompt version. Content-addressed like dataset versions and the
+ * edge manifest: identical templates always yield identical hashes, so a
+ * judge's provenance promptHash can be traced back to a registry version.
+ */
+declare const PromptVersion: z.ZodObject<{
+    promptId: z.ZodString;
+    version: z.ZodNumber;
+    template: z.ZodObject<{
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant"]>;
+            /** Template text; {{variable}} placeholders are substituted at render time. */
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>, "many">;
+        params: z.ZodDefault<z.ZodObject<{
+            /** Model Serving endpoint or model name; resolution happens in the control plane. */
+            model: z.ZodOptional<z.ZodString>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+            topP: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        }, {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        params: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        };
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+    }, {
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        params?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        } | undefined;
+    }>;
+    contentHash: z.ZodString;
+    createdAtIso: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    createdAtIso: string;
+    promptId: string;
+    version: number;
+    template: {
+        params: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        };
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+    };
+    contentHash: string;
+    note?: string | undefined;
+}, {
+    createdAtIso: string;
+    promptId: string;
+    version: number;
+    template: {
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        params?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        } | undefined;
+    };
+    contentHash: string;
+    note?: string | undefined;
+}>;
+type PromptVersion = z.infer<typeof PromptVersion>;
+
+/** Distinct variable names referenced by a template, in first-appearance order. */
+declare function templateVariables(template: PromptTemplate): string[];
+interface RenderResult {
+    messages: PromptMessage[];
+    /** Variables referenced by the template but absent from the input. */
+    missing: string[];
+}
+/**
+ * Substitute variables into every message. Missing variables render as empty
+ * strings and are reported — the playground surfaces them as a warning
+ * rather than refusing to run (matching judge-template render semantics).
+ */
+declare function renderPrompt(template: PromptTemplate, variables: Record<string, string>): RenderResult;
+/** Content hash over the canonical template JSON — version identity. */
+declare function hashTemplate(template: PromptTemplate): string;
+
+export { ModelParams, Prompt, PromptId, PromptMessage, PromptTemplate, PromptVersion, type RenderResult, hashTemplate, renderPrompt, templateVariables };

package/dist/index.d.ts

@@ -0,0 +1,233 @@
+import { z } from 'zod';
+
+declare const PromptId: z.ZodString;
+type PromptId = z.infer<typeof PromptId>;
+declare const PromptMessage: z.ZodObject<{
+    role: z.ZodEnum<["system", "user", "assistant"]>;
+    /** Template text; {{variable}} placeholders are substituted at render time. */
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}>;
+type PromptMessage = z.infer<typeof PromptMessage>;
+declare const ModelParams: z.ZodObject<{
+    /** Model Serving endpoint or model name; resolution happens in the control plane. */
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    topP?: number | undefined;
+}, {
+    model?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    topP?: number | undefined;
+}>;
+type ModelParams = z.infer<typeof ModelParams>;
+/** The versionable content of a prompt — what the content hash covers. */
+declare const PromptTemplate: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["system", "user", "assistant"]>;
+        /** Template text; {{variable}} placeholders are substituted at render time. */
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }, {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }>, "many">;
+    params: z.ZodDefault<z.ZodObject<{
+        /** Model Serving endpoint or model name; resolution happens in the control plane. */
+        model: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    }, {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    params: {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    };
+    messages: {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }[];
+}, {
+    messages: {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }[];
+    params?: {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        topP?: number | undefined;
+    } | undefined;
+}>;
+type PromptTemplate = z.infer<typeof PromptTemplate>;
+declare const Prompt: z.ZodObject<{
+    tenantId: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    latestVersion: z.ZodNumber;
+    createdAtIso: z.ZodString;
+    updatedAtIso: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    id: string;
+    name: string;
+    latestVersion: number;
+    createdAtIso: string;
+    updatedAtIso: string;
+    description?: string | undefined;
+}, {
+    tenantId: string;
+    id: string;
+    name: string;
+    latestVersion: number;
+    createdAtIso: string;
+    updatedAtIso: string;
+    description?: string | undefined;
+}>;
+type Prompt = z.infer<typeof Prompt>;
+/**
+ * Immutable prompt version. Content-addressed like dataset versions and the
+ * edge manifest: identical templates always yield identical hashes, so a
+ * judge's provenance promptHash can be traced back to a registry version.
+ */
+declare const PromptVersion: z.ZodObject<{
+    promptId: z.ZodString;
+    version: z.ZodNumber;
+    template: z.ZodObject<{
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant"]>;
+            /** Template text; {{variable}} placeholders are substituted at render time. */
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>, "many">;
+        params: z.ZodDefault<z.ZodObject<{
+            /** Model Serving endpoint or model name; resolution happens in the control plane. */
+            model: z.ZodOptional<z.ZodString>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+            topP: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        }, {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        params: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        };
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+    }, {
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        params?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        } | undefined;
+    }>;
+    contentHash: z.ZodString;
+    createdAtIso: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    createdAtIso: string;
+    promptId: string;
+    version: number;
+    template: {
+        params: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        };
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+    };
+    contentHash: string;
+    note?: string | undefined;
+}, {
+    createdAtIso: string;
+    promptId: string;
+    version: number;
+    template: {
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        params?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+        } | undefined;
+    };
+    contentHash: string;
+    note?: string | undefined;
+}>;
+type PromptVersion = z.infer<typeof PromptVersion>;
+
+/** Distinct variable names referenced by a template, in first-appearance order. */
+declare function templateVariables(template: PromptTemplate): string[];
+interface RenderResult {
+    messages: PromptMessage[];
+    /** Variables referenced by the template but absent from the input. */
+    missing: string[];
+}
+/**
+ * Substitute variables into every message. Missing variables render as empty
+ * strings and are reported — the playground surfaces them as a warning
+ * rather than refusing to run (matching judge-template render semantics).
+ */
+declare function renderPrompt(template: PromptTemplate, variables: Record<string, string>): RenderResult;
+/** Content hash over the canonical template JSON — version identity. */
+declare function hashTemplate(template: PromptTemplate): string;
+
+export { ModelParams, Prompt, PromptId, PromptMessage, PromptTemplate, PromptVersion, type RenderResult, hashTemplate, renderPrompt, templateVariables };

package/dist/index.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { sha256Hex, canonicalJson } from '@fabricorg/experiments-datasets';
+
+// src/schema.ts
+var PromptId = z.string().min(2).max(64).regex(/^[a-z][a-z0-9-]*$/, "lowercase kebab-case, must start with a letter");
+var PromptMessage = z.object({
+  role: z.enum(["system", "user", "assistant"]),
+  /** Template text; {{variable}} placeholders are substituted at render time. */
+  content: z.string().min(1).max(1e5)
+});
+var ModelParams = z.object({
+  /** Model Serving endpoint or model name; resolution happens in the control plane. */
+  model: z.string().max(256).optional(),
+  temperature: z.number().min(0).max(2).optional(),
+  maxTokens: z.number().int().min(1).max(2e5).optional(),
+  topP: z.number().min(0).max(1).optional()
+});
+var PromptTemplate = z.object({
+  messages: z.array(PromptMessage).min(1).max(50),
+  params: ModelParams.default({})
+});
+var Prompt = z.object({
+  tenantId: z.string().min(1),
+  id: PromptId,
+  name: z.string().min(1).max(120),
+  description: z.string().max(2e3).optional(),
+  latestVersion: z.number().int().min(0),
+  createdAtIso: z.string().datetime(),
+  updatedAtIso: z.string().datetime()
+});
+var PromptVersion = z.object({
+  promptId: PromptId,
+  version: z.number().int().min(1),
+  template: PromptTemplate,
+  contentHash: z.string().regex(/^[a-f0-9]{64}$/),
+  createdAtIso: z.string().datetime(),
+  note: z.string().max(500).optional()
+});
+var VARIABLE_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
+function templateVariables(template) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of template.messages) {
+    for (const match of m.content.matchAll(VARIABLE_RE)) {
+      const name = match[1];
+      if (!seen.has(name)) {
+        seen.add(name);
+        out.push(name);
+      }
+    }
+  }
+  return out;
+}
+function renderPrompt(template, variables) {
+  const missing = templateVariables(template).filter((v) => !(v in variables));
+  const messages = template.messages.map((m) => ({
+    role: m.role,
+    content: m.content.replace(VARIABLE_RE, (_, name) => variables[name] ?? "")
+  }));
+  return { messages, missing };
+}
+function hashTemplate(template) {
+  return sha256Hex(canonicalJson(template));
+}
+
+export { ModelParams, Prompt, PromptId, PromptMessage, PromptTemplate, PromptVersion, hashTemplate, renderPrompt, templateVariables };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/render.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const PromptId = z\n  .string()\n  .min(2)\n  .max(64)\n  .regex(/^[a-z][a-z0-9-]*$/, 'lowercase kebab-case, must start with a letter');\nexport type PromptId = z.infer<typeof PromptId>;\n\nexport const PromptMessage = z.object({\n  role: z.enum(['system', 'user', 'assistant']),\n  /** Template text; {{variable}} placeholders are substituted at render time. */\n  content: z.string().min(1).max(100000),\n});\nexport type PromptMessage = z.infer<typeof PromptMessage>;\n\nexport const ModelParams = z.object({\n  /** Model Serving endpoint or model name; resolution happens in the control plane. */\n  model: z.string().max(256).optional(),\n  temperature: z.number().min(0).max(2).optional(),\n  maxTokens: z.number().int().min(1).max(200000).optional(),\n  topP: z.number().min(0).max(1).optional(),\n});\nexport type ModelParams = z.infer<typeof ModelParams>;\n\n/** The versionable content of a prompt — what the content hash covers. */\nexport const PromptTemplate = z.object({\n  messages: z.array(PromptMessage).min(1).max(50),\n  params: ModelParams.default({}),\n});\nexport type PromptTemplate = z.infer<typeof PromptTemplate>;\n\nexport const Prompt = z.object({\n  tenantId: z.string().min(1),\n  id: PromptId,\n  name: z.string().min(1).max(120),\n  description: z.string().max(2000).optional(),\n  latestVersion: z.number().int().min(0),\n  createdAtIso: z.string().datetime(),\n  updatedAtIso: z.string().datetime(),\n});\nexport type Prompt = z.infer<typeof Prompt>;\n\n/**\n * Immutable prompt version. Content-addressed like dataset versions and the\n * edge manifest: identical templates always yield identical hashes, so a\n * judge's provenance promptHash can be traced back to a registry version.\n */\nexport const PromptVersion = z.object({\n  promptId: PromptId,\n  version: z.number().int().min(1),\n  template: PromptTemplate,\n  contentHash: z.string().regex(/^[a-f0-9]{64}$/),\n  createdAtIso: z.string().datetime(),\n  note: z.string().max(500).optional(),\n});\nexport type PromptVersion = z.infer<typeof PromptVersion>;\n","import { canonicalJson, sha256Hex } from '@fabricorg/experiments-datasets';\nimport type { PromptMessage, PromptTemplate } from './schema.js';\n\n/** {{variable}} — same placeholder syntax as the evals judge templates. */\nconst VARIABLE_RE = /\\{\\{\\s*([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\}\\}/g;\n\n/** Distinct variable names referenced by a template, in first-appearance order. */\nexport function templateVariables(template: PromptTemplate): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const m of template.messages) {\n    for (const match of m.content.matchAll(VARIABLE_RE)) {\n      const name = match[1]!;\n      if (!seen.has(name)) {\n        seen.add(name);\n        out.push(name);\n      }\n    }\n  }\n  return out;\n}\n\nexport interface RenderResult {\n  messages: PromptMessage[];\n  /** Variables referenced by the template but absent from the input. */\n  missing: string[];\n}\n\n/**\n * Substitute variables into every message. Missing variables render as empty\n * strings and are reported — the playground surfaces them as a warning\n * rather than refusing to run (matching judge-template render semantics).\n */\nexport function renderPrompt(\n  template: PromptTemplate,\n  variables: Record<string, string>,\n): RenderResult {\n  const missing = templateVariables(template).filter((v) => !(v in variables));\n  const messages = template.messages.map((m) => ({\n    role: m.role,\n    content: m.content.replace(VARIABLE_RE, (_, name: string) => variables[name] ?? ''),\n  }));\n  return { messages, missing };\n}\n\n/** Content hash over the canonical template JSON — version identity. */\nexport function hashTemplate(template: PromptTemplate): string {\n  return sha256Hex(canonicalJson(template));\n}\n"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@fabricorg/experiments-prompts",
+  "version": "0.1.0",
+  "description": "Versioned prompt registry domain for Fabric Experiments: chat templates, variable rendering, content-hashed versions.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@fabricorg/experiments-datasets": "^0.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.7"
+  }
+}