@warlock.js/ai 4.4.0 → 4.5.0

package/esm/prompt/prompt-validate.mjs

@@ -0,0 +1,170 @@
+import { judge } from "../eval/judge-scorer.mjs";
+
+//#region ../@warlock.js/ai/src/prompt/prompt-validate.ts
+/**
+* Placeholder matcher — kept in lock-step with the matcher
+* `renderPlaceholders` uses (`src/system-prompt/render-placeholders.ts`) so the
+* lint sees the same `{{key}}` / `{{a.b}}` / `{{key|default}}` set the renderer
+* substitutes. Global so every occurrence is collected.
+*/
+const PLACEHOLDER_PATTERN = /\{\{\s*([^{}]+?)\s*\}\}/g;
+/** Lower bound below which a prompt is suspiciously terse. */
+const MIN_REASONABLE_LENGTH = 12;
+/** Upper bound above which a prompt is likely bloated / unfocused. */
+const MAX_REASONABLE_LENGTH = 8e3;
+/**
+* Severity rank for most-severe-first ordering. Higher sorts earlier.
+*/
+const SEVERITY_RANK = {
+	error: 2,
+	warn: 1,
+	info: 0
+};
+/**
+* The fixed rubric the LLM-as-judge grades a prompt body against. Surfaced
+* here (not inline) so the static-lint pass and the judge pass document the
+* same quality dimensions.
+*/
+const PROMPT_JUDGE_RUBRIC = [
+	"Grade this SYSTEM PROMPT on a 0..1 scale for overall quality:",
+	"- Clarity: is the intent unambiguous and easy to follow?",
+	"- Role definition: does it clearly state who/what the assistant is?",
+	"- Output-format specificity: does it say how the answer should be shaped?",
+	"- No conflicting instructions: are any directives contradictory?",
+	"Score 1.0 only when all four hold; deduct for each weakness and explain why."
+].join("\n");
+/**
+* Heuristic role-line detector — a prompt that never says "you are …" /
+* "act as …" / "your role is …" typically lacks a persona. Case-insensitive.
+*/
+const ROLE_HINT_PATTERN = /\b(you are|act as|your role is|you're a|you will act)\b/i;
+/**
+* Run the cheap, model-free static lint over a prompt body. Flags:
+* - length out of the reasonable band (too terse / too bloated),
+* - any `{{placeholder}}` that survives (undeclared / unresolved at lint time),
+* - a missing role line.
+*
+* Pure and synchronous — used standalone (no judge model) and merged with the
+* judge findings when a model is available.
+*
+* @param text - The prompt body to lint.
+*/
+function staticLint(text) {
+	const notes = [];
+	const trimmed = text.trim();
+	if (trimmed.length < MIN_REASONABLE_LENGTH) notes.push({
+		severity: "warn",
+		message: `Prompt is very short (${trimmed.length} chars) — it may be too vague to steer the model.`,
+		suggestion: "Add an explicit role and at least one concrete instruction."
+	});
+	if (trimmed.length > MAX_REASONABLE_LENGTH) notes.push({
+		severity: "warn",
+		message: `Prompt is very long (${trimmed.length} chars) — long prompts dilute focus and inflate cost.`,
+		suggestion: "Split into a tighter persona plus a few focused instructions."
+	});
+	const placeholders = collectPlaceholders(text);
+	for (const placeholder of placeholders) notes.push({
+		severity: "info",
+		message: `Unresolved placeholder "{{${placeholder}}}" — confirm it is supplied at resolve time or give it a default ("{{${placeholder}|...}}").`
+	});
+	if (!ROLE_HINT_PATTERN.test(trimmed)) notes.push({
+		severity: "warn",
+		message: "No role line found — the prompt never states who the assistant is.",
+		suggestion: "Open with a role, e.g. \"You are a senior support engineer for …\"."
+	});
+	return notes;
+}
+/**
+* Collect every distinct placeholder PATH (the part before any `|default`)
+* from a template, in first-seen order. Matches `renderPlaceholders`' own
+* parsing so the lint never disagrees with the renderer.
+*/
+function collectPlaceholders(template) {
+	const found = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const match of template.matchAll(PLACEHOLDER_PATTERN)) {
+		const path = match[1].split("|")[0].trim();
+		if (path.length > 0 && !seen.has(path)) {
+			seen.add(path);
+			found.push(path);
+		}
+	}
+	return found;
+}
+/**
+* Stable, most-severe-first ordering: `error` before `warn` before `info`,
+* preserving original order within a severity. Returns a fresh array.
+*/
+function sortNotesBySeverity(notes) {
+	return notes.map((note, index) => ({
+		note,
+		index
+	})).sort((a, b) => {
+		const rankDiff = SEVERITY_RANK[b.note.severity] - SEVERITY_RANK[a.note.severity];
+		return rankDiff !== 0 ? rankDiff : a.index - b.index;
+	}).map((entry) => entry.note);
+}
+/**
+* Score the static-lint findings alone, on a `0..1` scale. Starts at `1.0`
+* and deducts per finding by severity, clamped at `0`. Used as the report
+* score when no judge model is available.
+*/
+function staticScore(notes) {
+	let score = 1;
+	for (const note of notes) if (note.severity === "error") score -= .4;
+	else if (note.severity === "warn") score -= .2;
+	else score -= .05;
+	return Math.max(0, Number(score.toFixed(4)));
+}
+/**
+* Run the LLM-as-judge pass over `text` using a judge agent built from
+* `model`, REUSING the eval `judge` scorer so there is no second judging
+* path. Returns the judge `score` (`0..1`) and a single derived note carrying
+* its reason (when present). The judge prompt is the prompt-quality rubric;
+* the "answer to grade" is the prompt body itself.
+*
+* @param text - The prompt body under evaluation.
+* @param model - The model that powers the judge agent.
+* @param buildJudgeAgent - Factory that wraps a model into a name-bearing judge agent.
+*/
+async function judgePrompt(text, model, buildJudgeAgent) {
+	const score = await judge({
+		agent: buildJudgeAgent(model),
+		rubric: PROMPT_JUDGE_RUBRIC
+	})({
+		case: {
+			name: "prompt-quality",
+			input: "Grade the system prompt below."
+		},
+		text,
+		result: { text },
+		output: void 0
+	});
+	const notes = [];
+	if (score.reason) notes.push({
+		severity: score.passed ? "info" : "warn",
+		message: `LLM-as-judge: ${score.reason}`
+	});
+	return {
+		score: score.score,
+		notes
+	};
+}
+/**
+* Assemble the final {@link PromptValidationReport} from the static-lint
+* findings and (optionally) the judge findings. Notes are merged and sorted
+* most-severe-first. The score is the static score alone when no judge ran,
+* else the mean of the static score and the judge score.
+*/
+function buildValidationReport(staticNotes, judgeResult) {
+	const allNotes = judgeResult ? [...staticNotes, ...judgeResult.notes] : staticNotes;
+	const lintScore = staticScore(staticNotes);
+	return {
+		score: judgeResult ? Number(((lintScore + judgeResult.score) / 2).toFixed(4)) : lintScore,
+		notes: sortNotesBySeverity(allNotes)
+	};
+}
+
+//#endregion
+export { PROMPT_JUDGE_RUBRIC, buildValidationReport, judgePrompt, staticLint };
+//# sourceMappingURL=prompt-validate.mjs.map

