@kortyx/prompts 0.0.0-stage → 0.2.0

package/dist/browser.js

@@ -0,0 +1,491 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser.ts
+var browser_exports = {};
+__export(browser_exports, {
+  PROMPT_PROTOCOL_VERSION: () => PROMPT_PROTOCOL_VERSION,
+  PromptContentSchema: () => PromptContentSchema,
+  PromptError: () => PromptError,
+  PromptKeySchema: () => PromptKeySchema,
+  PromptMessageSchema: () => PromptMessageSchema,
+  PromptSnapshotSchema: () => PromptSnapshotSchema,
+  PromptTagSchema: () => PromptTagSchema,
+  PromptVersionSchema: () => PromptVersionSchema,
+  canonicalPromptJson: () => canonicalPromptJson,
+  compilePrompt: () => compilePrompt,
+  definePrompt: () => definePrompt,
+  expandPromptMessages: () => expandPromptMessages,
+  isCompiledPrompt: () => isCompiledPrompt,
+  isPromptUsageMetadata: () => isPromptUsageMetadata,
+  promptHash: () => promptHash,
+  promptReferencePattern: () => promptReferencePattern,
+  promptReferenceToken: () => promptReferenceToken,
+  promptReferences: () => promptReferences,
+  promptUsageMetadata: () => promptUsageMetadata,
+  promptVariables: () => promptVariables,
+  validatePromptContent: () => validatePromptContent,
+  validatePromptValue: () => validatePromptValue,
+  verifyPromptSnapshot: () => verifyPromptSnapshot
+});
+module.exports = __toCommonJS(browser_exports);
+
+// src/compiler.ts
+var import__ = __toESM(require("ajv/dist/2020"));
+
+// src/contracts.ts
+var import_zod = require("zod");
+var PROMPT_PROTOCOL_VERSION = 1;
+var PromptKeySchema = import_zod.z.string().min(1).max(200).regex(/^[a-zA-Z0-9][a-zA-Z0-9_./-]*$/);
+var PromptTagSchema = import_zod.z.string().trim().min(1).max(64).regex(/^[a-z0-9][a-z0-9_-]*$/);
+var PromptMessageSchema = import_zod.z.object({
+  role: import_zod.z.enum(["system", "user", "assistant"]),
+  content: import_zod.z.string().max(2e5)
+}).strict();
+var PromptContentSchema = import_zod.z.object({
+  format: import_zod.z.enum(["system-user", "chat"]),
+  messages: import_zod.z.array(PromptMessageSchema).min(1).max(100),
+  variablesSchema: import_zod.z.record(import_zod.z.string(), import_zod.z.json()),
+  configSchema: import_zod.z.record(import_zod.z.string(), import_zod.z.json()),
+  config: import_zod.z.record(import_zod.z.string(), import_zod.z.json()),
+  dependencies: import_zod.z.array(
+    import_zod.z.object({
+      id: PromptKeySchema,
+      version: import_zod.z.number().int().positive(),
+      hash: import_zod.z.string().regex(/^[a-f0-9]{64}$/)
+    }).strict()
+  ).max(100).default([])
+}).strict().superRefine((value, ctx) => {
+  if (value.format === "system-user" && (value.messages.length !== 2 || value.messages[0]?.role !== "system" || value.messages[1]?.role !== "user"))
+    ctx.addIssue({
+      code: "custom",
+      message: "system-user requires exactly one system message followed by one user message.",
+      path: ["messages"]
+    });
+});
+var PromptVersionSchema = import_zod.z.object({
+  id: PromptKeySchema,
+  version: import_zod.z.number().int().positive(),
+  hash: import_zod.z.string().regex(/^[a-f0-9]{64}$/),
+  content: PromptContentSchema
+});
+var PromptSnapshotSchema = import_zod.z.object({
+  schemaVersion: import_zod.z.literal(PROMPT_PROTOCOL_VERSION),
+  environment: import_zod.z.string().min(1).max(128),
+  tag: PromptTagSchema.optional(),
+  revision: import_zod.z.string().min(1),
+  versions: import_zod.z.record(import_zod.z.string(), PromptVersionSchema),
+  source: import_zod.z.enum(["studio", "local", "cache", "fallback", "eval"]),
+  resolvedAt: import_zod.z.iso.datetime(),
+  requestedIds: import_zod.z.array(PromptKeySchema).max(100).optional()
+}).strict();
+var PromptError = class extends Error {
+  constructor(code, message, status = 400) {
+    super(message);
+    this.code = code;
+    this.status = status;
+  }
+  code;
+  status;
+  name = "PromptError";
+};
+function canonicalPromptJson(value) {
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value))
+    return `[${value.map(canonicalPromptJson).join(",")}]`;
+  return `{${Object.keys(value).sort().map(
+    (key) => `${JSON.stringify(key)}:${canonicalPromptJson(value[key])}`
+  ).join(",")}}`;
+}
+async function promptHash(content) {
+  const bytes = await crypto.subtle.digest(
+    "SHA-256",
+    new TextEncoder().encode(canonicalPromptJson(content))
+  );
+  return Array.from(
+    new Uint8Array(bytes),
+    (b) => b.toString(16).padStart(2, "0")
+  ).join("");
+}
+async function verifyPromptSnapshot(value) {
+  const parsed = PromptSnapshotSchema.safeParse(value);
+  if (!parsed.success)
+    throw new PromptError(
+      "PROMPT_SNAPSHOT_INVALID",
+      "The prompt snapshot does not match the serving contract."
+    );
+  const snapshot = parsed.data;
+  if (Object.keys(snapshot.versions).length > 200)
+    throw new PromptError(
+      "PROMPT_SNAPSHOT_LIMIT",
+      "A snapshot supports at most 200 versions."
+    );
+  for (const [key, version] of Object.entries(snapshot.versions)) {
+    if (key !== version.id || await promptHash(version.content) !== version.hash)
+      throw new PromptError(
+        "PROMPT_HASH_MISMATCH",
+        `Prompt ${key} did not match its immutable hash.`
+      );
+    for (const dependency of version.content.dependencies) {
+      const actual = snapshot.versions[dependency.id];
+      if (!actual || actual.version !== dependency.version || actual.hash !== dependency.hash)
+        throw new PromptError(
+          "PROMPT_DEPENDENCY_MISMATCH",
+          `Missing exact dependency ${dependency.id}@${dependency.version}.`
+        );
+    }
+  }
+  const visit = (key, active, done2) => {
+    if (active.has(key))
+      throw new PromptError(
+        "PROMPT_DEPENDENCY_CYCLE",
+        `Prompt dependency cycle at ${key}.`
+      );
+    if (done2.has(key)) return;
+    active.add(key);
+    for (const dep of snapshot.versions[key]?.content.dependencies ?? [])
+      visit(dep.id, active, done2);
+    active.delete(key);
+    done2.add(key);
+  };
+  const done = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(snapshot.versions)) visit(key, /* @__PURE__ */ new Set(), done);
+  const freeze = (value2) => {
+    if (value2 && typeof value2 === "object" && !Object.isFrozen(value2)) {
+      for (const nested of Object.values(value2)) freeze(nested);
+      Object.freeze(value2);
+    }
+  };
+  freeze(snapshot);
+  return snapshot;
+}
+
+// src/references.ts
+var promptReferencePattern = /\[\[prompt:([a-zA-Z0-9][a-zA-Z0-9_./-]*)\]\]/g;
+function promptReferenceToken(id) {
+  return `[[prompt:${id}]]`;
+}
+function promptReferences(content) {
+  return [
+    ...new Set(
+      content.messages.flatMap(
+        (message) => [...message.content.matchAll(promptReferencePattern)].map(
+          (match) => match[1]
+        )
+      )
+    )
+  ];
+}
+function expandPromptMessages(root, versions = {}) {
+  const used = /* @__PURE__ */ new Map();
+  const cache = /* @__PURE__ */ new Map();
+  const expand = (owner, text, role, active) => {
+    const parts = [];
+    let size = 0, position = 0;
+    const append = (part) => {
+      size += part.length;
+      if (size > 2e5)
+        throw new PromptError(
+          "PROMPT_REFERENCE_LIMIT",
+          "An expanded message cannot exceed 200,000 characters."
+        );
+      parts.push(part);
+    };
+    for (const match of text.matchAll(promptReferencePattern)) {
+      append(text.slice(position, match.index));
+      position = match.index + match[0].length;
+      const id = match[1];
+      const dependency = owner.content.dependencies.find(
+        (item) => item.id === id
+      );
+      const child = versions[id];
+      if (!dependency || !child || child.version !== dependency.version || child.hash !== dependency.hash)
+        throw new PromptError(
+          "PROMPT_REFERENCE_MISSING",
+          `Include an exact dependency for referenced prompt ${id}.`
+        );
+      if (active.has(id) || active.size >= 200)
+        throw new PromptError(
+          "PROMPT_DEPENDENCY_CYCLE",
+          `Prompt reference cycle at ${id}.`
+        );
+      const messages = child.content.messages.filter(
+        (message) => message.role === role
+      );
+      if (!messages.length)
+        throw new PromptError(
+          "PROMPT_REFERENCE_ROLE",
+          `${id} has no ${role} message to include.`
+        );
+      used.set(id, child);
+      const cacheKey = `${id}@${child.version}:${role}`;
+      let included = cache.get(cacheKey);
+      if (included === void 0) {
+        const next = new Set(active).add(id);
+        const chunks = [];
+        let length = 0;
+        for (const message of messages) {
+          const chunk = expand(child, message.content, role, next);
+          length += chunk.length + (chunks.length ? 2 : 0);
+          if (length > 2e5)
+            throw new PromptError(
+              "PROMPT_REFERENCE_LIMIT",
+              "An expanded message cannot exceed 200,000 characters."
+            );
+          chunks.push(chunk);
+        }
+        included = chunks.join("\n\n");
+        cache.set(cacheKey, included);
+      }
+      append(included);
+    }
+    append(text.slice(position));
+    return parts.join("");
+  };
+  return {
+    messages: root.content.messages.map((message) => ({
+      ...message,
+      content: expand(root, message.content, message.role, /* @__PURE__ */ new Set([root.id]))
+    })),
+    used: [...used.values()]
+  };
+}
+
+// src/compiler.ts
+var ajv = new import__.default({
+  strict: false,
+  allErrors: true,
+  validateFormats: false,
+  ownProperties: true
+});
+var validators = /* @__PURE__ */ new Map();
+var compiledPrompts = /* @__PURE__ */ new WeakSet();
+var usageMetadata = /* @__PURE__ */ new WeakSet();
+function isCompiledPrompt(value) {
+  return Boolean(
+    value && typeof value === "object" && compiledPrompts.has(value)
+  );
+}
+function promptUsageMetadata(prompt) {
+  if (!isCompiledPrompt(prompt))
+    throw new PromptError(
+      "PROMPT_REASON_INVALID",
+      "Use a compiled prompt returned by usePrompt."
+    );
+  const metadata = Object.freeze({
+    id: prompt.ref.id,
+    version: prompt.ref.version,
+    hash: prompt.ref.hash,
+    environment: prompt.ref.environment,
+    snapshotRevision: prompt.ref.snapshotRevision,
+    ...prompt.dependencies?.length ? { dependencies: prompt.dependencies } : {}
+  });
+  usageMetadata.add(metadata);
+  return metadata;
+}
+function isPromptUsageMetadata(value) {
+  return Boolean(
+    value && typeof value === "object" && usageMetadata.has(value)
+  );
+}
+function freezeValue(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value && typeof value === "object" && !seen.has(value)) {
+    seen.add(value);
+    for (const item of Object.values(value)) freezeValue(item, seen);
+    Object.freeze(value);
+  }
+  return value;
+}
+function validatePromptValue(schema, value, label) {
+  const key = canonicalPromptJson(schema);
+  let validator = validators.get(key);
+  if (!validator) {
+    if (validators.size >= 256) validators.clear();
+    try {
+      validator = ajv.compile(schema);
+    } catch {
+      throw new PromptError(
+        "PROMPT_SCHEMA_INVALID",
+        `${label} schema is invalid.`
+      );
+    }
+    validators.set(key, validator);
+  }
+  if (!validator(value))
+    throw new PromptError(
+      "PROMPT_CONTRACT_MISMATCH",
+      `${label}: ${ajv.errorsText(validator.errors)}.`
+    );
+}
+var placeholder = /\{\{\s*([A-Za-z_][A-Za-z0-9_.]*)\s*\}\}/g;
+function promptVariables(content) {
+  return [
+    ...new Set(
+      content.messages.flatMap(
+        (message) => [...message.content.matchAll(placeholder)].map(
+          (match) => match[1]
+        )
+      )
+    )
+  ];
+}
+function validatePromptContent(content) {
+  validatePromptValue(content.configSchema, content.config, "Configuration");
+  try {
+    ajv.compile(content.variablesSchema);
+  } catch {
+    throw new PromptError(
+      "PROMPT_SCHEMA_INVALID",
+      "Template input schema is invalid."
+    );
+  }
+  const inputs = content.variablesSchema.properties;
+  for (const variable of promptVariables(content)) {
+    const top = variable.split(".")[0];
+    if (!inputs || !Object.hasOwn(inputs, top))
+      throw new PromptError(
+        "PROMPT_VARIABLE_UNKNOWN",
+        `Declare template input ${top} in the input schema.`
+      );
+    if (Object.hasOwn(content.config, top))
+      throw new PromptError(
+        "PROMPT_VARIABLE_CONFIG_OVERLAP",
+        `${top} cannot be both a template input and saved configuration.`
+      );
+  }
+}
+function definePrompt(reference) {
+  if (!reference.id || !reference.variables || !reference.config)
+    throw new PromptError(
+      "PROMPT_REFERENCE_INVALID",
+      "A prompt reference needs id, variables and config schemas."
+    );
+  return Object.freeze({ ...reference });
+}
+function compilePrompt(ref, version, variables, identity, versions) {
+  if (version.id !== ref.id || version.content.format !== ref.format)
+    throw new PromptError(
+      "PROMPT_CONTRACT_MISMATCH",
+      `Prompt ${ref.id} format or identity differs from the application contract.`
+    );
+  const values = ref.variables.parse(variables);
+  validatePromptValue(
+    version.content.variablesSchema,
+    values,
+    "Template inputs"
+  );
+  validatePromptValue(
+    version.content.configSchema,
+    version.content.config,
+    "Configuration"
+  );
+  const config = ref.config.parse(structuredClone(version.content.config));
+  const expanded = expandPromptMessages(version, versions);
+  if (expanded.used.length)
+    validatePromptContent({ ...version.content, messages: expanded.messages });
+  for (const child of expanded.used) {
+    const properties = child.content.variablesSchema.properties;
+    const childValues = properties && typeof properties === "object" && !Array.isArray(properties) ? Object.fromEntries(
+      Object.keys(properties).filter((key) => Object.hasOwn(values, key)).map((key) => [key, values[key]])
+    ) : values;
+    validatePromptValue(
+      child.content.variablesSchema,
+      childValues,
+      `Inputs for ${child.id}`
+    );
+  }
+  const messages = expanded.messages.map((message) => ({
+    role: message.role,
+    content: message.content.replace(placeholder, (_, path) => {
+      let value = values;
+      for (const key of path.split(".")) {
+        if (["__proto__", "constructor", "prototype"].includes(key) || !value || typeof value !== "object" || !Object.hasOwn(value, key))
+          throw new PromptError(
+            "PROMPT_VARIABLE_MISSING",
+            `Missing template input ${path}.`
+          );
+        value = value[key];
+      }
+      if (value === void 0)
+        throw new PromptError(
+          "PROMPT_VARIABLE_MISSING",
+          `Missing template input ${path}.`
+        );
+      return typeof value === "string" ? value : canonicalPromptJson(value);
+    })
+  }));
+  const compiled = freezeValue({
+    format: ref.format,
+    messages,
+    config,
+    ...expanded.used.length ? {
+      dependencies: expanded.used.map(({ id, version: version2, hash }) => ({
+        id,
+        version: version2,
+        hash
+      }))
+    } : {},
+    ...ref.format === "system-user" ? { system: messages[0]?.content, user: messages[1]?.content } : {},
+    ref: {
+      id: ref.id,
+      version: version.version,
+      hash: version.hash,
+      ...identity
+    }
+  });
+  compiledPrompts.add(compiled);
+  return compiled;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROMPT_PROTOCOL_VERSION,
+  PromptContentSchema,
+  PromptError,
+  PromptKeySchema,
+  PromptMessageSchema,
+  PromptSnapshotSchema,
+  PromptTagSchema,
+  PromptVersionSchema,
+  canonicalPromptJson,
+  compilePrompt,
+  definePrompt,
+  expandPromptMessages,
+  isCompiledPrompt,
+  isPromptUsageMetadata,
+  promptHash,
+  promptReferencePattern,
+  promptReferenceToken,
+  promptReferences,
+  promptUsageMetadata,
+  promptVariables,
+  validatePromptContent,
+  validatePromptValue,
+  verifyPromptSnapshot
+});
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser.ts","../src/compiler.ts","../src/contracts.ts","../src/references.ts"],"sourcesContent":["// Schemas, hashing and compilation have no Node integration or network side effects.\nexport * from \"./compiler\";\nexport * from \"./contracts\";\nexport * from \"./references\";\n","import Ajv2020 from \"ajv/dist/2020\";\nimport type { z } from \"zod\";\nimport {\n  canonicalPromptJson,\n  type PromptContent,\n  PromptError,\n  type PromptVersion,\n} from \"./contracts\";\nimport { expandPromptMessages } from \"./references\";\n\nconst ajv = new Ajv2020({\n  strict: false,\n  allErrors: true,\n  validateFormats: false,\n  ownProperties: true,\n});\nconst validators = new Map<string, ReturnType<typeof ajv.compile>>();\nconst compiledPrompts = new WeakSet<object>();\nconst usageMetadata = new WeakSet<object>();\nexport function isCompiledPrompt(value: unknown): value is CompiledPrompt {\n  return Boolean(\n    value && typeof value === \"object\" && compiledPrompts.has(value),\n  );\n}\nexport function promptUsageMetadata(\n  prompt: CompiledPrompt,\n): Record<string, unknown> {\n  if (!isCompiledPrompt(prompt))\n    throw new PromptError(\n      \"PROMPT_REASON_INVALID\",\n      \"Use a compiled prompt returned by usePrompt.\",\n    );\n  const metadata = Object.freeze({\n    id: prompt.ref.id,\n    version: prompt.ref.version,\n    hash: prompt.ref.hash,\n    environment: prompt.ref.environment,\n    snapshotRevision: prompt.ref.snapshotRevision,\n    ...(prompt.dependencies?.length\n      ? { dependencies: prompt.dependencies }\n      : {}),\n  });\n  usageMetadata.add(metadata);\n  return metadata;\n}\nexport function isPromptUsageMetadata(value: unknown): value is {\n  id: string;\n  version: number;\n  hash: string;\n  environment: string;\n  snapshotRevision: string;\n  dependencies?: { id: string; version: number; hash: string }[];\n} {\n  return Boolean(\n    value && typeof value === \"object\" && usageMetadata.has(value),\n  );\n}\nfunction freezeValue<T>(value: T, seen = new WeakSet<object>()): T {\n  if (value && typeof value === \"object\" && !seen.has(value)) {\n    seen.add(value);\n    for (const item of Object.values(value)) freezeValue(item, seen);\n    Object.freeze(value);\n  }\n  return value;\n}\nexport function validatePromptValue(\n  schema: Record<string, unknown>,\n  value: unknown,\n  label: string,\n): void {\n  const key = canonicalPromptJson(schema);\n  let validator = validators.get(key);\n  if (!validator) {\n    if (validators.size >= 256) validators.clear();\n    try {\n      validator = ajv.compile(schema);\n    } catch {\n      throw new PromptError(\n        \"PROMPT_SCHEMA_INVALID\",\n        `${label} schema is invalid.`,\n      );\n    }\n    validators.set(key, validator);\n  }\n  if (!validator(value))\n    throw new PromptError(\n      \"PROMPT_CONTRACT_MISMATCH\",\n      `${label}: ${ajv.errorsText(validator.errors)}.`,\n    );\n}\nconst placeholder = /\\{\\{\\s*([A-Za-z_][A-Za-z0-9_.]*)\\s*\\}\\}/g;\nexport function promptVariables(content: PromptContent): string[] {\n  return [\n    ...new Set(\n      content.messages.flatMap((message) =>\n        [...message.content.matchAll(placeholder)].map(\n          (match) => match[1] as string,\n        ),\n      ),\n    ),\n  ];\n}\nexport function validatePromptContent(content: PromptContent): void {\n  validatePromptValue(content.configSchema, content.config, \"Configuration\");\n  // Compile both contracts before storing an executable version.\n  try {\n    ajv.compile(content.variablesSchema);\n  } catch {\n    throw new PromptError(\n      \"PROMPT_SCHEMA_INVALID\",\n      \"Template input schema is invalid.\",\n    );\n  }\n  const inputs = content.variablesSchema.properties as\n    | Record<string, unknown>\n    | undefined;\n  for (const variable of promptVariables(content)) {\n    const top = variable.split(\".\")[0] as string;\n    if (!inputs || !Object.hasOwn(inputs, top))\n      throw new PromptError(\n        \"PROMPT_VARIABLE_UNKNOWN\",\n        `Declare template input ${top} in the input schema.`,\n      );\n    if (Object.hasOwn(content.config, top))\n      throw new PromptError(\n        \"PROMPT_VARIABLE_CONFIG_OVERLAP\",\n        `${top} cannot be both a template input and saved configuration.`,\n      );\n  }\n}\nexport type PromptRef<\n  Inputs = unknown,\n  Config = unknown,\n  Format extends \"system-user\" | \"chat\" = \"system-user\" | \"chat\",\n> = Readonly<{\n  id: string;\n  format: Format;\n  variables: z.ZodType<Inputs>;\n  config: z.ZodType<Config>;\n}>;\nexport function definePrompt<\n  Inputs,\n  Config,\n  Format extends \"system-user\" | \"chat\",\n>(\n  reference: PromptRef<Inputs, Config, Format>,\n): PromptRef<Inputs, Config, Format> {\n  if (!reference.id || !reference.variables || !reference.config)\n    throw new PromptError(\n      \"PROMPT_REFERENCE_INVALID\",\n      \"A prompt reference needs id, variables and config schemas.\",\n    );\n  return Object.freeze({ ...reference });\n}\nexport type CompiledPrompt<Config = unknown> = Readonly<{\n  format: \"system-user\" | \"chat\";\n  system?: string | undefined;\n  user?: string | undefined;\n  messages: { role: \"system\" | \"user\" | \"assistant\"; content: string }[];\n  config: Config;\n  dependencies?: { id: string; version: number; hash: string }[];\n  ref: {\n    id: string;\n    version: number;\n    hash: string;\n    source: string;\n    environment: string;\n    snapshotRevision: string;\n  };\n}>;\nexport function compilePrompt<Inputs, Config>(\n  ref: PromptRef<Inputs, Config>,\n  version: PromptVersion,\n  variables: Inputs,\n  identity: { source: string; environment: string; snapshotRevision: string },\n  versions?: Readonly<Record<string, PromptVersion>>,\n): CompiledPrompt<Config> {\n  if (version.id !== ref.id || version.content.format !== ref.format)\n    throw new PromptError(\n      \"PROMPT_CONTRACT_MISMATCH\",\n      `Prompt ${ref.id} format or identity differs from the application contract.`,\n    );\n  const values = ref.variables.parse(variables);\n  validatePromptValue(\n    version.content.variablesSchema,\n    values,\n    \"Template inputs\",\n  );\n  validatePromptValue(\n    version.content.configSchema,\n    version.content.config,\n    \"Configuration\",\n  );\n  const config = ref.config.parse(structuredClone(version.content.config));\n  const expanded = expandPromptMessages(version, versions);\n  if (expanded.used.length)\n    validatePromptContent({ ...version.content, messages: expanded.messages });\n  for (const child of expanded.used) {\n    const properties = child.content.variablesSchema.properties;\n    const childValues =\n      properties && typeof properties === \"object\" && !Array.isArray(properties)\n        ? Object.fromEntries(\n            Object.keys(properties)\n              .filter((key) => Object.hasOwn(values as object, key))\n              .map((key) => [key, (values as Record<string, unknown>)[key]]),\n          )\n        : values;\n    validatePromptValue(\n      child.content.variablesSchema,\n      childValues,\n      `Inputs for ${child.id}`,\n    );\n  }\n  const messages = expanded.messages.map((message) => ({\n    role: message.role,\n    content: message.content.replace(placeholder, (_, path: string) => {\n      let value: unknown = values;\n      for (const key of path.split(\".\")) {\n        if (\n          [\"__proto__\", \"constructor\", \"prototype\"].includes(key) ||\n          !value ||\n          typeof value !== \"object\" ||\n          !Object.hasOwn(value, key)\n        )\n          throw new PromptError(\n            \"PROMPT_VARIABLE_MISSING\",\n            `Missing template input ${path}.`,\n          );\n        value = (value as Record<string, unknown>)[key];\n      }\n      if (value === undefined)\n        throw new PromptError(\n          \"PROMPT_VARIABLE_MISSING\",\n          `Missing template input ${path}.`,\n        );\n      return typeof value === \"string\" ? value : canonicalPromptJson(value);\n    }),\n  }));\n  const compiled = freezeValue({\n    format: ref.format,\n    messages,\n    config,\n    ...(expanded.used.length\n      ? {\n          dependencies: expanded.used.map(({ id, version, hash }) => ({\n            id,\n            version,\n            hash,\n          })),\n        }\n      : {}),\n    ...(ref.format === \"system-user\"\n      ? { system: messages[0]?.content, user: messages[1]?.content }\n      : {}),\n    ref: {\n      id: ref.id,\n      version: version.version,\n      hash: version.hash,\n      ...identity,\n    },\n  });\n  compiledPrompts.add(compiled);\n  return compiled;\n}\n","import { z } from \"zod\";\n\nexport const PROMPT_PROTOCOL_VERSION = 1 as const;\nexport const PromptKeySchema = z\n  .string()\n  .min(1)\n  .max(200)\n  .regex(/^[a-zA-Z0-9][a-zA-Z0-9_./-]*$/);\nexport const PromptTagSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .max(64)\n  .regex(/^[a-z0-9][a-z0-9_-]*$/);\nexport const PromptMessageSchema = z\n  .object({\n    role: z.enum([\"system\", \"user\", \"assistant\"]),\n    content: z.string().max(200_000),\n  })\n  .strict();\nexport const PromptContentSchema = z\n  .object({\n    format: z.enum([\"system-user\", \"chat\"]),\n    messages: z.array(PromptMessageSchema).min(1).max(100),\n    variablesSchema: z.record(z.string(), z.json()),\n    configSchema: z.record(z.string(), z.json()),\n    config: z.record(z.string(), z.json()),\n    dependencies: z\n      .array(\n        z\n          .object({\n            id: PromptKeySchema,\n            version: z.number().int().positive(),\n            hash: z.string().regex(/^[a-f0-9]{64}$/),\n          })\n          .strict(),\n      )\n      .max(100)\n      .default([]),\n  })\n  .strict()\n  .superRefine((value, ctx) => {\n    if (\n      value.format === \"system-user\" &&\n      (value.messages.length !== 2 ||\n        value.messages[0]?.role !== \"system\" ||\n        value.messages[1]?.role !== \"user\")\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message:\n          \"system-user requires exactly one system message followed by one user message.\",\n        path: [\"messages\"],\n      });\n  });\nexport const PromptVersionSchema = z.object({\n  id: PromptKeySchema,\n  version: z.number().int().positive(),\n  hash: z.string().regex(/^[a-f0-9]{64}$/),\n  content: PromptContentSchema,\n});\nexport const PromptSnapshotSchema = z\n  .object({\n    schemaVersion: z.literal(PROMPT_PROTOCOL_VERSION),\n    environment: z.string().min(1).max(128),\n    tag: PromptTagSchema.optional(),\n    revision: z.string().min(1),\n    versions: z.record(z.string(), PromptVersionSchema),\n    source: z.enum([\"studio\", \"local\", \"cache\", \"fallback\", \"eval\"]),\n    resolvedAt: z.iso.datetime(),\n    requestedIds: z.array(PromptKeySchema).max(100).optional(),\n  })\n  .strict();\nexport type PromptContent = z.infer<typeof PromptContentSchema>;\nexport type PromptVersion = z.infer<typeof PromptVersionSchema>;\nexport type PromptSnapshot = z.infer<typeof PromptSnapshotSchema>;\n\nexport class PromptError extends Error {\n  override name = \"PromptError\";\n  constructor(\n    readonly code: string,\n    message: string,\n    readonly status = 400,\n  ) {\n    super(message);\n  }\n}\n\n/** The executable hash excludes mutable names, categories, authors and notes. */\nexport function canonicalPromptJson(value: unknown): string {\n  if (value === null || typeof value !== \"object\") return JSON.stringify(value);\n  if (Array.isArray(value))\n    return `[${value.map(canonicalPromptJson).join(\",\")}]`;\n  return `{${Object.keys(value)\n    .sort()\n    .map(\n      (key) =>\n        `${JSON.stringify(key)}:${canonicalPromptJson((value as Record<string, unknown>)[key])}`,\n    )\n    .join(\",\")}}`;\n}\nexport async function promptHash(content: PromptContent): Promise<string> {\n  const bytes = await crypto.subtle.digest(\n    \"SHA-256\",\n    new TextEncoder().encode(canonicalPromptJson(content)),\n  );\n  return Array.from(new Uint8Array(bytes), (b) =>\n    b.toString(16).padStart(2, \"0\"),\n  ).join(\"\");\n}\n\nexport async function verifyPromptSnapshot(\n  value: unknown,\n): Promise<PromptSnapshot> {\n  const parsed = PromptSnapshotSchema.safeParse(value);\n  if (!parsed.success)\n    throw new PromptError(\n      \"PROMPT_SNAPSHOT_INVALID\",\n      \"The prompt snapshot does not match the serving contract.\",\n    );\n  const snapshot = parsed.data;\n  if (Object.keys(snapshot.versions).length > 200)\n    throw new PromptError(\n      \"PROMPT_SNAPSHOT_LIMIT\",\n      \"A snapshot supports at most 200 versions.\",\n    );\n  for (const [key, version] of Object.entries(snapshot.versions)) {\n    if (\n      key !== version.id ||\n      (await promptHash(version.content)) !== version.hash\n    )\n      throw new PromptError(\n        \"PROMPT_HASH_MISMATCH\",\n        `Prompt ${key} did not match its immutable hash.`,\n      );\n    for (const dependency of version.content.dependencies) {\n      const actual = snapshot.versions[dependency.id];\n      if (\n        !actual ||\n        actual.version !== dependency.version ||\n        actual.hash !== dependency.hash\n      )\n        throw new PromptError(\n          \"PROMPT_DEPENDENCY_MISMATCH\",\n          `Missing exact dependency ${dependency.id}@${dependency.version}.`,\n        );\n    }\n  }\n  const visit = (key: string, active: Set<string>, done: Set<string>) => {\n    if (active.has(key))\n      throw new PromptError(\n        \"PROMPT_DEPENDENCY_CYCLE\",\n        `Prompt dependency cycle at ${key}.`,\n      );\n    if (done.has(key)) return;\n    active.add(key);\n    for (const dep of snapshot.versions[key]?.content.dependencies ?? [])\n      visit(dep.id, active, done);\n    active.delete(key);\n    done.add(key);\n  };\n  const done = new Set<string>();\n  for (const key of Object.keys(snapshot.versions)) visit(key, new Set(), done);\n  const freeze = (value: unknown): void => {\n    if (value && typeof value === \"object\" && !Object.isFrozen(value)) {\n      for (const nested of Object.values(value)) freeze(nested);\n      Object.freeze(value);\n    }\n  };\n  freeze(snapshot);\n  return snapshot;\n}\n","import {\n  type PromptContent,\n  PromptError,\n  type PromptVersion,\n} from \"./contracts\";\n\n// Display names are editable; persisted references use stable keys and exact\n// versions/hashes in the existing dependency manifest.\nexport const promptReferencePattern =\n  /\\[\\[prompt:([a-zA-Z0-9][a-zA-Z0-9_./-]*)\\]\\]/g;\nexport function promptReferenceToken(id: string) {\n  return `[[prompt:${id}]]`;\n}\nexport function promptReferences(content: PromptContent): string[] {\n  return [\n    ...new Set(\n      content.messages.flatMap((message) =>\n        [...message.content.matchAll(promptReferencePattern)].map(\n          (match) => match[1]!,\n        ),\n      ),\n    ),\n  ];\n}\nexport function expandPromptMessages(\n  root: PromptVersion,\n  versions: Readonly<Record<string, PromptVersion>> = {},\n): { messages: PromptContent[\"messages\"]; used: PromptVersion[] } {\n  const used = new Map<string, PromptVersion>();\n  const cache = new Map<string, string>();\n  const expand = (\n    owner: PromptVersion,\n    text: string,\n    role: PromptContent[\"messages\"][number][\"role\"],\n    active: Set<string>,\n  ): string => {\n    const parts: string[] = [];\n    let size = 0,\n      position = 0;\n    const append = (part: string) => {\n      size += part.length;\n      if (size > 200_000)\n        throw new PromptError(\n          \"PROMPT_REFERENCE_LIMIT\",\n          \"An expanded message cannot exceed 200,000 characters.\",\n        );\n      parts.push(part);\n    };\n    for (const match of text.matchAll(promptReferencePattern)) {\n      append(text.slice(position, match.index));\n      position = match.index! + match[0].length;\n      const id = match[1]!;\n      const dependency = owner.content.dependencies.find(\n        (item) => item.id === id,\n      );\n      const child = versions[id];\n      if (\n        !dependency ||\n        !child ||\n        child.version !== dependency.version ||\n        child.hash !== dependency.hash\n      )\n        throw new PromptError(\n          \"PROMPT_REFERENCE_MISSING\",\n          `Include an exact dependency for referenced prompt ${id}.`,\n        );\n      if (active.has(id) || active.size >= 200)\n        throw new PromptError(\n          \"PROMPT_DEPENDENCY_CYCLE\",\n          `Prompt reference cycle at ${id}.`,\n        );\n      const messages = child.content.messages.filter(\n        (message) => message.role === role,\n      );\n      if (!messages.length)\n        throw new PromptError(\n          \"PROMPT_REFERENCE_ROLE\",\n          `${id} has no ${role} message to include.`,\n        );\n      used.set(id, child);\n      const cacheKey = `${id}@${child.version}:${role}`;\n      let included = cache.get(cacheKey);\n      if (included === undefined) {\n        const next = new Set(active).add(id);\n        const chunks: string[] = [];\n        let length = 0;\n        for (const message of messages) {\n          const chunk = expand(child, message.content, role, next);\n          length += chunk.length + (chunks.length ? 2 : 0);\n          if (length > 200_000)\n            throw new PromptError(\n              \"PROMPT_REFERENCE_LIMIT\",\n              \"An expanded message cannot exceed 200,000 characters.\",\n            );\n          chunks.push(chunk);\n        }\n        included = chunks.join(\"\\n\\n\");\n        cache.set(cacheKey, included);\n      }\n      append(included);\n    }\n    append(text.slice(position));\n    return parts.join(\"\");\n  };\n  return {\n    messages: root.content.messages.map((message) => ({\n      ...message,\n      content: expand(root, message.content, message.role, new Set([root.id])),\n    })),\n    used: [...used.values()],\n  };\n}\n"],"mappings":"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","names":["done","value","Ajv2020","version"]}

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { PromptSnapshot, PromptRef, CompiledPrompt } from './browser.js';
+export { PROMPT_PROTOCOL_VERSION, PromptContent, PromptContentSchema, PromptError, PromptKeySchema, PromptMessageSchema, PromptSnapshotSchema, PromptTagSchema, PromptVersion, PromptVersionSchema, canonicalPromptJson, compilePrompt, definePrompt, expandPromptMessages, isCompiledPrompt, isPromptUsageMetadata, promptHash, promptReferencePattern, promptReferenceToken, promptReferences, promptUsageMetadata, promptVariables, validatePromptContent, validatePromptValue, verifyPromptSnapshot } from './browser.js';
+import 'zod';
+
+interface PromptSource {
+    readonly environment?: string;
+    readonly tag?: string;
+    readonly identity: string;
+    resolve(ids: readonly string[], options: {
+        environment: string;
+        tag?: string;
+        versions?: Record<string, number>;
+        signal?: AbortSignal;
+    }): Promise<PromptSnapshot>;
+}
+interface PromptCache {
+    get(key: string): Promise<PromptSnapshot | undefined>;
+    set(key: string, snapshot: PromptSnapshot): Promise<void>;
+}
+interface PromptExecution {
+    recordUsage(usage: PromptUsageReceipt): void;
+    snapshot(stored?: unknown): Promise<PromptSnapshot>;
+    pin(id: string, version: number, stored?: unknown): Promise<PromptSnapshot>;
+    resolve<Inputs, Config>(ref: PromptRef<Inputs, Config>, options: {
+        variables: Inputs;
+        version?: number;
+        stored?: unknown;
+        pin?: PromptSnapshot;
+    }): Promise<CompiledPrompt<Config>>;
+}
+interface PromptManager {
+    definitions: readonly PromptRef[];
+    start(options?: {
+        snapshot?: PromptSnapshot;
+        signal?: AbortSignal;
+        onUsage?: (usage: PromptUsageReceipt) => void;
+    }): PromptExecution;
+}
+type PromptUsageReceipt = {
+    id: string;
+    version: number;
+    hash: string;
+    environment: string;
+    snapshotRevision: string;
+    model?: string;
+};
+declare function createPrompts(options: {
+    definitions: readonly PromptRef[];
+    source: PromptSource;
+    environment?: string;
+    fallback?: "last-known-good" | "error";
+    maxStaleMs?: number;
+    cache?: PromptCache;
+}): PromptManager;
+declare function studioPromptSource(options: {
+    apiUrl: string;
+    apiKey: string;
+    /** Version tag to serve. Promotion updates live; other tags are managed manually. */
+    tag?: string;
+    environment?: string;
+    projectId?: string;
+    environmentId?: string;
+    timeoutMs?: number;
+    retries?: number;
+    fetch?: typeof fetch;
+}): PromptSource;
+declare function localPromptSource(snapshot: PromptSnapshot): PromptSource;
+
+export { CompiledPrompt, type PromptCache, type PromptExecution, type PromptManager, PromptRef, PromptSnapshot, type PromptSource, type PromptUsageReceipt, createPrompts, localPromptSource, studioPromptSource };