@sesamecare-oss/ai-templating 0.0.0

package/README.md

@@ -0,0 +1,254 @@
+# ai-templating
+
+`@sesamecare-oss/ai-templating` loads prompts and skills for Sesame services from:
+
+- local files under `private/prompts` and `private/skills`
+- Langfuse prompts, partials, and skills
+
+It compiles prompts with Handlebars, registers a shared helper set, supports Langfuse production variants, and exposes a small `TemplateManager` API for service code.
+
+## Common Use Case
+
+The normal pattern is:
+
+1. Create a Langfuse client
+2. Construct a `TemplateManager`
+3. Load templates during service startup
+4. Render prompts by name inside request or workflow code
+
+```ts
+import path from 'node:path';
+
+import { TemplateManager } from '@sesamecare-oss/ai-templating';
+
+export async function start(app: AgentApp) {
+  const templates = new TemplateManager(app, {
+    langfuse: app.locals.langfuse,
+    rootDir: path.join(process.cwd(), 'private'),
+  });
+
+  await templates.loadTemplates();
+  app.locals.templates = templates;
+}
+```
+
+Later, render a prompt:
+
+```ts
+const { messages, config, metadata } = await app.locals.templates.render(
+  'patient/base-prompt',
+  {
+    patientName: 'Ada Lovelace',
+    appointmentDate: '2026-03-21T14:00:00.000Z',
+  },
+  {
+    conversation: priorMessages,
+  },
+  {
+    conversationUuid: '7d1a227d-bf49-4fcb-9db0-04f7c767d0b0',
+  },
+);
+```
+
+`render()` returns:
+
+- `messages`: the final AI SDK `ModelMessage[]`
+- `config`: model config attached to the prompt when present
+- `metadata.langfusePrompt`: the serialized Langfuse prompt tag for tracing
+
+## Requirements
+
+`TemplateManager` expects a service-style app object whose `locals` include:
+
+- `logger` from `@openapi-typescript-infra/service`
+
+The Langfuse client is passed explicitly in `TemplateManagerOptions.langfuse`.
+
+Missing templates or skills throw `ServiceError` with status `400`.
+
+## Directory Layout
+
+`rootDir` is the directory that contains `prompts/` and `skills/`.
+
+By default the package looks for:
+
+- `<rootDir>/prompts`
+- `<rootDir>/skills`
+
+Example:
+
+```ts
+const templates = new TemplateManager(app, {
+  langfuse,
+  rootDir: '/srv/service/private',
+});
+```
+
+Typical local layout:
+
+```text
+private/
+  prompts/
+    patient/
+      base-prompt.yaml
+      base-prompt.hbs
+    shared/
+      header.partial.hbs
+  skills/
+    patient/
+      triage.yaml
+```
+
+Prompt and skill names are derived from paths relative to the configured `rootDir`:
+
+- `private/prompts/patient/base-prompt.yaml` -> `patient/base-prompt`
+- `private/prompts/shared/header.partial.hbs` -> partial `shared/header`
+- `private/skills/patient/triage.yaml` -> skill `patient_triage`
+
+## Local Prompt Example
+
+`private/prompts/patient/base-prompt.yaml`
+
+```yaml
+messages:
+  - role: system
+    content:
+      $ref: ./base-prompt.hbs
+config:
+  model: gpt-4.1
+  temperature: 0
+  topK: 0
+  topP: 1
+```
+
+`private/prompts/patient/base-prompt.hbs`
+
+```hbs
+{{> shared/header}}
+
+You are helping {{patientName}}.
+The appointment is scheduled for {{formatDate appointmentDate}}.
+```
+
+`private/prompts/shared/header.partial.hbs`
+
+```hbs
+Be direct, accurate, and concise.
+```
+
+## Local Skill Example
+
+`private/skills/patient/triage.yaml`
+
+```yaml
+description: Decide which patient support workflow should be used.
+detail: |
+  Use this skill when the user is asking to schedule, reschedule, cancel,
+  or clarify an appointment-related request.
+tools:
+  - appointments_search
+  - appointments_reschedule
+```
+
+Load skills by name:
+
+```ts
+const [triageSkill] = app.locals.templates.getSkills(['patient_triage']);
+```
+
+## Langfuse Conventions
+
+The package treats certain Langfuse prompt names specially.
+
+### Standard prompts
+
+Use the prompt name directly, for example:
+
+- `patient/base-prompt`
+
+Production labels control which Langfuse version is loaded:
+
+- `production`
+- `production-canary`
+- `production-whatever`
+
+If multiple production labels exist for the same prompt name, they are grouped and selected deterministically per `conversationUuid`. Variant weights come from `config.promptWeight`.
+
+### Partials
+
+Name partial prompts with either:
+
+- `partial:shared/header`
+- `partial/shared/header`
+
+These become Handlebars partials named `shared/header`.
+
+### Skills
+
+Name skill prompts with either:
+
+- `skill:patient/triage`
+- `skill/patient/triage`
+
+For Langfuse skills:
+
+- prompt text becomes `detail`
+- `config.description` is required
+- `config.tools` is optional and must be an array of strings
+
+## Public API
+
+The main API surface is intentionally small:
+
+### `new TemplateManager(app, options)`
+
+Construct the manager. `options` supports:
+
+- `langfuse`
+- `rootDir`
+
+### `await templates.loadTemplates()`
+
+Loads local templates, local skills, Langfuse inventory, partials, and production prompts into memory.
+
+### `await templates.render(name, data, placeholders?, options?)`
+
+Renders a template by name.
+
+Options:
+
+- `promptVersion`: force a specific Langfuse version
+- `conversationUuid`: stable seed for weighted variant selection
+
+### `templates.getSkills(names)`
+
+Returns skill specs in the requested order.
+
+### `await templates.getAndCacheTemplate(name, version?, label?)`
+
+Fetches a Langfuse template directly and stores it in the in-memory cache.
+
+### `await templates.reloadFromLangfuse(update?)`
+
+Refreshes templates, skills, or partials from Langfuse.
+
+- with `promptName`, it reloads only the affected prompt when possible
+- without `promptName`, it falls back to a full reload
+
+## Built-in Helpers
+
+The package registers:
+
+- the helper set from `handlebars-helpers`
+- `howLongAgo(date)`
+- `formatDate(date, format?)`
+- `formatCents(cents)`
+- `eq(a, b)`
+
+These are available to both filesystem prompts and Langfuse prompts.
+
+## Notes
+
+- Node `>=22` is required.
+- The package is designed for service environments built on `@openapi-typescript-infra/service`.
+- `TemplateManager.iterateAllPrompts(langfuse)` is exported if you need raw Langfuse prompt inventory iteration.

