@funkai/prompts 0.2.0 → 0.3.0

package/.turbo/turbo-build.log

@@ -1,28 +1,28 @@
 
-> @funkai/prompts@0.2.0 build /home/runner/work/funkai/funkai/packages/prompts
+> @funkai/prompts@0.3.0 build /home/runner/work/funkai/funkai/packages/prompts
 > tsdown && cp -r src/prompts dist/prompts
 
-ℹ tsdown v0.21.3 powered by rolldown v1.0.0-rc.9
+ℹ tsdown v0.21.4 powered by rolldown v1.0.0-rc.9
 ℹ config file: /home/runner/work/funkai/funkai/packages/prompts/tsdown.config.ts 
 ℹ entry: src/index.ts, src/runtime.ts, src/cli.ts
 ℹ target: node22
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/lib/index.mjs                  1.66 kB │ gzip: 0.80 kB
-ℹ dist/lib/cli.mjs                    1.10 kB │ gzip: 0.63 kB
+ℹ dist/lib/index.mjs                  1.70 kB │ gzip: 0.82 kB
+ℹ dist/lib/cli.mjs                    1.39 kB │ gzip: 0.75 kB
 ℹ dist/lib/runtime.mjs                0.08 kB │ gzip: 0.08 kB
-ℹ dist/lib/index.mjs.map              2.48 kB │ gzip: 1.12 kB
-ℹ dist/lib/engine-B53whAlC.mjs.map    1.57 kB │ gzip: 0.79 kB
-ℹ dist/lib/cli.mjs.map                1.37 kB │ gzip: 0.75 kB
-ℹ dist/lib/engine-B53whAlC.mjs        1.15 kB │ gzip: 0.61 kB
-ℹ dist/lib/types-CiSdNM0W.d.mts.map   0.53 kB │ gzip: 0.29 kB
-ℹ dist/lib/engine-B6JHetwb.d.mts.map  0.22 kB │ gzip: 0.18 kB
-ℹ dist/lib/index.d.mts.map            0.19 kB │ gzip: 0.16 kB
-ℹ dist/lib/cli.d.mts.map              0.17 kB │ gzip: 0.15 kB
+ℹ dist/lib/index.mjs.map              2.71 kB │ gzip: 1.16 kB
+ℹ dist/lib/cli.mjs.map                1.86 kB │ gzip: 0.90 kB
+ℹ dist/lib/engine-CPKs9QbX.mjs.map    1.67 kB │ gzip: 0.85 kB
+ℹ dist/lib/engine-CPKs9QbX.mjs        1.17 kB │ gzip: 0.62 kB
+ℹ dist/lib/types-2PI_9h-M.d.mts.map   0.53 kB │ gzip: 0.29 kB
+ℹ dist/lib/engine-CQfJbVz6.d.mts.map  0.22 kB │ gzip: 0.18 kB
+ℹ dist/lib/index.d.mts.map            0.19 kB │ gzip: 0.15 kB
+ℹ dist/lib/cli.d.mts.map              0.18 kB │ gzip: 0.15 kB
 ℹ dist/lib/index.d.mts                1.04 kB │ gzip: 0.54 kB
-ℹ dist/lib/cli.d.mts                  0.68 kB │ gzip: 0.41 kB
+ℹ dist/lib/cli.d.mts                  0.94 kB │ gzip: 0.53 kB
 ℹ dist/lib/runtime.d.mts              0.08 kB │ gzip: 0.08 kB
-ℹ dist/lib/types-CiSdNM0W.d.mts       1.47 kB │ gzip: 0.71 kB
-ℹ dist/lib/engine-B6JHetwb.d.mts      1.06 kB │ gzip: 0.57 kB
-ℹ 16 files, total: 14.86 kB
-✔ Build complete in 1822ms
+ℹ dist/lib/types-2PI_9h-M.d.mts       1.43 kB │ gzip: 0.69 kB
+ℹ dist/lib/engine-CQfJbVz6.d.mts      1.08 kB │ gzip: 0.58 kB
+ℹ 16 files, total: 16.28 kB
+✔ Build complete in 1612ms

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @funkai/prompts
 
+## 0.3.0
+
+### Minor Changes
+
+- b1e1d01: Fix bug and correctness issues across all packages.
+
+  **@funkai/agents**
+
+  - Export `createFlowEngine` and related types (`FlowEngineConfig`, `FlowFactory`, `CustomStepFactory`, `CustomStepDefinitions`, `TypedCustomSteps`)
+  - Guard `resolvedInput` before passing to `onError` hooks (was `undefined` cast as `TInput`)
+  - Fix `onStepStart` hook asymmetry: per-call override now merged with config hook
+  - Remove deprecated unused `TraceType` alias
+
+  **@funkai/prompts**
+
+  - **Breaking:** `strictFilters` and `ownPropertyOnly` removed from `CreateEngineOptions` (now enforced as non-overridable safety defaults)
+
+  **@funkai/models**
+
+  - Add `provider/model` format validation for model IDs
+  - Wrap `languageModel()` errors with model ID context
+
+  **@funkai/cli**
+
+  - Fix `$`-substitution bug in `flattenPartials` (`String.replace` function-form)
+  - Add error context for partial render failures
+  - `readJsonFile` now throws on malformed JSON instead of silently returning `{}`
+  - Replace naive YAML line parsing with proper `yaml` parser
+  - Extract `Liquid` engine to module-level singleton in `extractVariables`
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/lib/cli.d.mts