package/esm/prompt/prompt-validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-validate.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/prompt/prompt-validate.ts"],"sourcesContent":["import type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { ModelContract } from \"../contracts/model.contract\";\nimport { judge } from \"../eval/judge-scorer\";\nimport type { PromptValidationNote, PromptValidationReport } from \"./prompt.type\";\n\n/**\n * Placeholder matcher — kept in lock-step with the matcher\n * `renderPlaceholders` uses (`src/system-prompt/render-placeholders.ts`) so the\n * lint sees the same `{{key}}` / `{{a.b}}` / `{{key|default}}` set the renderer\n * substitutes. Global so every occurrence is collected.\n */\nconst PLACEHOLDER_PATTERN = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\n/** Lower bound below which a prompt is suspiciously terse. */\nconst MIN_REASONABLE_LENGTH = 12;\n\n/** Upper bound above which a prompt is likely bloated / unfocused. */\nconst MAX_REASONABLE_LENGTH = 8000;\n\n/**\n * Severity rank for most-severe-first ordering. Higher sorts earlier.\n */\nconst SEVERITY_RANK: Record<PromptValidationNote[\"severity\"], number> = {\n  error: 2,\n  warn: 1,\n  info: 0,\n};\n\n/**\n * The fixed rubric the LLM-as-judge grades a prompt body against. Surfaced\n * here (not inline) so the static-lint pass and the judge pass document the\n * same quality dimensions.\n */\nexport const PROMPT_JUDGE_RUBRIC = [\n  \"Grade this SYSTEM PROMPT on a 0..1 scale for overall quality:\",\n  \"- Clarity: is the intent unambiguous and easy to follow?\",\n  \"- Role definition: does it clearly state who/what the assistant is?\",\n  \"- Output-format specificity: does it say how the answer should be shaped?\",\n  \"- No conflicting instructions: are any directives contradictory?\",\n  \"Score 1.0 only when all four hold; deduct for each weakness and explain why.\",\n].join(\"\\n\");\n\n/**\n * Heuristic role-line detector — a prompt that never says \"you are …\" /\n * \"act as …\" / \"your role is …\" typically lacks a persona. Case-insensitive.\n */\nconst ROLE_HINT_PATTERN = /\\b(you are|act as|your role is|you're a|you will act)\\b/i;\n\n/**\n * Run the cheap, model-free static lint over a prompt body. Flags:\n * - length out of the reasonable band (too terse / too bloated),\n * - any `{{placeholder}}` that survives (undeclared / unresolved at lint time),\n * - a missing role line.\n *\n * Pure and synchronous — used standalone (no judge model) and merged with the\n * judge findings when a model is available.\n *\n * @param text - The prompt body to lint.\n */\nexport function staticLint(text: string): PromptValidationNote[] {\n  const notes: PromptValidationNote[] = [];\n  const trimmed = text.trim();\n\n  if (trimmed.length < MIN_REASONABLE_LENGTH) {\n    notes.push({\n      severity: \"warn\",\n      message: `Prompt is very short (${trimmed.length} chars) — it may be too vague to steer the model.`,\n      suggestion: \"Add an explicit role and at least one concrete instruction.\",\n    });\n  }\n\n  if (trimmed.length > MAX_REASONABLE_LENGTH) {\n    notes.push({\n      severity: \"warn\",\n      message: `Prompt is very long (${trimmed.length} chars) — long prompts dilute focus and inflate cost.`,\n      suggestion: \"Split into a tighter persona plus a few focused instructions.\",\n    });\n  }\n\n  const placeholders = collectPlaceholders(text);\n\n  for (const placeholder of placeholders) {\n    notes.push({\n      severity: \"info\",\n      message: `Unresolved placeholder \"{{${placeholder}}}\" — confirm it is supplied at resolve time or give it a default (\"{{${placeholder}|...}}\").`,\n    });\n  }\n\n  if (!ROLE_HINT_PATTERN.test(trimmed)) {\n    notes.push({\n      severity: \"warn\",\n      message: \"No role line found — the prompt never states who the assistant is.\",\n      suggestion: 'Open with a role, e.g. \"You are a senior support engineer for …\".',\n    });\n  }\n\n  return notes;\n}\n\n/**\n * Collect every distinct placeholder PATH (the part before any `|default`)\n * from a template, in first-seen order. Matches `renderPlaceholders`' own\n * parsing so the lint never disagrees with the renderer.\n */\nfunction collectPlaceholders(template: string): string[] {\n  const found: string[] = [];\n  const seen = new Set<string>();\n\n  for (const match of template.matchAll(PLACEHOLDER_PATTERN)) {\n    const path = match[1].split(\"|\")[0].trim();\n\n    if (path.length > 0 && !seen.has(path)) {\n      seen.add(path);\n      found.push(path);\n    }\n  }\n\n  return found;\n}\n\n/**\n * Stable, most-severe-first ordering: `error` before `warn` before `info`,\n * preserving original order within a severity. Returns a fresh array.\n */\nexport function sortNotesBySeverity(\n  notes: PromptValidationNote[],\n): PromptValidationNote[] {\n  return notes\n    .map((note, index) => ({ note, index }))\n    .sort((a, b) => {\n      const rankDiff = SEVERITY_RANK[b.note.severity] - SEVERITY_RANK[a.note.severity];\n\n      return rankDiff !== 0 ? rankDiff : a.index - b.index;\n    })\n    .map(entry => entry.note);\n}\n\n/**\n * Score the static-lint findings alone, on a `0..1` scale. Starts at `1.0`\n * and deducts per finding by severity, clamped at `0`. Used as the report\n * score when no judge model is available.\n */\nexport function staticScore(notes: PromptValidationNote[]): number {\n  let score = 1;\n\n  for (const note of notes) {\n    if (note.severity === \"error\") {\n      score -= 0.4;\n    } else if (note.severity === \"warn\") {\n      score -= 0.2;\n    } else {\n      score -= 0.05;\n    }\n  }\n\n  return Math.max(0, Number(score.toFixed(4)));\n}\n\n/**\n * Run the LLM-as-judge pass over `text` using a judge agent built from\n * `model`, REUSING the eval `judge` scorer so there is no second judging\n * path. Returns the judge `score` (`0..1`) and a single derived note carrying\n * its reason (when present). The judge prompt is the prompt-quality rubric;\n * the \"answer to grade\" is the prompt body itself.\n *\n * @param text - The prompt body under evaluation.\n * @param model - The model that powers the judge agent.\n * @param buildJudgeAgent - Factory that wraps a model into a name-bearing judge agent.\n */\nexport async function judgePrompt(\n  text: string,\n  model: ModelContract,\n  buildJudgeAgent: (model: ModelContract) => AgentContract<unknown>,\n): Promise<{ score: number; notes: PromptValidationNote[] }> {\n  const judgeAgent = buildJudgeAgent(model);\n  const scorer = judge({ agent: judgeAgent, rubric: PROMPT_JUDGE_RUBRIC });\n\n  const score = await scorer({\n    // The judge scorer only reads `case.input` / `case.expected` / `text` /\n    // `output` from the context. We feed the rubric question via `input` and\n    // the prompt body as the answer to grade via `text`.\n    case: { name: \"prompt-quality\", input: \"Grade the system prompt below.\" },\n    text,\n    // `result` is unused by the judge scorer's prompt builder; a minimal\n    // stand-in keeps the structural contract satisfied without a real run.\n    result: { text } as never,\n    output: undefined,\n  });\n\n  const notes: PromptValidationNote[] = [];\n\n  if (score.reason) {\n    notes.push({\n      severity: score.passed ? \"info\" : \"warn\",\n      message: `LLM-as-judge: ${score.reason}`,\n    });\n  }\n\n  return { score: score.score, notes };\n}\n\n/**\n * Assemble the final {@link PromptValidationReport} from the static-lint\n * findings and (optionally) the judge findings. Notes are merged and sorted\n * most-severe-first. The score is the static score alone when no judge ran,\n * else the mean of the static score and the judge score.\n */\nexport function buildValidationReport(\n  staticNotes: PromptValidationNote[],\n  judgeResult?: { score: number; notes: PromptValidationNote[] },\n): PromptValidationReport {\n  const allNotes = judgeResult\n    ? [...staticNotes, ...judgeResult.notes]\n    : staticNotes;\n\n  const lintScore = staticScore(staticNotes);\n\n  const score = judgeResult\n    ? Number(((lintScore + judgeResult.score) / 2).toFixed(4))\n    : lintScore;\n\n  return {\n    score,\n    notes: sortNotesBySeverity(allNotes),\n  };\n}\n"],"mappings":"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"}

