@funkai/prompts 0.1.1 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,16 +1,28 @@
 
-> @funkai/prompts@0.1.1 build /home/runner/work/funkai/funkai/packages/prompts
+> @funkai/prompts@0.2.0 build /home/runner/work/funkai/funkai/packages/prompts
 > tsdown && cp -r src/prompts dist/prompts
 
-ℹ tsdown v0.21.2 powered by rolldown v1.0.0-rc.9
+ℹ tsdown v0.21.3 powered by rolldown v1.0.0-rc.9
 ℹ config file: /home/runner/work/funkai/funkai/packages/prompts/tsdown.config.ts 
-ℹ entry: src/index.ts
+ℹ entry: src/index.ts, src/runtime.ts, src/cli.ts
 ℹ target: node22
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/lib/index.mjs        3.71 kB │ gzip: 1.65 kB
-ℹ dist/lib/index.mjs.map    5.24 kB │ gzip: 2.18 kB
-ℹ dist/lib/index.d.mts.map  0.89 kB │ gzip: 0.42 kB
-ℹ dist/lib/index.d.mts      3.62 kB │ gzip: 1.49 kB
-ℹ 4 files, total: 13.46 kB
-✔ Build complete in 1855ms
+ℹ dist/lib/index.mjs                  1.66 kB │ gzip: 0.80 kB
+ℹ dist/lib/cli.mjs                    1.10 kB │ gzip: 0.63 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.d.mts                1.04 kB │ gzip: 0.54 kB
+ℹ dist/lib/cli.d.mts                  0.68 kB │ gzip: 0.41 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

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @funkai/prompts
 
+## 0.2.0
+
+### Minor Changes
+
+- 8b89d9c: Simplify API surface across all packages: replace OpenRouter-specific provider layer with generic registry pattern, streamline agent internals, and restructure prompt entry points.
+
+  Migration notes:
+
+  - `@funkai/agents`: `AgentConfig.resolver` is replaced by `AgentConfig.registry`.
+  - `@funkai/models`: OpenRouter-specific provider exports (`openrouter.ts`, `resolver.ts`) were removed in favor of `createProviderRegistry` and `ProviderRegistry`.
+  - `@funkai/prompts`: Runtime helpers moved to `@funkai/prompts/runtime`, CLI helpers moved to `@funkai/prompts/cli`.
+
+## 0.1.2
+
+### Patch Changes
+
+- 153c393: refactor: deep review cleanup across all packages
+
+  - **@funkai/agents**: Remove dead code (`resolve.ts`, `attempt.ts`), fix stale "Workflow" JSDoc references, deduplicate `buildOnFinishHandler`, complete `writeLog` JSDoc, remove orphaned `ResolveParam` export
+  - **@funkai/models**: Export missing `ProviderFactory` and `ProviderMap` types, convert per-provider `*Model()` lookup from O(n) `.find()` to O(1) Map, fix floating-point precision artifacts in generated pricing data
+  - **@funkai/prompts**: Rename generic `engine` export to `liquidEngine` for clarity
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/lib/cli.d.mts

@@ -0,0 +1,18 @@
+import { n as Liquid, t as CreateEngineOptions } from "./types-CiSdNM0W.mjs";
+import { t as createEngine } from "./engine-B6JHetwb.mjs";
+
+//#region src/clean.d.ts
+/**
+ * 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.
+ */
+declare function clean(text: string): string;
+//#endregion
+//#region src/partials-dir.d.ts
+/** Absolute path to the SDK's built-in partials directory. */
+declare const PARTIALS_DIR: string;
+//#endregion
+export { type CreateEngineOptions, type Liquid, PARTIALS_DIR, clean, createEngine };
+//# sourceMappingURL=cli.d.mts.map

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

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

package/dist/lib/cli.mjs

@@ -0,0 +1,33 @@
+import { t as createEngine } from "./engine-B53whAlC.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?/;
+/**
+* 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.
+*/
+function stripFrontmatter(text) {
+	return text.replace(FRONTMATTER_RE, "");
+}
+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. */
+const PARTIALS_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "../prompts");
+//#endregion
+export { PARTIALS_DIR, clean, createEngine };
+
+//# sourceMappingURL=cli.mjs.map

package/dist/lib/cli.mjs.map

@@ -0,0 +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"}

package/dist/lib/engine-B53whAlC.mjs