@@ -1,5 +1,5 @@
-import { n as Liquid, t as CreateEngineOptions } from "./types-CiSdNM0W.mjs";
-import { t as createEngine } from "./engine-B6JHetwb.mjs";
+import { n as Liquid, t as CreateEngineOptions } from "./types-2PI_9h-M.mjs";
+import { t as createEngine } from "./engine-CQfJbVz6.mjs";
 
 //#region src/clean.d.ts
 /**
@@ -7,6 +7,14 @@ import { t as createEngine } from "./engine-B6JHetwb.mjs";
  *
  * Runs the source through a pipeline of transforms — currently
  * strips frontmatter, with more steps added over time.
+ *
+ * @param text - Raw `.prompt` file content including frontmatter.
+ * @returns The cleaned template string, ready for rendering.
+ * @example
+ * ```ts
+ * const template = clean("---\nname: greeting\n---\nHello {{ name }}!");
+ * // "Hello {{ name }}!"
+ * ```
  */
 declare function clean(text: string): string;
 //#endregion

package/dist/lib/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../../src/clean.ts","../../src/partials-dir.ts"],"mappings":";;;;;;;;AAsBA;;iBAAgB,KAAA,CAAM,IAAA;;;;cClBT,YAAA"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../../src/clean.ts","../../src/partials-dir.ts"],"mappings":";;;;;;;;AAkBA;;;;;;;;ACdA;;iBDcgB,KAAA,CAAM,IAAA;;;;cCdT,YAAA"}

package/dist/lib/cli.mjs

@@ -1,28 +1,39 @@
-import { t as createEngine } from "./engine-B53whAlC.mjs";
+import { t as createEngine } from "./engine-CPKs9QbX.mjs";
 import { flow } from "es-toolkit";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/clean.ts
 const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
 /**
+* Clean a raw `.prompt` file into a render-ready template.
+*
+* Runs the source through a pipeline of transforms — currently
+* strips frontmatter, with more steps added over time.
+*
+* @param text - Raw `.prompt` file content including frontmatter.
+* @returns The cleaned template string, ready for rendering.
+* @example
+* ```ts
+* const template = clean("---\nname: greeting\n---\nHello {{ name }}!");
+* // "Hello {{ name }}!"
+* ```
+*/
+function clean(text) {
+	return pipeline(text);
+}
+/**
 * Remove YAML frontmatter from the beginning of a string.
 *
 * Frontmatter is a block delimited by `---` at the start of the file.
 * If no frontmatter is present, the string is returned unchanged.
+*
+* @private
 */
 function stripFrontmatter(text) {
 	return text.replace(FRONTMATTER_RE, "");
 }
+/** @private */
 const pipeline = flow(stripFrontmatter);
-/**
-* Clean a raw `.prompt` file into a render-ready template.
-*
-* Runs the source through a pipeline of transforms — currently
-* strips frontmatter, with more steps added over time.
-*/
-function clean(text) {
-	return pipeline(text);
-}
 //#endregion
 //#region src/partials-dir.ts
 /** Absolute path to the SDK's built-in partials directory. */

package/dist/lib/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../../src/clean.ts","../../src/partials-dir.ts"],"sourcesContent":["import { flow } from \"es-toolkit\";\n\nconst FRONTMATTER_RE = /^---\\r?\\n[\\s\\S]*?\\r?\\n---\\r?\\n?/;\n\n/**\n * Remove YAML frontmatter from the beginning of a string.\n *\n * Frontmatter is a block delimited by `---` at the start of the file.\n * If no frontmatter is present, the string is returned unchanged.\n */\nfunction stripFrontmatter(text: string): string {\n  return text.replace(FRONTMATTER_RE, \"\");\n}\n\nconst pipeline = flow(stripFrontmatter);\n\n/**\n * Clean a raw `.prompt` file into a render-ready template.\n *\n * Runs the source through a pipeline of transforms — currently\n * strips frontmatter, with more steps added over time.\n */\nexport function clean(text: string): string {\n  return pipeline(text);\n}\n","import { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** Absolute path to the SDK's built-in partials directory. */\nexport const PARTIALS_DIR = resolve(dirname(fileURLToPath(import.meta.url)), \"../prompts\");\n"],"mappings":";;;;;AAEA,MAAM,iBAAiB;;;;;;;AAQvB,SAAS,iBAAiB,MAAsB;AAC9C,QAAO,KAAK,QAAQ,gBAAgB,GAAG;;AAGzC,MAAM,WAAW,KAAK,iBAAiB;;;;;;;AAQvC,SAAgB,MAAM,MAAsB;AAC1C,QAAO,SAAS,KAAK;;;;;ACnBvB,MAAa,eAAe,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EAAE,aAAa"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../../src/clean.ts","../../src/partials-dir.ts"],"sourcesContent":["import { flow } from \"es-toolkit\";\n\nconst FRONTMATTER_RE = /^---\\r?\\n[\\s\\S]*?\\r?\\n---\\r?\\n?/;\n\n/**\n * Clean a raw `.prompt` file into a render-ready template.\n *\n * Runs the source through a pipeline of transforms — currently\n * strips frontmatter, with more steps added over time.\n *\n * @param text - Raw `.prompt` file content including frontmatter.\n * @returns The cleaned template string, ready for rendering.\n * @example\n * ```ts\n * const template = clean(\"---\\nname: greeting\\n---\\nHello {{ name }}!\");\n * // \"Hello {{ name }}!\"\n * ```\n */\nexport function clean(text: string): string {\n  return pipeline(text);\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Remove YAML frontmatter from the beginning of a string.\n *\n * Frontmatter is a block delimited by `---` at the start of the file.\n * If no frontmatter is present, the string is returned unchanged.\n *\n * @private\n */\nfunction stripFrontmatter(text: string): string {\n  return text.replace(FRONTMATTER_RE, \"\");\n}\n\n/** @private */\nconst pipeline = flow(stripFrontmatter);\n","import { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** Absolute path to the SDK's built-in partials directory. */\nexport const PARTIALS_DIR = resolve(dirname(fileURLToPath(import.meta.url)), \"../prompts\");\n"],"mappings":";;;;;AAEA,MAAM,iBAAiB;;;;;;;;;;;;;;;AAgBvB,SAAgB,MAAM,MAAsB;AAC1C,QAAO,SAAS,KAAK;;;;;;;;;;AAevB,SAAS,iBAAiB,MAAsB;AAC9C,QAAO,KAAK,QAAQ,gBAAgB,GAAG;;;AAIzC,MAAM,WAAW,KAAK,iBAAiB;;;;ACnCvC,MAAa,eAAe,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EAAE,aAAa"}