package/esm/prompt/prompt.d.mts

@@ -0,0 +1,54 @@
+import { SystemPromptContract } from "../contracts/system-prompt.contract.mjs";
+import { PromptRegistryContract, PromptRegistryOptions } from "./prompt.type.mjs";
+
+//#region ../@warlock.js/ai/src/prompt/prompt.d.ts
+/**
+ * Create a versioned, typed prompt registry — a thin facade over the unified
+ * `ai.prompts` manager.
+ *
+ * **Role.** Public factory for {@link PromptRegistryContract}. Keeps
+ * user-facing code free of `new` and consistent with `ai.memory`,
+ * `ai.orchestrator`, `ai.batch` (all return instances). Each call returns a
+ * fresh, isolated registry backed by its own unified manager, so parallel test
+ * suites and multi-tenant apps never share mutable global prompt state.
+ *
+ * @param options - Seed entries, an optional default judge model, and an
+ *   optional Langfuse sync.
+ *
+ * @example
+ * const prompts = prompt({
+ *   prompts: [
+ *     {
+ *       name: "support-agent",
+ *       versions: [
+ *         { version: "1", template: "You are support for {{product}}. Reply in {{language|English}}." },
+ *         { version: "2", template: "You are senior support for {{product}}.", required: ["product"] },
+ *       ],
+ *     },
+ *   ],
+ * });
+ *
+ * const resolved = prompts.resolve("support-agent", { placeholders: { product: "Warlock" } });
+ * const agent = ai.agent({ model, systemPrompt: resolved.toSystemPrompt() });
+ * // resolved.version === "2"; a missing `product` would throw PromptValidationError.
+ *
+ * @example
+ * // Resolve a globally-registered prompt by name from `ai.prompts`.
+ * ai.systemPrompt("You are support.", { name: "support" });
+ * const sp = ai.prompt("support"); // → the registered SystemPromptContract
+ */
+declare function promptFactory(name: string, versionOrTag?: string): SystemPromptContract;
+declare function promptFactory(options?: PromptRegistryOptions): PromptRegistryContract;
+/**
+ * Create a versioned prompt registry, OR resolve a globally-registered prompt
+ * by name from `ai.prompts`.
+ *
+ * - `prompt(options?)` → a fresh, isolated {@link PromptRegistryContract}.
+ * - `prompt(name, versionOrTag?)` → the `SystemPromptContract` registered under
+ *   `name` in the process-wide `ai.prompts` manager (latest version by default,
+ *   or a specific version / pinned tag).
+ */
+declare const prompt: typeof promptFactory;
+//#endregion
+export { prompt };
+//# sourceMappingURL=prompt.d.mts.map

