@happyvertical/smrt-prompts 0.30.0

package/dist/smrt-knowledge.json

@@ -0,0 +1,286 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-06-23T01:11:22.818Z",
+  "packageName": "@happyvertical/smrt-prompts",
+  "packageVersion": "0.30.0",
+  "sourceManifestPath": "dist/manifest.json",
+  "agentDocPath": "AGENTS.md",
+  "sourceHashes": {
+    "manifest": "a65f6d38d67dbca8428cb4fadde884ef153a95660fa648bf80d99008ddbfcc5e",
+    "packageJson": "b4a8e343bff88dacc5ad42dee2acaf71c20a7abf4a6af00150fb8781e898590f",
+    "agents": "13aa7057261beb5701f5526dcdf85b859e743565c250a39e14ab73f0d8aef8ee"
+  },
+  "exports": [
+    ".",
+    "./manifest",
+    "./manifest.json"
+  ],
+  "dependencies": {
+    "@happyvertical/smrt-config": "workspace:*",
+    "@happyvertical/smrt-core": "workspace:*",
+    "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/sql": "catalog:",
+    "@happyvertical/smrt-vitest": "workspace:*",
+    "@types/node": "25.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17"
+  },
+  "smrtDependencies": [
+    "@happyvertical/smrt-config",
+    "@happyvertical/smrt-core",
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-vitest"
+  ],
+  "sdkDependencies": [
+    "@happyvertical/sql"
+  ],
+  "tags": [],
+  "risks": [],
+  "objects": [
+    {
+      "name": "PromptOverride",
+      "qualifiedName": "@happyvertical/smrt-prompts:PromptOverride",
+      "collection": "promptoverrides",
+      "tableName": "_smrt_prompt_overrides",
+      "packageName": "@happyvertical/smrt-prompts",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "key",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "template",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "profile",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "model",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "params",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "delete",
+        "getParams",
+        "save",
+        "setParams",
+        "toPromptLayer"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "promptoverrides.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+          "path": "/promptoverrides",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "promptoverrides.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+          "path": "/promptoverrides/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "promptoverrides.create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+          "path": "/promptoverrides",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "promptoverrides.update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+          "path": "/promptoverrides/[id]",
+          "method": "PATCH"
+        },
+        {
+          "kind": "api",
+          "name": "promptoverrides.delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+          "path": "/promptoverrides/[id]",
+          "method": "DELETE"
+        },
+        {
+          "kind": "cli",
+          "name": "promptoverride_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "promptoverride_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "promptoverride_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "promptoverride_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "promptoverride_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PromptOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
+      "collection": "promptoverrides",
+      "tableName": "_smrt_prompt_overrides",
+      "packageName": "@happyvertical/smrt-prompts",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getAppOverride",
+        "getResolutionLayers",
+        "getTenantOverride"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    }
+  ],
+  "surfaces": [
+    {
+      "kind": "api",
+      "name": "promptoverrides.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+      "path": "/promptoverrides",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "promptoverrides.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+      "path": "/promptoverrides/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "promptoverrides.create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+      "path": "/promptoverrides",
+      "method": "POST"
+    },
+    {
+      "kind": "api",
+      "name": "promptoverrides.update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+      "path": "/promptoverrides/[id]",
+      "method": "PATCH"
+    },
+    {
+      "kind": "api",
+      "name": "promptoverrides.delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
+      "path": "/promptoverrides/[id]",
+      "method": "DELETE"
+    },
+    {
+      "kind": "cli",
+      "name": "promptoverride_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "promptoverride_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "promptoverride_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "promptoverride_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "promptoverride_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+    }
+  ],
+  "prompts": [
+    {
+      "filePath": "src/index.ts"
+    },
+    {
+      "filePath": "src/prompt-registry.ts"
+    },
+    {
+      "filePath": "src/prompt-resolver.test.ts"
+    }
+  ],
+  "relationshipsV2": {
+    "foreignKeyFields": 0,
+    "crossPackageRefFields": 0,
+    "junctionCollections": 0,
+    "hierarchicalObjects": 0,
+    "polymorphicAssociations": 0,
+    "uuidColumns": 2
+  },
+  "agentDoc": "# smrt-prompts\n\nSMRT prompt registry and tenant-aware prompt override package. Code defines defaults; config layers and DB-stored overrides personalize at app and tenant levels.\n\n## Core pieces\n\n- `definePrompt()` registers code defaults in a global process registry (`globalThis.__smrtPromptRegistry`)\n- `resolvePrompt()` merges code defaults, file/config overrides (via `@happyvertical/smrt-config`), stored app-level overrides, stored tenant-level overrides, and a runtime override\n- `PromptOverride` (`_smrt_prompt_overrides` table) stores partial app-level and tenant-level overrides with write-time validation\n- `PromptOverrideCollection` exposes the standard SmrtCollection CRUD surface\n\n## Resolution layers (priority low → high)\n\n1. Code default — registered via `definePrompt({ key, template, ai })`\n2. File/config override — `getPackageConfig<PromptPackageConfig>('prompts', defaults)`\n3. App-level stored override — `PromptOverride` row with `tenantId = null`\n4. Tenant-level stored override — `PromptOverride` row with current tenant\n5. Runtime override — passed to `resolvePrompt({ overrides })`\n\nEach layer can override any subset of fields (template, profile, model, params). Inheritance is field-by-field.\n\n## Conventions\n\n- **Namespace prompt keys** by package or domain: `projects.issue.incorporateFeedback`, `content.summarize.headline`\n- **Stored overrides use nullable fields** so inheritance stays field-by-field — null means \"use the lower layer\"\n- **Provider selection is indirect** in v1: prompts select named profiles, and profiles resolve to provider/model in `smrt-config`\n- **`editable` flags are enforced on `PromptOverride.save()`** — definitions can lock specific fields against tenant override\n\n## Caching\n\n`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.\n\n## Related\n\n- `@happyvertical/smrt-languages` — parallel package for language strings (uses the same architecture pattern)\n- `@happyvertical/smrt-features` — parallel package for feature flags\n"
+}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+
+export declare interface NormalizedPromptAI {
+    profile?: string;
+    model?: string;
+    params: PromptParams;
+}
+
+export declare interface PromptAIInput {
+    profile?: string | null;
+    model?: string | null;
+    params?: PromptParams | null;
+    temperature?: number;
+    maxTokens?: number;
+    [key: string]: unknown;
+}
+
+export declare interface PromptCacheValue {
+    key: string;
+    template: string;
+    ai: NormalizedPromptAI;
+}
+
+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 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 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 interface ResolvePromptOptions {
+    db?: SmrtClassOptions['db'];
+    tenantId?: string | null;
+    variables?: Record<string, unknown>;
+    override?: PromptConfigOverrideInput;
+}
+
+export { }

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@happyvertical/smrt-prompts",
+  "version": "0.30.0",
+  "description": "Typed prompt registry, override resolution, and tenant-aware prompt settings for SMRT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "dependencies": {
+    "@happyvertical/sql": "^0.74.7",
+    "@happyvertical/smrt-config": "0.30.0",
+    "@happyvertical/smrt-core": "0.30.0",
+    "@happyvertical/smrt-tenancy": "0.30.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-vitest": "0.30.0"
+  },
+  "keywords": [
+    "smrt",
+    "prompts",
+    "ai",
+    "multi-tenancy",
+    "configuration"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/prompts"
+  },
+  "scripts": {
+    "build": "vite build --mode library",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}