@happyvertical/smrt-prompts 0.51.24 → 0.51.32

package/AGENTS.md

@@ -7,7 +7,10 @@ SMRT prompt registry and tenant-aware prompt override package. Code defines defa
 - `definePrompt()` registers code defaults in a global process registry (`globalThis.__smrtPromptRegistry`)
 - `resolvePrompt()` merges code defaults, file/config overrides (via `@happyvertical/smrt-config`), stored app-level overrides, stored tenant-level overrides, and a runtime override
 - `PromptOverride` (`_smrt_prompt_overrides` table) stores partial app-level and tenant-level overrides with write-time validation
-- `PromptOverrideCollection` exposes the standard SmrtCollection CRUD surface
+- `PromptOverrideCollection` — collection API, plus `setTemplateOverride()` / `removeOverride()` / `findByScope()` / `getOverrideMapForKeys()` for the write and enumeration paths below
+- `PromptOverrideService` — the only write path a host should use directly; asks a host-supplied authorizer before every write and fails closed (mirrors `FeatureOverrideService`, #3013); before authorizing it rejects any scope the resolver never reads (`InvalidPromptScopeError`: unknown type, app id other than `__app__`, blank/untrimmed/`__app__` tenant id), so a malformed tenant write cannot reach the app-wide row
+- `PromptSettingsService` — read/write helper for a management screen: `listPromptSettings()` returns one `PromptSettingsRow` per registered key (the effective template, `appTemplate`/`tenantTemplate` for the raw override at each scope, `appDefaultTemplate`/`inheritedTemplate` for what reverting each scope produces, and `supplyingLevel`); `setPromptOverride()` refuses unknown keys and fields the definition marks not editable, then delegates to `PromptOverrideService` (#3053)
+- `./svelte` subpath — `PromptSettingsPanel`, the presentational management panel (#3053)
 
 ## Resolution layers (priority low → high)
 
@@ -26,6 +29,36 @@ Each layer can override any subset of fields (template, profile, model, params).
 - **Provider selection is indirect** in v1: prompts select named profiles, and profiles resolve to provider/model in `smrt-config`
 - **`editable` flags are enforced on `PromptOverride.save()`** — definitions can lock specific fields against tenant override
 
+## Generated surfaces
+
+`PromptOverride` ships with generated REST routes, MCP tools, and CLI commands
+closed (`api: false`, `cli: false`, `mcp: false`, mirrors `FeatureOverride`,
+#3013). Override rows are authorization state for every scope and `tenantId` is
+an ordinary settable field, not request-derived tenant scoping — a generated
+authentication-only surface would let any signed-in principal set another
+tenant's prompt text. Hosts write overrides server-side with
+`PromptOverrideService` (which requires an explicit authorizer for every
+write) or `PromptOverrideCollection.setTemplateOverride()` /
+`removeOverride()` only after their own authorization decision.
+
+## Management UI (`./svelte`)
+
+- Built like every other Svelte-shipping package here (`smrt-features`/`smrt-tenancy` are the closest models): `vite build --mode library && svelte-package -i src/svelte -o dist/svelte`, an `./svelte` export with a `svelte` condition, `svelte` as an **optional** peer dependency, plus `scripts/prune-svelte-package-artifacts.js` so `svelte-package` does not copy `__tests__/` into the published `dist/svelte`. The root export stays Svelte-free so server-only consumers are unaffected.
+- `PromptSettingsPanel` is presentational: rows and callbacks in, no fetching, no authorization. `src/svelte/types.ts` deliberately imports nothing from `smrt-core` or the `@smrt()` models, so the browser bundle stays thin; `PromptSettingsRow` is structurally assignable to `PromptSettingsView`.
+- Each row is its own `<form>` with a checkbox + `<textarea>` pair per scope (`tenantOverride`/`tenantTemplate`, and `appOverride`/`appTemplate` when `showApp` is set). The checkbox's presence in the submitted `FormData` — not whether the textarea is disabled — decides override vs. revert, because a plain HTML submit cannot un-disable a field the browser already marked disabled. `onSave` reads the same `FormData` when driving the panel from a client handler instead of `formAction`.
+- Two invariants, both regression-tested. (1) The "revert" preview never claims the bare registry default: `tenantRevertPreview()` shows `inheritedTemplate` (registry + config + app override), falling back to `appDefaultTemplate` only when the row does not carry it, and `appRevertPreview()` shows `appDefaultTemplate` (registry + config, never the app override itself). `PromptSettingsService` computes both explicitly rather than deriving one from the other — an earlier draft reused the app-only merge as the "no tenant requested" effective value and broke both. (2) The rows remount on `contextKey ?? prompts`, so an unsaved edit cannot survive a reload or a tenant switch and be submitted against the new rows.
+- **Authorization stays with the consumer.** `PromptSettingsService` reads are unfiltered and every write goes through `PromptOverrideService`; constructing the settings service without an `authorize` option makes it read-only (writes fail closed). Never add an authorization decision to this package.
+- `vitest.config.ts` runs two projects (`server` node + `smrtVitestPlugin`, `svelte` jsdom + `@sveltejs/vite-plugin-svelte` with `conditions: ['browser']`) because the browser condition would send `smrt-core` to its browser build if applied globally.
+- `PromptSettingsService.create()` builds its `PromptOverrideCollection` with the caller's `defaultListLimit`/`maxListLimit` stripped before the bulk `getOverrideMapForKeys()` enumeration read that backs `listPromptSettings()` — the #3056 hazard class in `smrt-features`'s `FeatureOverrideCollection.getOverrideMap()`, applied here proactively rather than left for a follow-up issue. A host-configured list bound must never silently drop a key's override from a management screen.
+
+## Prompt keys are persisted identifiers
+
+Overrides are stored keyed by the exact `key` string and resolved by that
+string at runtime. **Renaming a key orphans every existing override and
+silently reverts every tenant to the registry default.** Treat a shipped key
+as immutable; a rename needs a data migration over
+`_smrt_prompt_overrides.key`, not an edit.
+
 ## Caching
 
 `resolvePrompt()` results are cached per `(key, tenantId)` with a TTL. The cache is invalidated on `PromptOverride.save()` and `.delete()`. Use `clearPromptCache()` for manual invalidation in tests.

package/README.md

@@ -36,14 +36,160 @@ const resolved = await resolvePrompt('projects.issue.incorporateFeedback', {
 
 - **`definePrompt()`** — code-first prompt registration in a global process registry
 - **`resolvePrompt()`** — layered resolution: code default → config override → stored app override → stored tenant override → runtime override
-- **`PromptOverride`** — CRUD model for app-level and tenant-level prompt settings, stored in `_smrt_prompt_overrides`
+- **`PromptOverride`** — model for app-level and tenant-level prompt settings, stored in `_smrt_prompt_overrides`
+- **`PromptOverrideService`** / **`PromptSettingsService`** — the authorized write path and the read/write helper for a management screen (see "Management UI" below)
 - **Named AI profiles** loaded from `packages.prompts` config — prompts select profile names, profiles resolve to provider/model in config
 - **TTL cache** keyed by `(key, tenantId)`, invalidated on override save/delete
 
 Stored overrides support partial fields, so applications can override only the template, profile, model, or AI params without forking the rest of a prompt.
 
+## Generated surfaces
+
+`PromptOverride` ships with generated REST routes, MCP tools, and CLI
+commands closed (`api: false`, `cli: false`, `mcp: false`). Override rows are
+authorization state for every scope, so write them only from server code
+through `PromptOverrideService`, which asks an authorizer you bind to the
+current caller before every write and fails closed:
+
+```typescript
+const service = new PromptOverrideService(overrides, (request) =>
+  request.scopeType === 'tenant' && request.scopeId === session.tenantId &&
+  session.permissions.has('prompts.manage'),
+);
+await service.setTemplateOverride(key, 'tenant', session.tenantId, 'New text.');
+```
+
+## Management UI
+
+The package ships the settings screen so consuming apps do not each rebuild
+it: `PromptSettingsService` (root export) produces the rows, and
+`PromptSettingsPanel` (the `./svelte` subpath) renders them. The root export
+stays Svelte-free, so a server-only consumer is unaffected; `svelte` is an
+optional peer dependency.
+
+### Consumer recipe
+
+**1. Register the prompt in code** (see Quick start above), including
+`editable` if you want tenants or the app-wide default to be overridable:
+
+```typescript
+definePrompt({
+  key: 'projects.issue.incorporateFeedback',
+  template: 'Rewrite the issue body incorporating this feedback: {feedback}',
+  description: 'Rewrites an issue body from reviewer feedback.',
+  editable: { template: true },
+});
+```
+
+**2. Load the rows in your server load.** The load is where *your* permission
+check lives — the package makes no authorization decision:
+
+```typescript
+// src/routes/settings/prompts/+page.server.ts
+export async function load(event) {
+  const auth = requirePermission(event, APP_PERMISSIONS.tenantAdmin);
+  const settings = await PromptSettingsService.create({ db });
+  return {
+    tenantId: auth.tenantId,
+    prompts: await settings.listPromptSettings({ tenantId: auth.tenantId }),
+  };
+}
+```
+
+`listPromptSettings()` returns one `PromptSettingsRow` per registered
+key — the effective template for the requested tenant, the raw override text
+at each scope (`appTemplate`/`tenantTemplate`), what reverting each scope
+produces (`appDefaultTemplate`/`inheritedTemplate`), and `supplyingLevel`. The
+row is structurally assignable to the panel's `PromptSettingsView`, so no
+mapping step is needed.
+
+**3. Render the panel:**
+
+```svelte
+<script lang="ts">
+  import { PromptSettingsPanel } from '@happyvertical/smrt-prompts/svelte';
+  let { data, form } = $props();
+</script>
+
+<PromptSettingsPanel
+  prompts={data.prompts}
+  contextKey={data.tenantId}
+  formAction="?/savePrompt"
+  message={form?.message}
+  error={form?.error}
+/>
+```
+
+The panel is presentational: it takes rows and callbacks, fetches nothing and
+authorizes nothing. Each row renders the key, description, effective text, and
+which level supplied it, plus a checkbox + text editor for the tenant scope
+(and, when `showApp`/`appEditable` are set, the app scope). Unchecking the box
+reverts that scope — the preview text next to it shows exactly what reverting
+produces. Supply `onSave` instead of `formAction` to drive it from a client
+handler.
+
+**4. Wire the write with your own permission check.** `setPromptOverride()`
+refuses any key without a definition and any field the definition's
+`editable` config disallows, then delegates to `PromptOverrideService`, which
+asks your authorizer and fails closed:
+
+```typescript
+export const actions = {
+  savePrompt: async (event) => {
+    const auth = requirePermission(event, APP_PERMISSIONS.tenantAdmin);
+    const form = await event.request.formData();
+    const settings = await PromptSettingsService.create(
+      { db },
+      {
+        // Your decision, bound to this caller. Returning anything but `true` denies.
+        authorize: (request) =>
+          request.scopeType === 'tenant' && request.scopeId === auth.tenantId,
+      },
+    );
+
+    try {
+      await settings.setTenantPromptOverride(
+        String(form.get('key') ?? ''),
+        auth.tenantId,
+        form.has('tenantOverride') ? String(form.get('tenantTemplate') ?? '') : null,
+      );
+    } catch (error) {
+      if (error instanceof UnknownPromptKeyError) return fail(400, { error: 'Unknown prompt.' });
+      if (error instanceof PromptFieldNotEditableError) return fail(400, { error: 'Not editable.' });
+      if (error instanceof InvalidPromptScopeError) return fail(400, { error: 'Invalid scope.' });
+      if (error instanceof PromptOverrideAuthorizationError) return fail(403, { error: 'Not permitted.' });
+      throw error;
+    }
+    return { message: 'Prompt overrides saved.' };
+  },
+};
+```
+
+Constructing the service **without** an `authorize` option makes it
+read-only: every write then fails closed with
+`PromptOverrideAuthorizationError`. That is the right shape for a load
+function.
+
+### What the consumer still owns
+
+- the route, its navigation entry, and the page shell;
+- the permission check on both the load and the action;
+- the `authorize` callback (this package never decides who may write);
+- resolving the session's `tenantId` — a tenant id from the URL or a form
+  field is a selector, not authorization;
+- registering prompts with `definePrompt()` at startup.
+
+### Prompt keys are persisted identifiers
+
+Overrides are stored keyed by the exact `key` string and resolved by that
+string at runtime. **Renaming a key orphans every existing override**,
+silently reverting all tenants to the registry default — the change looks
+harmless in a diff and shows up as prompt text mysteriously resetting. Treat a
+key as immutable once shipped. A rename needs a data migration that rewrites
+`_smrt_prompt_overrides.key`, not an edit.
+
 ## Documentation
 
 - See [`AGENTS.md`](./AGENTS.md) for package-internal patterns
 - See [`docs/content/standards.md`](../../docs/content/standards.md) for monorepo conventions
-- See related: [`@happyvertical/smrt-languages`](../languages) (mirrors this package for language strings), [`@happyvertical/smrt-features`](../features) (feature flags)
+- See related: [`@happyvertical/smrt-languages`](../languages) (mirrors this package for language strings), [`@happyvertical/smrt-features`](../features) (feature flags — same management-UI treatment, #3052)

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/cache.d.ts

@@ -0,0 +1,33 @@
+import { DatabaseInterface } from '@happyvertical/sql';
+import { PromptCacheValue } from './types.js';
+export declare function getPromptCacheTtlMs(): number;
+export declare function getCachedPromptBase(key: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown): PromptCacheValue | null;
+/**
+ * Reads the current invalidation generation for a key.
+ *
+ * A resolution captures this *before* its asynchronous layer loads and hands
+ * it back to {@link setCachedPromptBase}. Any write that lands while those
+ * loads are in flight bumps the generation, so the in-flight resolution —
+ * which read the pre-write layers — is refused the cache write instead of
+ * repopulating the key it just invalidated. Without this, a read that raced a
+ * write served the pre-write value for the full TTL, and a raced `delete()`
+ * resurrected the deleted override.
+ *
+ * Tracked per `(db, key)` rather than per `(db, key, tenantId)`: an app-level
+ * row is inherited by every tenant, so a write to any scope of a key must
+ * invalidate every scope of it. This matches the coarsest fan-out of
+ * {@link invalidatePromptCache}.
+ *
+ * A key with no entry of its own reports the {@link clearPromptCache} floor
+ * rather than a bare 0, so a clear refuses in-flight writes for keys that have
+ * never been invalidated too.
+ */
+export declare function getPromptCacheGeneration(key: string, db: DatabaseInterface | unknown): number;
+export declare function setCachedPromptBase(key: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown, value: PromptCacheValue, loadedAtGeneration: number): void;
+/**
+ * Invalidates a cached resolution. An app-level write (tenantId null) clears
+ * every tenant's entry for that key, because each tenant inherits from it.
+ */
+export declare function invalidatePromptCache(key: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown): void;
+export declare function clearPromptCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiFnD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,gBAAgB,GAAG,IAAI,CAczB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,MAAM,CAGR;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,EAC/B,KAAK,EAAE,gBAAgB,EACvB,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAWN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,IAAI,CAeN;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC"}

package/dist/collections/PromptOverrideCollection.d.ts

@@ -0,0 +1,45 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { PromptOverride } from '../models/PromptOverride.js';
+import { PromptOverrideScopeType } from '../types.js';
+export declare class PromptOverrideCollection extends SmrtCollection<PromptOverride> {
+    static readonly _itemClass: typeof PromptOverride;
+    private excludeOverrideId;
+    getAppOverride(key: string, options?: {
+        excludeId?: string;
+    }): Promise<PromptOverride | null>;
+    getTenantOverride(key: string, tenantId: string, options?: {
+        excludeId?: string;
+    }): Promise<PromptOverride | null>;
+    getResolutionLayers(key: string, tenantId?: string | null, options?: {
+        excludeId?: string;
+    }): Promise<{
+        app: PromptOverride | null;
+        tenant: PromptOverride | null;
+    }>;
+    /**
+     * The override row for every key in `keys` at one scope, in a single query.
+     *
+     * Used by `PromptSettingsService.listPromptSettings()` to enumerate the
+     * whole registry's override state without one round trip per key. Because
+     * this is an enumeration read — a host-configured
+     * `defaultListLimit`/`maxListLimit` on the collection's options would
+     * silently drop keys past the cap, changing which prompts a management
+     * screen reports as overridden, with no error (the #3056 hazard class in
+     * `@happyvertical/smrt-features`'s `getOverrideMap`) — callers that need the
+     * full map construct this collection through
+     * `PromptSettingsService.create()`, which strips those bounds.
+     */
+    getOverrideMapForKeys(keys: string[], scopeType: PromptOverrideScopeType, scopeId: string): Promise<Map<string, PromptOverride>>;
+    /** The override row for a scope request, in the vocabulary used at the write boundary. */
+    findByScope(key: string, scopeType: PromptOverrideScopeType, scopeId: string): Promise<PromptOverride | null>;
+    /**
+     * Set (or clear, with `template: null`) the `template` field of the override
+     * row for one scope, creating the row if it did not exist. Other fields
+     * (`profile`, `model`, `params`) on an existing row are left untouched, per
+     * this package's field-by-field inheritance model.
+     */
+    setTemplateOverride(key: string, scopeType: PromptOverrideScopeType, scopeId: string, template: string | null): Promise<PromptOverride>;
+    /** Remove the override row for one scope entirely, if one exists. */
+    removeOverride(key: string, scopeType: PromptOverrideScopeType, scopeId: string): Promise<boolean>;
+}
+//# sourceMappingURL=PromptOverrideCollection.d.ts.map

package/dist/collections/PromptOverrideCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptOverrideCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PromptOverrideCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,UAAU,wBAAkB;IAE5C,OAAO,CAAC,iBAAiB;IAOnB,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK3B,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK3B,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC;QAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAczE;;;;;;;;;;;;OAYG;IACG,qBAAqB,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAevC,0FAA0F;IACpF,WAAW,CACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAMjC;;;;;OAKG;IACG,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,cAAc,CAAC;IAkB1B,qEAAqE;IAC/D,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;CASpB"}

package/dist/index.d.ts

@@ -1,174 +1,12 @@
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { SmrtCollection } from '@happyvertical/smrt-core';
-import { SmrtObject } from '@happyvertical/smrt-core';
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-
-export declare function clearPromptCache(): void;
-
-export declare function definePrompt(input: PromptDefinitionInput): PromptDefinition;
-
-export declare function getPromptCacheTtlMs(): number;
-
-export declare interface NormalizedPromptAI {
-    profile?: string;
-    model?: string;
-    params: PromptParams;
-}
-
-/* Excluded from this release type: PACKAGE_VERSION_INITIALIZED */
-
-export declare interface PromptAIInput {
-    profile?: string | null;
-    model?: string | null;
-    params?: PromptParams | null;
-    temperature?: number;
-    maxTokens?: number;
-    [key: string]: unknown;
-}
-
-export declare interface PromptConfigOverrideInput {
-    template?: string | null;
-    profile?: string | null;
-    model?: string | null;
-    params?: PromptParams | null;
-    ai?: PromptAIInput | null;
-    temperature?: number;
-    maxTokens?: number;
-    [key: string]: unknown;
-}
-
-export declare interface PromptDefinition {
-    key: string;
-    template: string;
-    ai: NormalizedPromptAI;
-    editable: PromptEditableConfig;
-}
-
-export declare interface PromptDefinitionInput {
-    key: string;
-    template: string;
-    ai?: PromptAIInput;
-    editable?: Partial<PromptEditableConfig>;
-}
-
-export declare interface PromptEditableConfig {
-    template: boolean;
-    profile: boolean;
-    model: boolean;
-    params: boolean;
-}
-
-export declare interface PromptLayer {
-    template?: string | null;
-    profile?: string | null;
-    model?: string | null;
-    params?: PromptParams | null;
-}
-
-export declare class PromptOverride extends SmrtObject {
-    key: string;
-    tenantId: string | null;
-    template: string | null;
-    profile: string | null;
-    model: string | null;
-    params: string | null;
-    constructor(options?: PromptOverrideOptions);
-    getParams(): PromptParams;
-    setParams(params: PromptParams | null): void;
-    toPromptLayer(): PromptLayer;
-    save(): Promise<this>;
-    private saveAfterIdentityChange;
-    private saveAfterIdentityChangeInTransaction;
-    private saveAfterIdentityChangeWithDeferredDelete;
-    delete(): Promise<void>;
-    private validatePromptOverride;
-    private getLowerPrecedenceLayers;
-    private normalizeParamsForPersistence;
-    private getPersistedIdentity;
-}
-
-export declare class PromptOverrideCollection extends SmrtCollection<PromptOverride> {
-    static readonly _itemClass: typeof PromptOverride;
-    private excludeOverrideId;
-    getAppOverride(key: string, options?: {
-        excludeId?: string;
-    }): Promise<PromptOverride | null>;
-    getTenantOverride(key: string, tenantId: string, options?: {
-        excludeId?: string;
-    }): Promise<PromptOverride | null>;
-    getResolutionLayers(key: string, tenantId?: string | null, options?: {
-        excludeId?: string;
-    }): Promise<{
-        app: PromptOverride | null;
-        tenant: PromptOverride | null;
-    }>;
-}
-
-export declare interface PromptOverrideOptions extends SmrtObjectOptions {
-    key?: string;
-    tenantId?: string | null;
-    template?: string | null;
-    profile?: string | null;
-    model?: string | null;
-    params?: string | PromptParams | null;
-}
-
-export declare interface PromptPackageConfig {
-    profiles?: Record<string, PromptProfileConfig>;
-    prompts?: Record<string, PromptConfigOverrideInput>;
-    allowedProfileNames?: string[];
-    allowedModels?: string[];
-    [key: string]: unknown;
-}
-
-export declare type PromptParams = Record<string, unknown>;
-
-export declare interface PromptProfileConfig {
-    provider: string;
-    model: string;
-    params?: PromptParams | null;
-    temperature?: number;
-    maxTokens?: number;
-    [key: string]: unknown;
-}
-
-export declare const PromptRegistry: {
-    register(input: PromptDefinitionInput): PromptDefinition;
-    get(key: string): PromptDefinition | undefined;
-    has(key: string): boolean;
-    getAll(): PromptDefinition[];
-    clear(): void;
-};
-
-export declare interface ResolvedPrompt {
-    key: string;
-    template: string;
-    text: string;
-    ai: ResolvedPromptAI;
-}
-
-export declare interface ResolvedPromptAI extends PromptParams {
-    profile?: string;
-    provider?: string;
-    model?: string;
-    allowedModels?: string[];
-    params: PromptParams;
-    temperature?: number;
-    maxTokens?: number;
-}
-
-export declare function resolvePrompt(key: string, options?: ResolvePromptOptions): Promise<ResolvedPrompt>;
-
-export declare interface ResolvePromptOptions {
-    db?: SmrtClassOptions['db'];
-    tenantId?: string | null;
-    variables?: Record<string, unknown>;
-    override?: PromptConfigOverrideInput;
-}
-
-export { }
-
-
-declare global {
-    var __smrtPromptRegistry: Map<string, PromptDefinition> | undefined;
-}
+export { clearPromptCache, getPromptCacheTtlMs } from './cache.js';
+export { PromptOverrideCollection } from './collections/PromptOverrideCollection.js';
+export { PromptOverride, type PromptOverrideOptions, } from './models/PromptOverride.js';
+export { InvalidPromptScopeError, PromptOverrideAuthorizationError, type PromptOverrideAuthorizer, PromptOverrideService, type PromptOverrideWriteRequest, } from './prompt-override-service.js';
+export { definePrompt, PromptRegistry } from './prompt-registry.js';
+export { resolvePrompt } from './prompt-resolver.js';
+export { type ListPromptSettingsOptions, PromptFieldNotEditableError, type PromptSettingsLevel, type PromptSettingsRow, PromptSettingsService, type PromptSettingsServiceOptions, type SetPromptOverrideRequest, UnknownPromptKeyError, } from './prompt-settings.js';
+export type { NormalizedPromptAI, PromptAIInput, PromptConfigOverrideInput, PromptDefinition, PromptDefinitionInput, PromptEditableConfig, PromptLayer, PromptOverrideScopeType, PromptPackageConfig, PromptParams, PromptProfileConfig, ResolvedPrompt, ResolvedPromptAI, ResolvePromptOptions, } from './types.js';
+export { APP_PROMPT_SCOPE_ID } from './types.js';
+/** @internal */
+export declare const PACKAGE_VERSION_INITIALIZED = true;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,OAAO,CAAC"}