package/esm/prompt/prompt.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/prompt/prompt.ts"],"mappings":";;;;;;AA+BuB;;;;;;;;AA+UA;AAAA;;;;;;;;AACwD;AAyB/E;;;;AAAyD;;;;;;;;;;;iBA7BhD,aAAA,CACP,IAAA,UACA,YAAA,YACC,oBAAoB;AAAA,iBACd,aAAA,CAAc,OAAA,GAAU,qBAAA,GAAwB,sBAAsB;;;;;;;;;;cAyBlE,MAAA,SAAe,aAA6B"}

package/esm/prompt/prompt.mjs

@@ -0,0 +1,218 @@
+import { agent } from "../agent/agent.mjs";
+import { renderPlaceholders } from "../system-prompt/render-placeholders.mjs";
+import { Instruction } from "../system-prompt/instruction.mjs";
+import { SystemPrompt } from "../system-prompt/system-prompt.mjs";
+import { buildValidationReport, judgePrompt, staticLint } from "./prompt-validate.mjs";
+import { defaultPromptsManager, prompts } from "../prompts/prompts-manager.mjs";
+import { PromptNotFoundError, PromptValidationError } from "./errors.mjs";
+import { syncLangfusePrompts, warmLangfuse } from "./prompt-langfuse-sync.mjs";
+
+//#region ../@warlock.js/ai/src/prompt/prompt.ts
+/**
+* Build the one-shot judge agent the `validate()` LLM-as-judge pass runs.
+* Name-bearing (the eval `judge` scorer requires a usable agent) and seeded
+* with a strict-JSON instruction so its verdict parses even without an output
+* schema. Kept module-private so the registry's only model dependency is the
+* `agent()` factory.
+*/
+function buildJudgeAgent(model) {
+	return agent({
+		name: "prompt-quality-judge",
+		model,
+		systemPrompt: "You are a strict prompt-quality grader. Respond with JSON only: { \"score\": <0..1>, \"passed\": <true|false>, \"reason\": \"<short explanation>\" }."
+	});
+}
+/**
+* Build the `SystemPromptContract` a single {@link PromptVersion} maps to: its
+* `template` becomes one instruction block, and its `required` keys ride along
+* as `meta.required` so the unified manager (and `validate`) can see them.
+*
+* Deliberately ANONYMOUS (no `meta.name`) so the `SystemPrompt` constructor
+* never auto-registers this version into the process-wide `ai.prompts` default
+* manager — each `prompt()` registry owns its OWN isolated
+* {@link PromptsManagerContract}, the single storage shape behind this facade.
+*/
+function versionToContract(version) {
+	return new SystemPrompt([new Instruction(version.template)], { ...version.required ? { required: version.required } : {} });
+}
+/**
+* Legacy `PromptRegistryContract` — now a THIN FACADE over the unified
+* {@link PromptsManagerContract} (`ai.prompts`).
+*
+* **Role.** The store behind `ai.prompt(...)`. Historically it held a private
+* `Map<string, PromptVersion[]>`; it now delegates ALL storage to a private,
+* per-instance {@link PromptsManagerContract}, so there is exactly ONE storage
+* shape across the whole prompt surface: a `SystemPromptContract` keyed by
+* `name@version`. A version's raw `template` string maps to a single
+* instruction block and its `required` keys to `meta.required`.
+*
+* **Responsibility.**
+* - Owns: the legacy method surface (`register` / `add` / `versions` /
+*   `resolve` / `validate` / `sync`) and the back-compat behaviors — duplicate
+*   version rejection, required-key assertion on `resolve()`, the
+*   `{ score, notes }` validation report shape, and the optional Langfuse sync.
+* - Does NOT own: the actual storage (delegated to the internal manager),
+*   placeholder rendering (delegated to `renderPlaceholders`), or the unified
+*   validation primitives (delegated to `prompt-validate`).
+*
+* Each `prompt(options)` call builds its own isolated manager — so parallel
+* test suites and multi-tenant apps never share mutable global prompt state,
+* exactly as before the unification.
+*
+* Users construct via the `prompt()` factory — `new PromptRegistry()` is not
+* the public API.
+*/
+var PromptRegistry = class {
+	constructor(options = {}) {
+		this.options = options;
+		this.versionMeta = /* @__PURE__ */ new Map();
+		this.manager = prompts();
+		for (const entry of options.prompts ?? []) this.register(entry);
+		if (options.langfuse) warmLangfuse(options.langfuse);
+	}
+	/**
+	* Register a whole entry. Merges onto an existing name's history; a
+	* duplicate version label throws {@link PromptValidationError}.
+	*/
+	register(entry) {
+		for (const version of entry.versions) this.add(entry.name, version);
+		if (!this.versionMeta.has(entry.name)) this.versionMeta.set(entry.name, []);
+		return this;
+	}
+	/**
+	* Add a new version to a name (creating it when absent). A duplicate
+	* version label throws {@link PromptValidationError} — never a silent
+	* overwrite.
+	*/
+	add(name, version) {
+		const mirror = this.versionMeta.get(name) ?? [];
+		if (mirror.some((existing) => existing.version === version.version)) throw new PromptValidationError(`Prompt "${name}" already has a version labeled "${version.version}".`, { context: {
+			name,
+			version: version.version
+		} });
+		this.manager.register(versionToContract(version), {
+			name,
+			version: version.version
+		});
+		this.versionMeta.set(name, [...mirror, version]);
+		return this;
+	}
+	/** Whether a name is registered. */
+	has(name) {
+		return this.versionMeta.has(name);
+	}
+	/** Every registered prompt name, in registration order. */
+	list() {
+		return [...this.versionMeta.keys()];
+	}
+	/** Versions registered for a name, latest last. Throws on an unknown name. */
+	versions(name) {
+		const mirror = this.versionMeta.get(name);
+		if (!mirror) throw new PromptNotFoundError(name);
+		return [...mirror];
+	}
+	/**
+	* Resolve + render. Picks the requested or latest version, validates the
+	* version's `required` keys against the merged placeholders, then renders by
+	* delegating to the shared `renderPlaceholders` over the contract's text.
+	*/
+	resolve(name, options = {}) {
+		const picked = this.pickVersion(name, options.version);
+		const placeholders = options.placeholders ?? {};
+		this.assertRequired(name, picked, placeholders);
+		const text = renderPlaceholders(this.manager.get(name, picked.version).blocks[0]?.text ?? picked.template, placeholders);
+		return {
+			name,
+			version: picked.version,
+			text,
+			toSystemPrompt: () => new SystemPrompt([new Instruction(text)])
+		};
+	}
+	/**
+	* Quality-check a raw prompt body or a registered prompt (by name). Backed by
+	* the unified deterministic validate primitives plus the LLM-as-judge pass,
+	* but returns the legacy `{ score, notes }` report shape so existing callers
+	* keep working.
+	*
+	* Always runs the static lint; runs the LLM-as-judge pass too when a model is
+	* resolvable. Never throws when no judge model is available.
+	*/
+	async validate(textOrName, options = {}) {
+		const text = this.resolveValidationText(textOrName, options.version);
+		const staticNotes = staticLint(text);
+		const model = options.model ?? this.options.judgeModel;
+		if (!model) return buildValidationReport(staticNotes);
+		return buildValidationReport(staticNotes, await judgePrompt(text, model, buildJudgeAgent));
+	}
+	/**
+	* Synchronize named prompts with Langfuse-prompts. No-op (resolves) when no
+	* `langfuse` option was configured. The resolved (rendered) body + the
+	* `name@version` label are what is pushed/pulled.
+	*/
+	async sync() {
+		if (!this.options.langfuse) return;
+		await syncLangfusePrompts(this.options.langfuse, this.list(), this.snapshotEntries(), (entry) => this.register(entry));
+	}
+	/**
+	* Pick the requested (or latest) {@link PromptVersion} for a name from the
+	* mirror, throwing {@link PromptNotFoundError} on an unknown name or version.
+	*/
+	pickVersion(name, version) {
+		const mirror = this.versionMeta.get(name);
+		if (!mirror || mirror.length === 0) throw new PromptNotFoundError(name);
+		const picked = version ? mirror.find((candidate) => candidate.version === version) : mirror[mirror.length - 1];
+		if (!picked) throw new PromptNotFoundError(name, { context: {
+			name,
+			version
+		} });
+		return picked;
+	}
+	/**
+	* Resolve the text `validate()` should grade: a registered name yields its
+	* picked version's raw `template`; anything else is treated as the raw body.
+	*/
+	resolveValidationText(textOrName, version) {
+		const mirror = this.versionMeta.get(textOrName);
+		if (!mirror || mirror.length === 0) return textOrName;
+		const picked = version ? mirror.find((candidate) => candidate.version === version) : mirror[mirror.length - 1];
+		return picked ? picked.template : textOrName;
+	}
+	/**
+	* Throw {@link PromptValidationError} listing every `required` key absent
+	* from the merged placeholders. A no-op when the version declares none.
+	*/
+	assertRequired(name, version, placeholders) {
+		if (!version.required || version.required.length === 0) return;
+		const missing = version.required.filter((key) => placeholders[key] === void 0 || placeholders[key] === null || placeholders[key] === "");
+		if (missing.length > 0) throw new PromptValidationError(`Prompt "${name}" version "${version.version}" is missing required placeholder${missing.length > 1 ? "s" : ""}: ${missing.join(", ")}.`, { context: {
+			name,
+			version: version.version,
+			missing
+		} });
+	}
+	/** Snapshot the catalog as `PromptEntry[]` (for the Langfuse push path). */
+	snapshotEntries() {
+		return [...this.versionMeta.entries()].map(([name, versions]) => ({
+			name,
+			versions: [...versions]
+		}));
+	}
+};
+function promptFactory(first, versionOrTag) {
+	if (typeof first === "string") return defaultPromptsManager().get(first, versionOrTag);
+	return new PromptRegistry(first);
+}
+/**
+* Create a versioned prompt registry, OR resolve a globally-registered prompt
+* by name from `ai.prompts`.
+*
+* - `prompt(options?)` → a fresh, isolated {@link PromptRegistryContract}.
+* - `prompt(name, versionOrTag?)` → the `SystemPromptContract` registered under
+*   `name` in the process-wide `ai.prompts` manager (latest version by default,
+*   or a specific version / pinned tag).
+*/
+const prompt = promptFactory;
+
+//#endregion
+export { prompt };
+//# sourceMappingURL=prompt.mjs.map