package/dist/lib/{engine-B53whAlC.mjs → engine-CPKs9QbX.mjs}

@@ -16,9 +16,9 @@ function createEngine(partialsDir, options) {
 		partials: [partialsDir],
 		extname: ".prompt",
 		cache: true,
+		...options,
 		strictFilters: true,
-		ownPropertyOnly: true,
-		...options
+		ownPropertyOnly: true
 	});
 }
 /**
@@ -27,6 +27,8 @@ function createEngine(partialsDir, options) {
 * Partials are flattened at codegen time by the CLI, so this engine
 * only needs to handle `{{ var }}` expressions and basic Liquid
 * control flow (`{% if %}`, `{% for %}`). No filesystem access required.
+*
+* @type {Liquid}
 */
 const liquidEngine = new Liquid({
 	strictFilters: true,
@@ -35,4 +37,4 @@ const liquidEngine = new Liquid({
 //#endregion
 export { liquidEngine as n, createEngine as t };
 
-//# sourceMappingURL=engine-B53whAlC.mjs.map
+//# sourceMappingURL=engine-CPKs9QbX.mjs.map

package/dist/lib/engine-CPKs9QbX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-CPKs9QbX.mjs","names":[],"sources":["../../src/engine.ts"],"sourcesContent":["import { Liquid } from \"liquidjs\";\n\nimport type { CreateEngineOptions } from \"./types.js\";\n\n/**\n * Create a LiquidJS engine with custom options.\n *\n * The `partialsDir` is used as the root for `{% render %}` resolution.\n * The `.prompt` extension is appended automatically.\n *\n * @param partialsDir - Root directory for `{% render %}` partial resolution.\n * @param options - Optional overrides for the LiquidJS engine configuration.\n * @returns A configured {@link Liquid} engine instance.\n */\nexport function createEngine(partialsDir: string, options?: Partial<CreateEngineOptions>): Liquid {\n  return new Liquid({\n    root: [partialsDir],\n    partials: [partialsDir],\n    extname: \".prompt\",\n    cache: true,\n    ...options,\n    // Safety defaults — applied after spread so callers cannot disable them\n    strictFilters: true,\n    ownPropertyOnly: true,\n  });\n}\n\n/**\n * Shared LiquidJS engine for rendering prompt templates at runtime.\n *\n * Partials are flattened at codegen time by the CLI, so this engine\n * only needs to handle `{{ var }}` expressions and basic Liquid\n * control flow (`{% if %}`, `{% for %}`). No filesystem access required.\n *\n * @type {Liquid}\n */\nexport const liquidEngine = new Liquid({\n  strictFilters: true,\n  ownPropertyOnly: true,\n});\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,aAAa,aAAqB,SAAgD;AAChG,QAAO,IAAI,OAAO;EAChB,MAAM,CAAC,YAAY;EACnB,UAAU,CAAC,YAAY;EACvB,SAAS;EACT,OAAO;EACP,GAAG;EAEH,eAAe;EACf,iBAAiB;EAClB,CAAC;;;;;;;;;;;AAYJ,MAAa,eAAe,IAAI,OAAO;CACrC,eAAe;CACf,iBAAiB;CAClB,CAAC"}

package/dist/lib/{engine-B6JHetwb.d.mts → engine-CQfJbVz6.d.mts}

@@ -1,4 +1,4 @@
-import { t as CreateEngineOptions } from "./types-CiSdNM0W.mjs";
+import { t as CreateEngineOptions } from "./types-2PI_9h-M.mjs";
 import { Liquid } from "liquidjs";
 
 //#region src/engine.d.ts
@@ -19,8 +19,10 @@ declare function createEngine(partialsDir: string, options?: Partial<CreateEngin
  * Partials are flattened at codegen time by the CLI, so this engine
  * only needs to handle `{{ var }}` expressions and basic Liquid
  * control flow (`{% if %}`, `{% for %}`). No filesystem access required.
+ *
+ * @type {Liquid}
  */
 declare const liquidEngine: Liquid;
 //#endregion
 export { liquidEngine as n, createEngine as t };
-//# sourceMappingURL=engine-B6JHetwb.d.mts.map
+//# sourceMappingURL=engine-CQfJbVz6.d.mts.map

package/dist/lib/{engine-B6JHetwb.d.mts.map → engine-CQfJbVz6.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"engine-B6JHetwb.d.mts","names":[],"sources":["../../src/engine.ts"],"mappings":";;;;;;AAcA;;;;;;;;iBAAgB,YAAA,CAAa,WAAA,UAAqB,OAAA,GAAU,OAAA,CAAQ,mBAAA,IAAuB,MAAA;;;;;;;AAmB3F;cAAa,YAAA,EAAY,MAAA"}
+{"version":3,"file":"engine-CQfJbVz6.d.mts","names":[],"sources":["../../src/engine.ts"],"mappings":";;;;;;AAcA;;;;;;;;iBAAgB,YAAA,CAAa,WAAA,UAAqB,OAAA,GAAU,OAAA,CAAQ,mBAAA,IAAuB,MAAA;;;;;;;AAsB3F;;;cAAa,YAAA,EAAY,MAAA"}

package/dist/lib/index.d.mts

@@ -1,4 +1,4 @@
-import { a as PromptRegistry, i as PromptNamespace, r as PromptModule } from "./types-CiSdNM0W.mjs";
+import { a as PromptRegistry, i as PromptNamespace, r as PromptModule } from "./types-2PI_9h-M.mjs";
 
 //#region src/registry.d.ts
 /**

package/dist/lib/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/registry.ts"],"mappings":";;;;;AA8DA;;;;;;;;;;;;;;;;;iBAAgB,oBAAA,WAA+B,eAAA,CAAA,CAAiB,OAAA,EAAS,CAAA,GAAI,cAAA,CAAe,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/registry.ts"],"mappings":";;;;;AAqBA;;;;;;;;;;;;;;;;;iBAAgB,oBAAA,WAA+B,eAAA,CAAA,CAAiB,OAAA,EAAS,CAAA,GAAI,cAAA,CAAe,CAAA"}

package/dist/lib/index.mjs

@@ -1,31 +1,5 @@
 //#region src/registry.ts
 /**
-* Check whether a value looks like a PromptModule leaf.
-* Leaves have `name`, `schema`, and `render` — namespaces do not.
-*
-* @private
-*/
-function isPromptModule(value) {
-	return typeof value === "object" && value !== null && "render" in value && "schema" in value && "name" in value;
-}
-/**
-* Recursively freeze a prompt namespace tree.
-* Only recurses into plain namespace nodes — PromptModule leaves
-* (which contain Zod schemas) are frozen shallowly.
-*
-* @param obj - The namespace object to freeze.
-* @returns The frozen object cast to its deep-readonly type.
-*
-* @private
-*/
-function deepFreeze(obj) {
-	Object.freeze(obj);
-	Object.values(obj).forEach((value) => {
-		if (typeof value === "object" && value !== null && !Object.isFrozen(value) && !isPromptModule(value)) deepFreeze(value);
-	});
-	return obj;
-}
-/**
 * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.
 *
 * The registry is typically created by generated code — the CLI produces
@@ -47,6 +21,31 @@ function deepFreeze(obj) {
 function createPromptRegistry(modules) {
 	return deepFreeze({ ...modules });
 }
+/**
+* Check whether a value looks like a PromptModule leaf.
+* Leaves have `name`, `schema`, and `render` — namespaces do not.
+*
+* @private
+*/
+function isPromptModule(value) {
+	return typeof value === "object" && value !== null && "render" in value && "schema" in value && "name" in value;
+}
+/**
+* Recursively freeze a prompt namespace tree.
+* Only recurses into plain namespace nodes — PromptModule leaves
+* (which contain Zod schemas) are intentionally left unfrozen
+* to avoid breaking Zod internal state.
+*
+* @param obj - The namespace object to freeze.
+* @returns The frozen object cast to its deep-readonly type.
+*
+* @private
+*/
+function deepFreeze(obj) {
+	Object.freeze(obj);
+	for (const value of Object.values(obj)) if (typeof value === "object" && value !== null && !Object.isFrozen(value) && !isPromptModule(value)) deepFreeze(value);
+	return obj;
+}
 //#endregion
 export { createPromptRegistry };
 

package/dist/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/registry.ts"],"sourcesContent":["import type { PromptModule, PromptNamespace, PromptRegistry } from \"./types.js\";\n\n/**\n * Check whether a value looks like a PromptModule leaf.\n * Leaves have `name`, `schema`, and `render` — namespaces do not.\n *\n * @private\n */\nfunction isPromptModule(value: unknown): value is PromptModule {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"render\" in value &&\n    \"schema\" in value &&\n    \"name\" in value\n  );\n}\n\n/**\n * Recursively freeze a prompt namespace tree.\n * Only recurses into plain namespace nodes — PromptModule leaves\n * (which contain Zod schemas) are frozen shallowly.\n *\n * @param obj - The namespace object to freeze.\n * @returns The frozen object cast to its deep-readonly type.\n *\n * @private\n */\nfunction deepFreeze<T extends PromptNamespace>(obj: T): PromptRegistry<T> {\n  Object.freeze(obj);\n  Object.values(obj).forEach((value) => {\n    if (\n      typeof value === \"object\" &&\n      value !== null &&\n      !Object.isFrozen(value) &&\n      !isPromptModule(value)\n    ) {\n      deepFreeze(value as PromptNamespace);\n    }\n  });\n  return obj as PromptRegistry<T>;\n}\n\n/**\n * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.\n *\n * The registry is typically created by generated code — the CLI produces\n * an `index.ts` that calls `createPromptRegistry()` with all discovered\n * prompt modules keyed by camelCase name, nested by group.\n *\n * @param modules - Record mapping camelCase prompt names (or group namespaces) to their modules.\n * @returns A deep-frozen, typed record with direct property access.\n *\n * @example\n * ```ts\n * const prompts = createPromptRegistry({\n *   agents: { coverageAssessor },\n *   greeting,\n * })\n * prompts.agents.coverageAssessor.render({ scope: 'full' })\n * ```\n */\nexport function createPromptRegistry<T extends PromptNamespace>(modules: T): PromptRegistry<T> {\n  return deepFreeze({ ...modules });\n}\n"],"mappings":";;;;;;;AAQA,SAAS,eAAe,OAAuC;AAC7D,QACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,YAAY,SACZ,UAAU;;;;;;;;;;;;AAcd,SAAS,WAAsC,KAA2B;AACxE,QAAO,OAAO,IAAI;AAClB,QAAO,OAAO,IAAI,CAAC,SAAS,UAAU;AACpC,MACE,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,OAAO,SAAS,MAAM,IACvB,CAAC,eAAe,MAAM,CAEtB,YAAW,MAAyB;GAEtC;AACF,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,SAAgB,qBAAgD,SAA+B;AAC7F,QAAO,WAAW,EAAE,GAAG,SAAS,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/registry.ts"],"sourcesContent":["import type { PromptModule, PromptNamespace, PromptRegistry } from \"./types.js\";\n\n/**\n * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.\n *\n * The registry is typically created by generated code — the CLI produces\n * an `index.ts` that calls `createPromptRegistry()` with all discovered\n * prompt modules keyed by camelCase name, nested by group.\n *\n * @param modules - Record mapping camelCase prompt names (or group namespaces) to their modules.\n * @returns A deep-frozen, typed record with direct property access.\n *\n * @example\n * ```ts\n * const prompts = createPromptRegistry({\n *   agents: { coverageAssessor },\n *   greeting,\n * })\n * prompts.agents.coverageAssessor.render({ scope: 'full' })\n * ```\n */\nexport function createPromptRegistry<T extends PromptNamespace>(modules: T): PromptRegistry<T> {\n  return deepFreeze({ ...modules });\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Check whether a value looks like a PromptModule leaf.\n * Leaves have `name`, `schema`, and `render` — namespaces do not.\n *\n * @private\n */\nfunction isPromptModule(value: unknown): value is PromptModule {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"render\" in value &&\n    \"schema\" in value &&\n    \"name\" in value\n  );\n}\n\n/**\n * Recursively freeze a prompt namespace tree.\n * Only recurses into plain namespace nodes — PromptModule leaves\n * (which contain Zod schemas) are intentionally left unfrozen\n * to avoid breaking Zod internal state.\n *\n * @param obj - The namespace object to freeze.\n * @returns The frozen object cast to its deep-readonly type.\n *\n * @private\n */\nfunction deepFreeze<T extends PromptNamespace>(obj: T): PromptRegistry<T> {\n  Object.freeze(obj);\n  for (const value of Object.values(obj)) {\n    if (\n      typeof value === \"object\" &&\n      value !== null &&\n      !Object.isFrozen(value) &&\n      !isPromptModule(value)\n    ) {\n      deepFreeze(value as PromptNamespace);\n    }\n  }\n  return obj as PromptRegistry<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,qBAAgD,SAA+B;AAC7F,QAAO,WAAW,EAAE,GAAG,SAAS,CAAC;;;;;;;;AAanC,SAAS,eAAe,OAAuC;AAC7D,QACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,YAAY,SACZ,UAAU;;;;;;;;;;;;;AAed,SAAS,WAAsC,KAA2B;AACxE,QAAO,OAAO,IAAI;AAClB,MAAK,MAAM,SAAS,OAAO,OAAO,IAAI,CACpC,KACE,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,OAAO,SAAS,MAAM,IACvB,CAAC,eAAe,MAAM,CAEtB,YAAW,MAAyB;AAGxC,QAAO"}

package/dist/lib/runtime.d.mts

@@ -1,2 +1,2 @@
-import { n as liquidEngine } from "./engine-B6JHetwb.mjs";
+import { n as liquidEngine } from "./engine-CQfJbVz6.mjs";
 export { liquidEngine };

package/dist/lib/runtime.mjs

@@ -1,2 +1,2 @@
-import { n as liquidEngine } from "./engine-B53whAlC.mjs";
+import { n as liquidEngine } from "./engine-CPKs9QbX.mjs";
 export { liquidEngine };

package/dist/lib/{types-CiSdNM0W.d.mts → types-2PI_9h-M.d.mts}

@@ -5,7 +5,7 @@ import { ZodType } from "zod";
 /**
  * Options for creating a custom LiquidJS engine.
  */
-type CreateEngineOptions = Pick<LiquidOptions, "root" | "partials" | "extname" | "cache" | "strictFilters" | "strictVariables" | "ownPropertyOnly">;
+type CreateEngineOptions = Pick<LiquidOptions, "root" | "partials" | "extname" | "cache" | "strictVariables">;
 /**
  * A single prompt module produced by codegen.
  *
@@ -22,9 +22,9 @@ interface PromptModule<T = unknown> {
  * A nested namespace node in the prompt tree.
  * Values are either PromptModule leaves or further nested namespaces.
  */
-type PromptNamespace = {
+interface PromptNamespace {
   readonly [key: string]: PromptModule | PromptNamespace;
-};
+}
 /**
  * Deep-readonly version of a prompt tree.
  * Prevents reassignment at any nesting level.
@@ -40,4 +40,4 @@ type PromptNamespace = {
 type PromptRegistry<T extends PromptNamespace> = { readonly [K in keyof T]: T[K] extends PromptModule ? T[K] : T[K] extends PromptNamespace ? PromptRegistry<T[K]> : T[K] };
 //#endregion
 export { PromptRegistry as a, PromptNamespace as i, Liquid$1 as n, PromptModule as r, CreateEngineOptions as t };
-//# sourceMappingURL=types-CiSdNM0W.d.mts.map
+//# sourceMappingURL=types-2PI_9h-M.d.mts.map

package/dist/lib/types-2PI_9h-M.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-2PI_9h-M.d.mts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;;;AAMA;KAAY,mBAAA,GAAsB,IAAA,CAChC,aAAA;;;;AASF;;UAAiB,YAAA;EAAA,SACN,IAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA,EAAQ,OAAA,CAAQ,CAAA;EACzB,MAAA,CAAO,SAAA,EAAW,CAAA;EAClB,QAAA,CAAS,SAAA,YAAqB,CAAA;AAAA;;;;;UAOf,eAAA;EAAA,UACL,GAAA,WAAc,YAAA,GAAe,eAAA;AAAA;;;;;;;;AADzC;;;;;KAgBY,cAAA,WAAyB,eAAA,2BACd,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,YAAA,GAClC,CAAA,CAAE,CAAA,IACF,CAAA,CAAE,CAAA,UAAW,eAAA,GACX,cAAA,CAAe,CAAA,CAAE,CAAA,KACjB,CAAA,CAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funkai/prompts",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "Prompt SDK with LiquidJS templating and Zod validation",
   "keywords": [
@@ -37,6 +37,9 @@
       "import": "./dist/lib/cli.mjs"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "es-toolkit": "^1.45.1",
     "liquidjs": "^10.25.0",
@@ -45,7 +48,7 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^4.1.0",
-    "tsdown": "^0.21.3",
+    "tsdown": "^0.21.4",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },

package/src/clean.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 
 import { clean } from "@/clean.js";
 
-describe("clean", () => {
+describe(clean, () => {
   it("should strip YAML frontmatter from a prompt file", () => {
     const input = "---\nname: test-prompt\ngroup: agents\n---\nHello {{ name }}";
     expect(clean(input)).toBe("Hello {{ name }}");

package/src/clean.ts

@@ -2,24 +2,39 @@ import { flow } from "es-toolkit";
 
 const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
 
+/**
+ * Clean a raw `.prompt` file into a render-ready template.
+ *
+ * Runs the source through a pipeline of transforms — currently
+ * strips frontmatter, with more steps added over time.
+ *
+ * @param text - Raw `.prompt` file content including frontmatter.
+ * @returns The cleaned template string, ready for rendering.
+ * @example
+ * ```ts
+ * const template = clean("---\nname: greeting\n---\nHello {{ name }}!");
+ * // "Hello {{ name }}!"
+ * ```
+ */
+export function clean(text: string): string {
+  return pipeline(text);
+}
+
+// ---------------------------------------------------------------------------
+// Private
+// ---------------------------------------------------------------------------
+
 /**
  * Remove YAML frontmatter from the beginning of a string.
  *
  * Frontmatter is a block delimited by `---` at the start of the file.
  * If no frontmatter is present, the string is returned unchanged.
+ *
+ * @private
  */
 function stripFrontmatter(text: string): string {
   return text.replace(FRONTMATTER_RE, "");
 }
 
+/** @private */
 const pipeline = flow(stripFrontmatter);
-
-/**
- * Clean a raw `.prompt` file into a render-ready template.
- *
- * Runs the source through a pipeline of transforms — currently
- * strips frontmatter, with more steps added over time.
- */
-export function clean(text: string): string {
-  return pipeline(text);
-}

package/src/engine.test.ts

@@ -3,7 +3,7 @@ import { describe, expect, it } from "vitest";
 
 import { createEngine, liquidEngine } from "@/engine.js";
 
-describe("createEngine", () => {
+describe(createEngine, () => {
   it("should return a Liquid instance", () => {
     const eng = createEngine("/tmp/test-partials");
     expect(eng).toBeInstanceOf(Liquid);
@@ -18,15 +18,20 @@ describe("createEngine", () => {
   it("should merge custom options with defaults", () => {
     const eng = createEngine("/tmp/test-partials", {
       cache: false,
-      strictFilters: false,
     });
-    // Should not throw on unknown filter when strictFilters is disabled
-    const result = eng.parseAndRenderSync("{{ name | nonexistent }}", { name: "test" });
-    expect(result).toBe("test");
+    const result = eng.parseAndRenderSync("Hello {{ name }}", { name: "World" });
+    expect(result).toBe("Hello World");
+  });
+
+  it("should enforce strictFilters regardless of options", () => {
+    const eng = createEngine("/tmp/test-partials");
+    expect(() => {
+      eng.parseAndRenderSync("{{ name | bogus }}", { name: "test" });
+    }).toThrow();
   });
 });
 
-describe("liquidEngine", () => {
+describe("liquidEngine instance", () => {
   it("should be a Liquid instance", () => {
     expect(liquidEngine).toBeInstanceOf(Liquid);
   });

package/src/engine.ts

@@ -18,9 +18,10 @@ export function createEngine(partialsDir: string, options?: Partial<CreateEngine
     partials: [partialsDir],
     extname: ".prompt",
     cache: true,
+    ...options,
+    // Safety defaults — applied after spread so callers cannot disable them
     strictFilters: true,
     ownPropertyOnly: true,
-    ...options,
   });
 }
 
@@ -30,6 +31,8 @@ export function createEngine(partialsDir: string, options?: Partial<CreateEngine
  * Partials are flattened at codegen time by the CLI, so this engine
  * only needs to handle `{{ var }}` expressions and basic Liquid
  * control flow (`{% if %}`, `{% for %}`). No filesystem access required.
+ *
+ * @type {Liquid}
  */
 export const liquidEngine = new Liquid({
   strictFilters: true,

package/src/partials-dir.test.ts

@@ -4,9 +4,9 @@ import { describe, expect, it } from "vitest";
 
 import { PARTIALS_DIR } from "@/partials-dir.js";
 
-describe("PARTIALS_DIR", () => {
+describe(PARTIALS_DIR, () => {
   it("should be an absolute path", () => {
-    expect(isAbsolute(PARTIALS_DIR)).toBe(true);
+    expect(isAbsolute(PARTIALS_DIR)).toBeTruthy();
   });
 
   it("should point to the prompts directory", () => {

package/src/registry.test.ts

@@ -27,7 +27,7 @@ const emptyPrompt = {
   },
 };
 
-describe("createPromptRegistry", () => {
+describe(createPromptRegistry, () => {
   it("should provide dot-access to a registered prompt", () => {
     const registry = createPromptRegistry({ testPrompt: mockPrompt });
     expect(registry.testPrompt.name).toBe("test-prompt");
@@ -44,14 +44,14 @@ describe("createPromptRegistry", () => {
 
   it("should freeze the top-level registry object", () => {
     const registry = createPromptRegistry({ testPrompt: mockPrompt });
-    expect(Object.isFrozen(registry)).toBe(true);
+    expect(Object.isFrozen(registry)).toBeTruthy();
   });
 
   it("should freeze nested namespace objects", () => {
     const registry = createPromptRegistry({
       agents: { testPrompt: mockPrompt },
     });
-    expect(Object.isFrozen(registry.agents)).toBe(true);
+    expect(Object.isFrozen(registry.agents)).toBeTruthy();
   });
 
   it("should expose all keys via Object.keys", () => {

package/src/registry.ts

@@ -1,5 +1,32 @@
 import type { PromptModule, PromptNamespace, PromptRegistry } from "./types.js";
 
+/**
+ * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.
+ *
+ * The registry is typically created by generated code — the CLI produces
+ * an `index.ts` that calls `createPromptRegistry()` with all discovered
+ * prompt modules keyed by camelCase name, nested by group.
+ *
+ * @param modules - Record mapping camelCase prompt names (or group namespaces) to their modules.
+ * @returns A deep-frozen, typed record with direct property access.
+ *
+ * @example
+ * ```ts
+ * const prompts = createPromptRegistry({
+ *   agents: { coverageAssessor },
+ *   greeting,
+ * })
+ * prompts.agents.coverageAssessor.render({ scope: 'full' })
+ * ```
+ */
+export function createPromptRegistry<T extends PromptNamespace>(modules: T): PromptRegistry<T> {
+  return deepFreeze({ ...modules });
+}
+
+// ---------------------------------------------------------------------------
+// Private
+// ---------------------------------------------------------------------------
+
 /**
  * Check whether a value looks like a PromptModule leaf.
  * Leaves have `name`, `schema`, and `render` — namespaces do not.
@@ -19,7 +46,8 @@ function isPromptModule(value: unknown): value is PromptModule {
 /**
  * Recursively freeze a prompt namespace tree.
  * Only recurses into plain namespace nodes — PromptModule leaves
- * (which contain Zod schemas) are frozen shallowly.
+ * (which contain Zod schemas) are intentionally left unfrozen
+ * to avoid breaking Zod internal state.
  *
  * @param obj - The namespace object to freeze.
  * @returns The frozen object cast to its deep-readonly type.
@@ -28,7 +56,7 @@ function isPromptModule(value: unknown): value is PromptModule {
  */
 function deepFreeze<T extends PromptNamespace>(obj: T): PromptRegistry<T> {
   Object.freeze(obj);
-  Object.values(obj).forEach((value) => {
+  for (const value of Object.values(obj)) {
     if (
       typeof value === "object" &&
       value !== null &&
@@ -37,29 +65,6 @@ function deepFreeze<T extends PromptNamespace>(obj: T): PromptRegistry<T> {
     ) {
       deepFreeze(value as PromptNamespace);
     }
-  });
+  }
   return obj as PromptRegistry<T>;
 }
-
-/**
- * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.
- *
- * The registry is typically created by generated code — the CLI produces
- * an `index.ts` that calls `createPromptRegistry()` with all discovered
- * prompt modules keyed by camelCase name, nested by group.
- *
- * @param modules - Record mapping camelCase prompt names (or group namespaces) to their modules.
- * @returns A deep-frozen, typed record with direct property access.
- *
- * @example
- * ```ts
- * const prompts = createPromptRegistry({
- *   agents: { coverageAssessor },
- *   greeting,
- * })
- * prompts.agents.coverageAssessor.render({ scope: 'full' })
- * ```
- */
-export function createPromptRegistry<T extends PromptNamespace>(modules: T): PromptRegistry<T> {
-  return deepFreeze({ ...modules });
-}

package/src/types.ts

@@ -6,13 +6,7 @@ import type { ZodType } from "zod";
  */
 export type CreateEngineOptions = Pick<
   LiquidOptions,
-  | "root"
-  | "partials"
-  | "extname"
-  | "cache"
-  | "strictFilters"
-  | "strictVariables"
-  | "ownPropertyOnly"
+  "root" | "partials" | "extname" | "cache" | "strictVariables"
 >;
 
 /**
@@ -32,9 +26,9 @@ export interface PromptModule<T = unknown> {
  * A nested namespace node in the prompt tree.
  * Values are either PromptModule leaves or further nested namespaces.
  */
-export type PromptNamespace = {
+export interface PromptNamespace {
   readonly [key: string]: PromptModule | PromptNamespace;
-};
+}
 
 /**
  * Deep-readonly version of a prompt tree.

package/tsconfig.json

@@ -18,7 +18,8 @@
     "rootDir": ".",
     "paths": {
       "@/*": ["./src/*"]
-    }
+    },
+    "types": ["node"]
   },
   "include": ["src"],
   "exclude": ["node_modules", "dist"]

package/dist/lib/engine-B53whAlC.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-B53whAlC.mjs","names":[],"sources":["../../src/engine.ts"],"sourcesContent":["import { Liquid } from \"liquidjs\";\n\nimport type { CreateEngineOptions } from \"./types.js\";\n\n/**\n * Create a LiquidJS engine with custom options.\n *\n * The `partialsDir` is used as the root for `{% render %}` resolution.\n * The `.prompt` extension is appended automatically.\n *\n * @param partialsDir - Root directory for `{% render %}` partial resolution.\n * @param options - Optional overrides for the LiquidJS engine configuration.\n * @returns A configured {@link Liquid} engine instance.\n */\nexport function createEngine(partialsDir: string, options?: Partial<CreateEngineOptions>): Liquid {\n  return new Liquid({\n    root: [partialsDir],\n    partials: [partialsDir],\n    extname: \".prompt\",\n    cache: true,\n    strictFilters: true,\n    ownPropertyOnly: true,\n    ...options,\n  });\n}\n\n/**\n * Shared LiquidJS engine for rendering prompt templates at runtime.\n *\n * Partials are flattened at codegen time by the CLI, so this engine\n * only needs to handle `{{ var }}` expressions and basic Liquid\n * control flow (`{% if %}`, `{% for %}`). No filesystem access required.\n */\nexport const liquidEngine = new Liquid({\n  strictFilters: true,\n  ownPropertyOnly: true,\n});\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,aAAa,aAAqB,SAAgD;AAChG,QAAO,IAAI,OAAO;EAChB,MAAM,CAAC,YAAY;EACnB,UAAU,CAAC,YAAY;EACvB,SAAS;EACT,OAAO;EACP,eAAe;EACf,iBAAiB;EACjB,GAAG;EACJ,CAAC;;;;;;;;;AAUJ,MAAa,eAAe,IAAI,OAAO;CACrC,eAAe;CACf,iBAAiB;CAClB,CAAC"}

package/dist/lib/types-CiSdNM0W.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-CiSdNM0W.d.mts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;;;AAMA;KAAY,mBAAA,GAAsB,IAAA,CAChC,aAAA;;;;AAeF;;UAAiB,YAAA;EAAA,SACN,IAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA,EAAQ,OAAA,CAAQ,CAAA;EACzB,MAAA,CAAO,SAAA,EAAW,CAAA;EAClB,QAAA,CAAS,SAAA,YAAqB,CAAA;AAAA;;;;;KAOpB,eAAA;EAAA,UACA,GAAA,WAAc,YAAA,GAAe,eAAA;AAAA;;;;;;;;AADzC;;;;;KAgBY,cAAA,WAAyB,eAAA,2BACd,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,YAAA,GAClC,CAAA,CAAE,CAAA,IACF,CAAA,CAAE,CAAA,UAAW,eAAA,GACX,cAAA,CAAe,CAAA,CAAE,CAAA,KACjB,CAAA,CAAE,CAAA"}