@@ -0,0 +1,38 @@
+import { Liquid } from "liquidjs";
+//#region src/engine.ts
+/**
+* Create a LiquidJS engine with custom options.
+*
+* The `partialsDir` is used as the root for `{% render %}` resolution.
+* The `.prompt` extension is appended automatically.
+*
+* @param partialsDir - Root directory for `{% render %}` partial resolution.
+* @param options - Optional overrides for the LiquidJS engine configuration.
+* @returns A configured {@link Liquid} engine instance.
+*/
+function createEngine(partialsDir, options) {
+	return new Liquid({
+		root: [partialsDir],
+		partials: [partialsDir],
+		extname: ".prompt",
+		cache: true,
+		strictFilters: true,
+		ownPropertyOnly: true,
+		...options
+	});
+}
+/**
+* Shared LiquidJS engine for rendering prompt templates at runtime.
+*
+* 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.
+*/
+const liquidEngine = new Liquid({
+	strictFilters: true,
+	ownPropertyOnly: true
+});
+//#endregion
+export { liquidEngine as n, createEngine as t };
+
+//# sourceMappingURL=engine-B53whAlC.mjs.map

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

@@ -0,0 +1 @@
+{"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/engine-B6JHetwb.d.mts

@@ -0,0 +1,26 @@
+import { t as CreateEngineOptions } from "./types-CiSdNM0W.mjs";
+import { Liquid } from "liquidjs";
+
+//#region src/engine.d.ts
+/**
+ * Create a LiquidJS engine with custom options.
+ *
+ * The `partialsDir` is used as the root for `{% render %}` resolution.
+ * The `.prompt` extension is appended automatically.
+ *
+ * @param partialsDir - Root directory for `{% render %}` partial resolution.
+ * @param options - Optional overrides for the LiquidJS engine configuration.
+ * @returns A configured {@link Liquid} engine instance.
+ */
+declare function createEngine(partialsDir: string, options?: Partial<CreateEngineOptions>): Liquid;
+/**
+ * Shared LiquidJS engine for rendering prompt templates at runtime.
+ *
+ * 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.
+ */
+declare const liquidEngine: Liquid;
+//#endregion
+export { liquidEngine as n, createEngine as t };
+//# sourceMappingURL=engine-B6JHetwb.d.mts.map

package/dist/lib/engine-B6JHetwb.d.mts.map

@@ -0,0 +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"}

package/dist/lib/index.d.mts

@@ -1,78 +1,5 @@
-import { Liquid, Liquid as Liquid$1, LiquidOptions } from "liquidjs";
-import { ZodType } from "zod";
+import { a as PromptRegistry, i as PromptNamespace, r as PromptModule } from "./types-CiSdNM0W.mjs";
 
-//#region src/types.d.ts
-/**
- * Options for creating a custom LiquidJS engine.
- */
-type CreateEngineOptions = Pick<LiquidOptions, "root" | "partials" | "extname" | "cache" | "strictFilters" | "strictVariables" | "ownPropertyOnly">;
-/**
- * A single prompt module produced by codegen.
- *
- * Each `.prompt` file generates a default export conforming to this shape.
- */
-interface PromptModule<T = unknown> {
-  readonly name: string;
-  readonly group: string | undefined;
-  readonly schema: ZodType<T>;
-  render(variables: T): string;
-  validate(variables: unknown): T;
-}
-/**
- * A nested namespace node in the prompt tree.
- * Values are either PromptModule leaves or further nested namespaces.
- */
-type PromptNamespace = {
-  readonly [key: string]: PromptModule | PromptNamespace;
-};
-/**
- * Deep-readonly version of a prompt tree.
- * Prevents reassignment at any nesting level.
- *
- * @example
- * ```ts
- * type MyRegistry = PromptRegistry<{
- *   agents: { coverageAssessor: PromptModule }
- *   greeting: PromptModule
- * }>
- * ```
- */
-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
-//#region src/engine.d.ts
-/**
- * Create a LiquidJS engine with custom options.
- *
- * The `partialsDir` is used as the root for `{% render %}` resolution.
- * The `.prompt` extension is appended automatically.
- *
- * @param partialsDir - Root directory for `{% render %}` partial resolution.
- * @param options - Optional overrides for the LiquidJS engine configuration.
- * @returns A configured {@link Liquid} engine instance.
- */
-declare function createEngine(partialsDir: string, options?: Partial<CreateEngineOptions>): Liquid$1;
-/**
- * Shared LiquidJS engine for rendering prompt templates at runtime.
- *
- * 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.
- */
-declare const engine: Liquid$1;
-//#endregion
-//#region src/clean.d.ts
-/**
- * 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.
- */
-declare function clean(text: string): string;
-//#endregion
-//#region src/partials-dir.d.ts
-/** Absolute path to the SDK's built-in partials directory. */
-declare const PARTIALS_DIR: string;
-//#endregion
 //#region src/registry.d.ts
 /**
  * Create a typed, frozen prompt registry from a (possibly nested) map of prompt modules.
@@ -95,5 +22,5 @@ declare const PARTIALS_DIR: string;
  */
 declare function createPromptRegistry<T extends PromptNamespace>(modules: T): PromptRegistry<T>;
 //#endregion
-export { type CreateEngineOptions, type Liquid, PARTIALS_DIR, type PromptModule, type PromptNamespace, type PromptRegistry, clean, createEngine, createPromptRegistry, engine };
+export { type PromptModule, type PromptNamespace, type PromptRegistry, createPromptRegistry };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types.ts","../../src/engine.ts","../../src/clean.ts","../../src/partials-dir.ts","../../src/registry.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;;;;;AAjDV;;;;;AAgBA;;;iBCRgB,YAAA,CAAa,WAAA,UAAqB,OAAA,GAAU,OAAA,CAAQ,mBAAA,IAAuB,QAAA;;;;;;;;cAmB9E,MAAA,EAAM,QAAA;;;;;;;AD3BnB;;iBEgBgB,KAAA,CAAM,IAAA;;;;cClBT,YAAA;;;;;;AHEb;;;;;AAgBA;;;;;;;;;;;iBIwCgB,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":";;;;;AA8DA;;;;;;;;;;;;;;;;;iBAAgB,oBAAA,WAA+B,eAAA,CAAA,CAAiB,OAAA,EAAS,CAAA,GAAI,cAAA,CAAe,CAAA"}

package/dist/lib/index.mjs

@@ -1,67 +1,3 @@
-import { Liquid } from "liquidjs";
-import { flow } from "es-toolkit";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-//#region src/engine.ts
-/**
-* Create a LiquidJS engine with custom options.
-*
-* The `partialsDir` is used as the root for `{% render %}` resolution.
-* The `.prompt` extension is appended automatically.
-*
-* @param partialsDir - Root directory for `{% render %}` partial resolution.
-* @param options - Optional overrides for the LiquidJS engine configuration.
-* @returns A configured {@link Liquid} engine instance.
-*/
-function createEngine(partialsDir, options) {
-	return new Liquid({
-		root: [partialsDir],
-		partials: [partialsDir],
-		extname: ".prompt",
-		cache: true,
-		strictFilters: true,
-		ownPropertyOnly: true,
-		...options
-	});
-}
-/**
-* Shared LiquidJS engine for rendering prompt templates at runtime.
-*
-* 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.
-*/
-const engine = new Liquid({
-	strictFilters: true,
-	ownPropertyOnly: true
-});
-//#endregion
-//#region src/clean.ts
-const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
-/**
-* 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.
-*/
-function stripFrontmatter(text) {
-	return text.replace(FRONTMATTER_RE, "");
-}
-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. */
-const PARTIALS_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "../prompts");
-//#endregion
 //#region src/registry.ts
 /**
 * Check whether a value looks like a PromptModule leaf.
@@ -112,6 +48,6 @@ function createPromptRegistry(modules) {
 	return deepFreeze({ ...modules });
 }
 //#endregion
-export { PARTIALS_DIR, clean, createEngine, createPromptRegistry, engine };
+export { createPromptRegistry };
 
 //# sourceMappingURL=index.mjs.map

package/dist/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/engine.ts","../../src/clean.ts","../../src/partials-dir.ts","../../src/registry.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 engine = new Liquid({\n  strictFilters: true,\n  ownPropertyOnly: true,\n});\n","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","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":";;;;;;;;;;;;;;;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,SAAS,IAAI,OAAO;CAC/B,eAAe;CACf,iBAAiB;CAClB,CAAC;;;AClCF,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;;;;;;;;;ACI1F,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 * 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"}

package/dist/lib/runtime.d.mts

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

package/dist/lib/runtime.mjs

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

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

@@ -0,0 +1,43 @@
+import { Liquid as Liquid$1, LiquidOptions } from "liquidjs";
+import { ZodType } from "zod";
+
+//#region src/types.d.ts
+/**
+ * Options for creating a custom LiquidJS engine.
+ */
+type CreateEngineOptions = Pick<LiquidOptions, "root" | "partials" | "extname" | "cache" | "strictFilters" | "strictVariables" | "ownPropertyOnly">;
+/**
+ * A single prompt module produced by codegen.
+ *
+ * Each `.prompt` file generates a default export conforming to this shape.
+ */
+interface PromptModule<T = unknown> {
+  readonly name: string;
+  readonly group: string | undefined;
+  readonly schema: ZodType<T>;
+  render(variables: T): string;
+  validate(variables: unknown): T;
+}
+/**
+ * A nested namespace node in the prompt tree.
+ * Values are either PromptModule leaves or further nested namespaces.
+ */
+type PromptNamespace = {
+  readonly [key: string]: PromptModule | PromptNamespace;
+};
+/**
+ * Deep-readonly version of a prompt tree.
+ * Prevents reassignment at any nesting level.
+ *
+ * @example
+ * ```ts
+ * type MyRegistry = PromptRegistry<{
+ *   agents: { coverageAssessor: PromptModule }
+ *   greeting: PromptModule
+ * }>
+ * ```
+ */
+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

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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funkai/prompts",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "private": false,
   "description": "Prompt SDK with LiquidJS templating and Zod validation",
   "keywords": [
@@ -27,6 +27,14 @@
     ".": {
       "types": "./dist/lib/index.d.mts",
       "import": "./dist/lib/index.mjs"
+    },
+    "./runtime": {
+      "types": "./dist/lib/runtime.d.mts",
+      "import": "./dist/lib/runtime.mjs"
+    },
+    "./cli": {
+      "types": "./dist/lib/cli.d.mts",
+      "import": "./dist/lib/cli.mjs"
     }
   },
   "dependencies": {
@@ -37,7 +45,7 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^4.1.0",
-    "tsdown": "^0.21.2",
+    "tsdown": "^0.21.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },
@@ -47,7 +55,6 @@
   "scripts": {
     "build": "tsdown && cp -r src/prompts dist/prompts",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage"
+    "test": "vitest run"
   }
 }