package/build/TemplateManager.d.ts

@@ -0,0 +1,32 @@
+import type { ModelMessage } from 'ai';
+import type { TemplateDelegate } from 'handlebars';
+import type { LangfuseClient } from '@langfuse/client';
+import type { LangfuseReloadRequest, LangfuseHandlebarsTemplate, SkillSpec, TemplateApp, TemplateManagerOptions, TemplateStore, WeightedPromptGroup } from './types.js';
+export declare class TemplateManager implements TemplateStore {
+    private readonly app;
+    private readonly options;
+    readonly templates: Record<string, LangfuseHandlebarsTemplate<unknown>>;
+    readonly promptGroups: Record<string, WeightedPromptGroup<unknown>>;
+    readonly skills: Record<string, SkillSpec>;
+    constructor(app: TemplateApp, options: TemplateManagerOptions);
+    static iterateAllPrompts(langfuse: LangfuseClient): AsyncGenerator<import("node_modules/@langfuse/core/dist/index.js").PromptMeta, void, unknown>;
+    loadTemplates(): Promise<void>;
+    getSkills(skillNames: string[]): SkillSpec[];
+    getAndCacheTemplate(templateName: string, version?: number, label?: string): Promise<LangfuseHandlebarsTemplate<unknown>>;
+    reloadFromLangfuse(update?: LangfuseReloadRequest): Promise<void>;
+    render<T>(template: string | TemplateDelegate<T>, data: T, placeholders: Record<string, ModelMessage[]> | undefined, options?: {
+        promptVersion?: number;
+        conversationUuid?: string;
+    }): Promise<{
+        messages: ModelMessage[];
+        config?: LangfuseHandlebarsTemplate['config'];
+        metadata?: Record<string, string>;
+    }>;
+    private resolveTemplate;
+    private clearStore;
+    private reloadPartialFromLangfuse;
+    private reloadSkillFromLangfuse;
+    private reloadPromptFromLangfuse;
+    private clearTemplateEntries;
+}
+export { selectPromptVariant } from './template-store.js';