package/esm/prompt/prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.mjs","names":["createPromptsManager"],"sources":["../../../../../../../@warlock.js/ai/src/prompt/prompt.ts"],"sourcesContent":["import type { SystemPromptContract } from \"../contracts/system-prompt.contract\";\nimport {\n  defaultPromptsManager,\n  prompts as createPromptsManager,\n} from \"../prompts/prompts-manager\";\nimport type { PromptsManagerContract } from \"../prompts/prompts-manager.contract\";\nimport { Instruction } from \"../system-prompt/instruction\";\nimport { renderPlaceholders } from \"../system-prompt/render-placeholders\";\nimport { SystemPrompt } from \"../system-prompt/system-prompt\";\nimport { PromptNotFoundError, PromptValidationError } from \"./errors\";\nimport {\n  syncLangfusePrompts,\n  warmLangfuse,\n} from \"./prompt-langfuse-sync\";\nimport {\n  buildValidationReport,\n  judgePrompt,\n  staticLint,\n} from \"./prompt-validate\";\nimport { agent } from \"../agent/agent\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { ModelContract } from \"../contracts/model.contract\";\nimport type {\n  PromptEntry,\n  PromptRegistryContract,\n  PromptRegistryOptions,\n  PromptResolveOptions,\n  PromptValidateOptions,\n  PromptValidationReport,\n  PromptVersion,\n  ResolvedPrompt,\n} from \"./prompt.type\";\n\n/**\n * Build the one-shot judge agent the `validate()` LLM-as-judge pass runs.\n * Name-bearing (the eval `judge` scorer requires a usable agent) and seeded\n * with a strict-JSON instruction so its verdict parses even without an output\n * schema. Kept module-private so the registry's only model dependency is the\n * `agent()` factory.\n */\nfunction buildJudgeAgent(model: ModelContract): AgentContract<unknown> {\n  return agent({\n    name: \"prompt-quality-judge\",\n    model,\n    systemPrompt:\n      \"You are a strict prompt-quality grader. Respond with JSON only: \" +\n      '{ \"score\": <0..1>, \"passed\": <true|false>, \"reason\": \"<short explanation>\" }.',\n  });\n}\n\n/**\n * Build the `SystemPromptContract` a single {@link PromptVersion} maps to: its\n * `template` becomes one instruction block, and its `required` keys ride along\n * as `meta.required` so the unified manager (and `validate`) can see them.\n *\n * Deliberately ANONYMOUS (no `meta.name`) so the `SystemPrompt` constructor\n * never auto-registers this version into the process-wide `ai.prompts` default\n * manager — each `prompt()` registry owns its OWN isolated\n * {@link PromptsManagerContract}, the single storage shape behind this facade.\n */\nfunction versionToContract(version: PromptVersion): SystemPromptContract {\n  return new SystemPrompt([new Instruction(version.template)], {\n    ...(version.required ? { required: version.required } : {}),\n  });\n}\n\n/**\n * Legacy `PromptRegistryContract` — now a THIN FACADE over the unified\n * {@link PromptsManagerContract} (`ai.prompts`).\n *\n * **Role.** The store behind `ai.prompt(...)`. Historically it held a private\n * `Map<string, PromptVersion[]>`; it now delegates ALL storage to a private,\n * per-instance {@link PromptsManagerContract}, so there is exactly ONE storage\n * shape across the whole prompt surface: a `SystemPromptContract` keyed by\n * `name@version`. A version's raw `template` string maps to a single\n * instruction block and its `required` keys to `meta.required`.\n *\n * **Responsibility.**\n * - Owns: the legacy method surface (`register` / `add` / `versions` /\n *   `resolve` / `validate` / `sync`) and the back-compat behaviors — duplicate\n *   version rejection, required-key assertion on `resolve()`, the\n *   `{ score, notes }` validation report shape, and the optional Langfuse sync.\n * - Does NOT own: the actual storage (delegated to the internal manager),\n *   placeholder rendering (delegated to `renderPlaceholders`), or the unified\n *   validation primitives (delegated to `prompt-validate`).\n *\n * Each `prompt(options)` call builds its own isolated manager — so parallel\n * test suites and multi-tenant apps never share mutable global prompt state,\n * exactly as before the unification.\n *\n * Users construct via the `prompt()` factory — `new PromptRegistry()` is not\n * the public API.\n */\nclass PromptRegistry implements PromptRegistryContract {\n  /** The single backing store — one isolated unified manager per registry. */\n  private readonly manager: PromptsManagerContract;\n\n  /** Per-name version metadata mirror, kept so `versions()` returns the rich\n   * {@link PromptVersion} shape (template + required + meta) the legacy API\n   * promised — the manager itself only stores the flattened contract. */\n  private readonly versionMeta = new Map<string, PromptVersion[]>();\n\n  public constructor(private readonly options: PromptRegistryOptions = {}) {\n    this.manager = createPromptsManager();\n\n    for (const entry of options.prompts ?? []) {\n      this.register(entry);\n    }\n\n    if (options.langfuse) {\n      warmLangfuse(options.langfuse);\n    }\n  }\n\n  /**\n   * Register a whole entry. Merges onto an existing name's history; a\n   * duplicate version label throws {@link PromptValidationError}.\n   */\n  public register(entry: PromptEntry): PromptRegistryContract {\n    for (const version of entry.versions) {\n      this.add(entry.name, version);\n    }\n\n    // An entry with an empty version list still creates the name so `has`\n    // / `list` reflect it.\n    if (!this.versionMeta.has(entry.name)) {\n      this.versionMeta.set(entry.name, []);\n    }\n\n    return this;\n  }\n\n  /**\n   * Add a new version to a name (creating it when absent). A duplicate\n   * version label throws {@link PromptValidationError} — never a silent\n   * overwrite.\n   */\n  public add(name: string, version: PromptVersion): PromptRegistryContract {\n    const mirror = this.versionMeta.get(name) ?? [];\n\n    if (mirror.some(existing => existing.version === version.version)) {\n      throw new PromptValidationError(\n        `Prompt \"${name}\" already has a version labeled \"${version.version}\".`,\n        { context: { name, version: version.version } },\n      );\n    }\n\n    this.manager.register(versionToContract(version), {\n      name,\n      version: version.version,\n    });\n\n    this.versionMeta.set(name, [...mirror, version]);\n\n    return this;\n  }\n\n  /** Whether a name is registered. */\n  public has(name: string): boolean {\n    return this.versionMeta.has(name);\n  }\n\n  /** Every registered prompt name, in registration order. */\n  public list(): string[] {\n    return [...this.versionMeta.keys()];\n  }\n\n  /** Versions registered for a name, latest last. Throws on an unknown name. */\n  public versions(name: string): PromptVersion[] {\n    const mirror = this.versionMeta.get(name);\n\n    if (!mirror) {\n      throw new PromptNotFoundError(name);\n    }\n\n    return [...mirror];\n  }\n\n  /**\n   * Resolve + render. Picks the requested or latest version, validates the\n   * version's `required` keys against the merged placeholders, then renders by\n   * delegating to the shared `renderPlaceholders` over the contract's text.\n   */\n  public resolve(name: string, options: PromptResolveOptions = {}): ResolvedPrompt {\n    const picked = this.pickVersion(name, options.version);\n    const placeholders = options.placeholders ?? {};\n\n    this.assertRequired(name, picked, placeholders);\n\n    // Render the RAW template (placeholders intact) against the merged values —\n    // resolving the contract first would bake inline `{{key|default}}` defaults\n    // in and shadow an explicitly-supplied value. The stored block text is the\n    // single source of the un-rendered template.\n    const contract = this.manager.get(name, picked.version);\n    const template = contract.blocks[0]?.text ?? picked.template;\n    const text = renderPlaceholders(template, placeholders);\n\n    return {\n      name,\n      version: picked.version,\n      text,\n      toSystemPrompt: () => new SystemPrompt([new Instruction(text)]),\n    };\n  }\n\n  /**\n   * Quality-check a raw prompt body or a registered prompt (by name). Backed by\n   * the unified deterministic validate primitives plus the LLM-as-judge pass,\n   * but returns the legacy `{ score, notes }` report shape so existing callers\n   * keep working.\n   *\n   * Always runs the static lint; runs the LLM-as-judge pass too when a model is\n   * resolvable. Never throws when no judge model is available.\n   */\n  public async validate(\n    textOrName: string,\n    options: PromptValidateOptions = {},\n  ): Promise<PromptValidationReport> {\n    const text = this.resolveValidationText(textOrName, options.version);\n    const staticNotes = staticLint(text);\n\n    const model = options.model ?? this.options.judgeModel;\n\n    if (!model) {\n      return buildValidationReport(staticNotes);\n    }\n\n    const judgeResult = await judgePrompt(text, model, buildJudgeAgent);\n\n    return buildValidationReport(staticNotes, judgeResult);\n  }\n\n  /**\n   * Synchronize named prompts with Langfuse-prompts. No-op (resolves) when no\n   * `langfuse` option was configured. The resolved (rendered) body + the\n   * `name@version` label are what is pushed/pulled.\n   */\n  public async sync(): Promise<void> {\n    if (!this.options.langfuse) {\n      return;\n    }\n\n    await syncLangfusePrompts(\n      this.options.langfuse,\n      this.list(),\n      this.snapshotEntries(),\n      entry => this.register(entry),\n    );\n  }\n\n  /**\n   * Pick the requested (or latest) {@link PromptVersion} for a name from the\n   * mirror, throwing {@link PromptNotFoundError} on an unknown name or version.\n   */\n  private pickVersion(name: string, version?: string): PromptVersion {\n    const mirror = this.versionMeta.get(name);\n\n    if (!mirror || mirror.length === 0) {\n      throw new PromptNotFoundError(name);\n    }\n\n    const picked = version\n      ? mirror.find(candidate => candidate.version === version)\n      : mirror[mirror.length - 1];\n\n    if (!picked) {\n      throw new PromptNotFoundError(name, {\n        context: { name, version },\n      });\n    }\n\n    return picked;\n  }\n\n  /**\n   * Resolve the text `validate()` should grade: a registered name yields its\n   * picked version's raw `template`; anything else is treated as the raw body.\n   */\n  private resolveValidationText(textOrName: string, version?: string): string {\n    const mirror = this.versionMeta.get(textOrName);\n\n    if (!mirror || mirror.length === 0) {\n      return textOrName;\n    }\n\n    const picked = version\n      ? mirror.find(candidate => candidate.version === version)\n      : mirror[mirror.length - 1];\n\n    return picked ? picked.template : textOrName;\n  }\n\n  /**\n   * Throw {@link PromptValidationError} listing every `required` key absent\n   * from the merged placeholders. A no-op when the version declares none.\n   */\n  private assertRequired(\n    name: string,\n    version: PromptVersion,\n    placeholders: Record<string, unknown>,\n  ): void {\n    if (!version.required || version.required.length === 0) {\n      return;\n    }\n\n    const missing = version.required.filter(\n      key => placeholders[key] === undefined || placeholders[key] === null || placeholders[key] === \"\",\n    );\n\n    if (missing.length > 0) {\n      throw new PromptValidationError(\n        `Prompt \"${name}\" version \"${version.version}\" is missing required placeholder${\n          missing.length > 1 ? \"s\" : \"\"\n        }: ${missing.join(\", \")}.`,\n        { context: { name, version: version.version, missing } },\n      );\n    }\n  }\n\n  /** Snapshot the catalog as `PromptEntry[]` (for the Langfuse push path). */\n  private snapshotEntries(): PromptEntry[] {\n    return [...this.versionMeta.entries()].map(([name, versions]) => ({\n      name,\n      versions: [...versions],\n    }));\n  }\n}\n\n/**\n * Create a versioned, typed prompt registry — a thin facade over the unified\n * `ai.prompts` manager.\n *\n * **Role.** Public factory for {@link PromptRegistryContract}. Keeps\n * user-facing code free of `new` and consistent with `ai.memory`,\n * `ai.orchestrator`, `ai.batch` (all return instances). Each call returns a\n * fresh, isolated registry backed by its own unified manager, so parallel test\n * suites and multi-tenant apps never share mutable global prompt state.\n *\n * @param options - Seed entries, an optional default judge model, and an\n *   optional Langfuse sync.\n *\n * @example\n * const prompts = prompt({\n *   prompts: [\n *     {\n *       name: \"support-agent\",\n *       versions: [\n *         { version: \"1\", template: \"You are support for {{product}}. Reply in {{language|English}}.\" },\n *         { version: \"2\", template: \"You are senior support for {{product}}.\", required: [\"product\"] },\n *       ],\n *     },\n *   ],\n * });\n *\n * const resolved = prompts.resolve(\"support-agent\", { placeholders: { product: \"Warlock\" } });\n * const agent = ai.agent({ model, systemPrompt: resolved.toSystemPrompt() });\n * // resolved.version === \"2\"; a missing `product` would throw PromptValidationError.\n *\n * @example\n * // Resolve a globally-registered prompt by name from `ai.prompts`.\n * ai.systemPrompt(\"You are support.\", { name: \"support\" });\n * const sp = ai.prompt(\"support\"); // → the registered SystemPromptContract\n */\nfunction promptFactory(\n  name: string,\n  versionOrTag?: string,\n): SystemPromptContract;\nfunction promptFactory(options?: PromptRegistryOptions): PromptRegistryContract;\nfunction promptFactory(\n  first?: string | PromptRegistryOptions,\n  versionOrTag?: string,\n): SystemPromptContract | PromptRegistryContract {\n  // String form: resolve a globally-registered prompt from the process-wide\n  // `ai.prompts` manager (the single unified registry). This is the thin\n  // facade's read path onto the shared store.\n  if (typeof first === \"string\") {\n    return defaultPromptsManager().get(first, versionOrTag);\n  }\n\n  // Options form: build an isolated registry backed by its own unified manager.\n  return new PromptRegistry(first);\n}\n\n/**\n * Create a versioned prompt registry, OR resolve a globally-registered prompt\n * by name from `ai.prompts`.\n *\n * - `prompt(options?)` → a fresh, isolated {@link PromptRegistryContract}.\n * - `prompt(name, versionOrTag?)` → the `SystemPromptContract` registered under\n *   `name` in the process-wide `ai.prompts` manager (latest version by default,\n *   or a specific version / pinned tag).\n */\nexport const prompt: typeof promptFactory = promptFactory;\n"],"mappings":"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"}