package/src/cli.ts

@@ -0,0 +1,4 @@
+export { clean } from "./clean.js";
+export { createEngine } from "./engine.js";
+export { PARTIALS_DIR } from "./partials-dir.js";
+export type { CreateEngineOptions, Liquid } from "./types.js";

package/src/engine.test.ts

@@ -1,7 +1,7 @@
 import { Liquid } from "liquidjs";
 import { describe, expect, it } from "vitest";
 
-import { createEngine, engine } from "@/engine.js";
+import { createEngine, liquidEngine } from "@/engine.js";
 
 describe("createEngine", () => {
   it("should return a Liquid instance", () => {
@@ -26,19 +26,19 @@ describe("createEngine", () => {
   });
 });
 
-describe("engine", () => {
+describe("liquidEngine", () => {
   it("should be a Liquid instance", () => {
-    expect(engine).toBeInstanceOf(Liquid);
+    expect(liquidEngine).toBeInstanceOf(Liquid);
   });
 
   it("should render variable expressions", () => {
-    const result = engine.parseAndRenderSync("Hello {{ name }}", { name: "World" });
+    const result = liquidEngine.parseAndRenderSync("Hello {{ name }}", { name: "World" });
     expect(result).toBe("Hello World");
   });
 
   it("should throw on unknown filters (strictFilters)", () => {
     expect(() => {
-      engine.parseAndRenderSync("{{ name | bogus }}", { name: "test" });
+      liquidEngine.parseAndRenderSync("{{ name | bogus }}", { name: "test" });
     }).toThrow();
   });
 });

package/src/engine.ts

@@ -31,7 +31,7 @@ export function createEngine(partialsDir: string, options?: Partial<CreateEngine
  * only needs to handle `{{ var }}` expressions and basic Liquid
  * control flow (`{% if %}`, `{% for %}`). No filesystem access required.
  */
-export const engine = new Liquid({
+export const liquidEngine = new Liquid({
   strictFilters: true,
   ownPropertyOnly: true,
 });

package/src/index.ts

@@ -1,11 +1,2 @@
-export { engine, createEngine } from "./engine.js";
-export { clean } from "./clean.js";
-export { PARTIALS_DIR } from "./partials-dir.js";
 export { createPromptRegistry } from "./registry.js";
-export type {
-  CreateEngineOptions,
-  Liquid,
-  PromptModule,
-  PromptNamespace,
-  PromptRegistry,
-} from "./types.js";
+export type { PromptModule, PromptNamespace, PromptRegistry } from "./types.js";

package/src/runtime.ts

@@ -0,0 +1 @@
+export { liquidEngine } from "./engine.js";

package/tsdown.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from "tsdown";
 
 export default defineConfig({
-  entry: ["src/index.ts"],
+  entry: ["src/index.ts", "src/runtime.ts", "src/cli.ts"],
   outDir: "dist/lib",
   format: ["esm"],
   dts: true,