package/build/TemplateManager.js

@@ -0,0 +1,189 @@
+import { randomUUID } from 'node:crypto';
+import handlebars from 'handlebars';
+import { ServiceError } from '@openapi-typescript-infra/service';
+import { resolveTemplateDirectories } from './template-files.js';
+import { loadTemplateStore } from './template-loader.js';
+import { getPromptMetaByName, isPartialPromptName, isSkillPromptName, iterateAllPrompts, loadLangfusePartialByName, loadLangfuseSkillByName, loadProductionTemplates, } from './sources/langfuse.js';
+import { loadFilesystemPartialByName, loadFilesystemSkillByName, loadFilesystemTemplateByName, } from './sources/filesystem.js';
+import { cacheTemplateVersion, createLangfuseTemplate, getProductionLabel, mergeProductionTemplateIntoStore, selectPromptVariant, } from './template-store.js';
+export class TemplateManager {
+    app;
+    options;
+    templates = {};
+    promptGroups = {};
+    skills = {};
+    constructor(app, options) {
+        this.app = app;
+        this.options = options;
+    }
+    static iterateAllPrompts(langfuse) {
+        return iterateAllPrompts(langfuse);
+    }
+    async loadTemplates() {
+        await loadTemplateStore(this.app, this.options.langfuse, this, resolveTemplateDirectories(this.options));
+    }
+    getSkills(skillNames) {
+        return skillNames.map((name) => {
+            const skill = this.skills[name];
+            if (!skill) {
+                throw new ServiceError(this.app, `Skill ${name} not found`, { status: 400 });
+            }
+            return skill;
+        });
+    }
+    async getAndCacheTemplate(templateName, version, label) {
+        const templateDetail = await this.options.langfuse.prompt.get(templateName, version ? { version, cacheTtlSeconds: 0 } : label ? { label, cacheTtlSeconds: 0 } : undefined);
+        if (!templateDetail) {
+            throw new ServiceError(this.app, `Template ${templateName}${version ? ` (v${version})` : ''}${label ? ` (${label})` : ''} not found`, { status: 400 });
+        }
+        const template = createLangfuseTemplate(templateName, templateDetail, label);
+        if (getProductionLabel(templateDetail.labels)) {
+            mergeProductionTemplateIntoStore(this, templateName, template, templateDetail.labels);
+        }
+        else {
+            const current = this.templates[templateName];
+            if (!current || (current.version !== -1 && current.version < template.version)) {
+                this.templates[templateName] = template;
+            }
+        }
+        cacheTemplateVersion(this, templateName, template);
+        return template;
+    }
+    async reloadFromLangfuse(update = {}) {
+        if (!update.promptName) {
+            this.clearStore();
+            await this.loadTemplates();
+            return;
+        }
+        const directories = resolveTemplateDirectories(this.options);
+        if (isPartialPromptName(update.promptName)) {
+            await this.reloadPartialFromLangfuse(update.promptName, directories);
+            return;
+        }
+        if (isSkillPromptName(update.promptName)) {
+            await this.reloadSkillFromLangfuse(update.promptName, directories);
+            return;
+        }
+        await this.reloadPromptFromLangfuse({ ...update, promptName: update.promptName }, directories);
+    }
+    async render(template, data, placeholders, options) {
+        if (typeof template === 'string') {
+            const templateInfo = await this.resolveTemplate(template, options);
+            const messages = templateInfo
+                .delegate(data, placeholders)
+                .filter((message) => message.content);
+            return {
+                messages,
+                config: templateInfo.config,
+                metadata: {
+                    langfusePrompt: templateInfo.tag,
+                },
+            };
+        }
+        const raw = template(data);
+        const messages = raw.split('---').map((message) => {
+            const [role, ...content] = message
+                .trim()
+                .split('\n')
+                .map((line) => line.trim());
+            if (role.startsWith('role:')) {
+                return {
+                    role: role.replace('role:', '').trim(),
+                    content: content.join('\n'),
+                };
+            }
+            return { role: 'user', content: message.trim() };
+        });
+        return { messages };
+    }
+    async resolveTemplate(templateName, options) {
+        if (options?.promptVersion && this.templates[templateName]?.version !== options.promptVersion) {
+            return this.getAndCacheTemplate(templateName, options.promptVersion);
+        }
+        if (!this.templates[templateName] && !this.promptGroups[templateName]) {
+            await this.getAndCacheTemplate(templateName);
+        }
+        const templateInfo = this.templates[templateName];
+        if (templateInfo) {
+            return templateInfo;
+        }
+        const group = this.promptGroups[templateName];
+        if (group) {
+            return selectPromptVariant(options?.conversationUuid || randomUUID(), group);
+        }
+        throw new ServiceError(this.app, `Template ${templateName} not found`, { status: 400 });
+    }
+    clearStore() {
+        clearRecord(this.templates);
+        clearRecord(this.promptGroups);
+        clearRecord(this.skills);
+    }
+    async reloadPartialFromLangfuse(promptName, directories) {
+        const partialName = promptName.replace(/partial[:/]/, '');
+        const localPartial = loadFilesystemPartialByName(directories.promptsDir, partialName);
+        if (localPartial) {
+            handlebars.registerPartial(partialName, localPartial.code);
+            return;
+        }
+        const langfusePartial = await loadLangfusePartialByName(this.app, this.options.langfuse, promptName);
+        if (langfusePartial) {
+            handlebars.registerPartial(partialName, langfusePartial.code);
+            return;
+        }
+        handlebars.unregisterPartial(partialName);
+    }
+    async reloadSkillFromLangfuse(promptName, directories) {
+        const skillPath = promptName.replace(/skill[:/]/, '');
+        const skillName = skillPath.replace(/\//g, '_');
+        delete this.skills[skillName];
+        const hasLocalSkill = await loadFilesystemSkillByName(this.app, this, directories.skillsDir, skillPath);
+        if (hasLocalSkill) {
+            return;
+        }
+        const langfuseSkill = await loadLangfuseSkillByName(this.app, this.options.langfuse, promptName);
+        if (langfuseSkill) {
+            this.skills[skillName] = langfuseSkill;
+        }
+    }
+    async reloadPromptFromLangfuse(update, directories) {
+        const templateName = update.promptName;
+        this.clearTemplateEntries(templateName);
+        await loadFilesystemTemplateByName(this.app, this, directories.promptsDir, templateName);
+        const promptMeta = await getPromptMetaByName(this.options.langfuse, templateName);
+        const productionLabels = promptMeta?.labels.filter((label) => label.startsWith('production')) ?? [];
+        if (productionLabels.length > 0) {
+            await loadProductionTemplates(this.app, this.options.langfuse, this, new Map([[templateName, productionLabels]]));
+            return;
+        }
+        if (this.templates[templateName]?.version === -1) {
+            return;
+        }
+        const promptDetail = await this.options.langfuse.prompt.get(templateName, update.version
+            ? { version: update.version, cacheTtlSeconds: 0 }
+            : update.label
+                ? { label: update.label, cacheTtlSeconds: 0 }
+                : undefined);
+        if (!promptDetail) {
+            return;
+        }
+        const template = createLangfuseTemplate(templateName, promptDetail, update.label);
+        this.templates[templateName] = template;
+        cacheTemplateVersion(this, templateName, template);
+    }
+    clearTemplateEntries(templateName) {
+        delete this.templates[templateName];
+        delete this.promptGroups[templateName];
+        for (const key of Object.keys(this.templates)) {
+            if (key.startsWith(`${templateName}::`) || key.startsWith(`${templateName}#`)) {
+                delete this.templates[key];
+            }
+        }
+    }
+}
+export { selectPromptVariant } from './template-store.js';
+function clearRecord(record) {
+    for (const key of Object.keys(record)) {
+        delete record[key];
+    }
+}
+//# sourceMappingURL=TemplateManager.js.map

package/build/TemplateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateManager.js","sourceRoot":"","sources":["../src/TemplateManager.ts"],"names":[],"mappings":"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"}

package/build/compile-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { ChatPromptClient, TextPromptClient } from '@langfuse/client';
+import type { LangfuseTemplateDelegate } from './types.js';
+export declare function compileLangfusePrompt<T>(promptDetail: Pick<TextPromptClient, 'type' | 'prompt'> | Pick<ChatPromptClient, 'prompt' | 'type'>): LangfuseTemplateDelegate<T>;

package/build/compile-prompt.js

@@ -0,0 +1,42 @@
+import handlebars from 'handlebars';
+import { ChatMessageType } from '@langfuse/client';
+export function compileLangfusePrompt(promptDetail) {
+    if (promptDetail.type === 'chat') {
+        const promptMessages = promptDetail.prompt;
+        const compiledHandlebars = promptMessages.map((message) => {
+            if (message.type === ChatMessageType.Placeholder) {
+                return message.name;
+            }
+            const chatMessage = message;
+            return {
+                role: chatMessage.role,
+                template: handlebars.compile(chatMessage.content),
+            };
+        });
+        return function renderChatPrompt(context, placeholders, options) {
+            const messages = [];
+            for (const entry of compiledHandlebars) {
+                if (typeof entry === 'string') {
+                    messages.push(...(placeholders?.[entry] ?? []));
+                    continue;
+                }
+                messages.push({
+                    role: entry.role,
+                    content: entry.template(context, options),
+                });
+            }
+            return messages;
+        };
+    }
+    const template = handlebars.compile(promptDetail.prompt);
+    return (context, placeholders, options) => {
+        void placeholders;
+        return [
+            {
+                role: 'user',
+                content: template(context, options),
+            },
+        ];
+    };
+}
+//# sourceMappingURL=compile-prompt.js.map

package/build/compile-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-prompt.js","sourceRoot":"","sources":["../src/compile-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMnD,MAAM,UAAU,qBAAqB,CACnC,YAE6C;IAE7C,IAAI,YAAY,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,YAAY,CAAC,MAAoC,CAAC;QACzE,MAAM,kBAAkB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACxD,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,WAAW,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC,IAAI,CAAC;YACtB,CAAC;YAED,MAAM,WAAW,GAAG,OAA0D,CAAC;YAE/E,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,IAA4B;gBAC9C,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;aAClD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,gBAAgB,CAC9B,OAAU,EACV,YAAwD,EACxD,OAAwB;YAExB,MAAM,QAAQ,GAAmB,EAAE,CAAC;YACpC,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;gBACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBAChD,SAAS;gBACX,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;iBACf,CAAC,CAAC;YAChC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CACL,OAAU,EACV,YAAwD,EACxD,OAAwB,EACxB,EAAE;QACF,KAAK,YAAY,CAAC;QAElB,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;aACpC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/build/handlebars-helpers.d.ts

@@ -0,0 +1 @@
+export declare function registerHandlebarsHelpers(): void;

package/build/handlebars-helpers.js

@@ -0,0 +1,26 @@
+import handlebars from 'handlebars';
+import helpers from 'handlebars-helpers';
+import { formatDate, formatDistanceToNow } from 'date-fns';
+let helpersRegistered = false;
+export function registerHandlebarsHelpers() {
+    if (helpersRegistered) {
+        return;
+    }
+    helpers();
+    handlebars.registerHelper('howLongAgo', (date) => {
+        return formatDistanceToNow(new Date(date), { addSuffix: true });
+    });
+    handlebars.registerHelper('formatDate', (date, formatString) => {
+        return formatDate(new Date(date), formatString && typeof formatString === 'string' ? formatString : 'MM/dd/yyyy HH:mm:ss aaa');
+    });
+    handlebars.registerHelper('formatCents', (cents) => {
+        if (cents === undefined || cents === null) {
+            return 'N/A';
+        }
+        const dollars = cents / 100;
+        return `$${dollars.toLocaleString('en-US', { minimumFractionDigits: 0, maximumFractionDigits: 0 })}`;
+    });
+    handlebars.registerHelper('eq', (a, b) => a === b);
+    helpersRegistered = true;
+}
+//# sourceMappingURL=handlebars-helpers.js.map

package/build/handlebars-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlebars-helpers.js","sourceRoot":"","sources":["../src/handlebars-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE3D,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,MAAM,UAAU,yBAAyB;IACvC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,OAAO,EAAE,CAAC;IAEV,UAAU,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE;QACvD,OAAO,mBAAmB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,IAAY,EAAE,YAAqB,EAAE,EAAE;QAC9E,OAAO,UAAU,CACf,IAAI,IAAI,CAAC,IAAI,CAAC,EACd,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAC5F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,KAAa,EAAE,EAAE;QACzD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;QAC5B,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export { TemplateManager, selectPromptVariant } from './TemplateManager.js';
+export { getPartialNameFromFile, getPromptNameFromFile, getSkillNameFromFile, resolveTemplateDirectories, } from './template-files.js';
+export { iterateAllPrompts } from './sources/langfuse.js';
+export { fnv1a32, normalize, parseWeights, seededUnitFloat, weightedPick, } from './weighted-selector.js';
+export type { DevPrompt, LangfuseReloadRequest, LangfuseHandlebarsTemplate, LangfusePromptDetail, PromptVariant, SkillSpec, TemplateApp, TemplateConfig, TemplateDirectories, TemplateManagerOptions, TemplatePartialSource, TemplateStore, WeightedPromptGroup, } from './types.js';

package/build/index.js

@@ -0,0 +1,5 @@
+export { TemplateManager, selectPromptVariant } from './TemplateManager.js';
+export { getPartialNameFromFile, getPromptNameFromFile, getSkillNameFromFile, resolveTemplateDirectories, } from './template-files.js';
+export { iterateAllPrompts } from './sources/langfuse.js';
+export { fnv1a32, normalize, parseWeights, seededUnitFloat, weightedPick, } from './weighted-selector.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/build/sources/filesystem.d.ts

@@ -0,0 +1,12 @@
+import type { TemplateApp, TemplatePartialSource, TemplateStore } from '../types.js';
+export declare function loadFilesystemPartials(promptsDir: string): Promise<Map<string, TemplatePartialSource>>;
+export declare function loadFilesystemPartialByName(promptsDir: string, partialName: string): {
+    source: "filesystem";
+    code: string;
+    name: string;
+    version: string;
+} | undefined;
+export declare function loadFilesystemTemplates(app: TemplateApp, store: TemplateStore, promptsDir: string): Promise<void>;
+export declare function loadFilesystemTemplateByName(app: TemplateApp, store: TemplateStore, promptsDir: string, templateName: string): Promise<boolean>;
+export declare function loadFilesystemSkills(app: TemplateApp, store: TemplateStore, skillsDir: string): Promise<void>;
+export declare function loadFilesystemSkillByName(app: TemplateApp, store: TemplateStore, skillsDir: string, skillPath: string): Promise<boolean>;