@nodaro/prompts 1.40.0 → 1.41.0

package/dist/index.cjs

@@ -10,7 +10,7 @@ require('./chunk-4GKTOVFM.cjs');
 var chunkXUZXBY75_cjs = require('./chunk-XUZXBY75.cjs');
 var chunkUXDKZVNN_cjs = require('./chunk-UXDKZVNN.cjs');
 var chunkSZU4MZ36_cjs = require('./chunk-SZU4MZ36.cjs');
-var chunkDQFQJECU_cjs = require('./chunk-DQFQJECU.cjs');
+var chunkXTOSNRWT_cjs = require('./chunk-XTOSNRWT.cjs');
 var chunkNAFD6MGH_cjs = require('./chunk-NAFD6MGH.cjs');
 var chunk2NJTFCKQ_cjs = require('./chunk-2NJTFCKQ.cjs');
 require('./chunk-TUHVGM6V.cjs');
@@ -558,183 +558,183 @@ Object.defineProperty(exports, "computePackSidecarCoverage", {
 });
 Object.defineProperty(exports, "AD_CREATIVE_ANALYSIS_FIELDS", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.AD_CREATIVE_ANALYSIS_FIELDS; }
+  get: function () { return chunkXTOSNRWT_cjs.AD_CREATIVE_ANALYSIS_FIELDS; }
 });
 Object.defineProperty(exports, "AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT; }
+  get: function () { return chunkXTOSNRWT_cjs.AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT; }
 });
 Object.defineProperty(exports, "AUDIO_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.AUDIO_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.AUDIO_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "DEFAULT_OWN_MOTION", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.DEFAULT_OWN_MOTION; }
+  get: function () { return chunkXTOSNRWT_cjs.DEFAULT_OWN_MOTION; }
 });
 Object.defineProperty(exports, "IMAGE_REFERENCE_PROMPT_DOCTRINE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.IMAGE_REFERENCE_PROMPT_DOCTRINE; }
+  get: function () { return chunkXTOSNRWT_cjs.IMAGE_REFERENCE_PROMPT_DOCTRINE; }
 });
 Object.defineProperty(exports, "IMAGE_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.IMAGE_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.IMAGE_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "LLM_CHAT_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.LLM_CHAT_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.LLM_CHAT_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "MUSIC_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.MUSIC_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.MUSIC_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "OWN_MOTION_NODE_TYPES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.OWN_MOTION_NODE_TYPES; }
+  get: function () { return chunkXTOSNRWT_cjs.OWN_MOTION_NODE_TYPES; }
 });
 Object.defineProperty(exports, "POST_CONTENT_ANALYSIS_SYSTEM_PROMPT", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.POST_CONTENT_ANALYSIS_SYSTEM_PROMPT; }
+  get: function () { return chunkXTOSNRWT_cjs.POST_CONTENT_ANALYSIS_SYSTEM_PROMPT; }
 });
 Object.defineProperty(exports, "PROVIDER_CAPABILITIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.PROVIDER_CAPABILITIES; }
+  get: function () { return chunkXTOSNRWT_cjs.PROVIDER_CAPABILITIES; }
 });
 Object.defineProperty(exports, "PROVIDER_PROMPT_DOCTRINES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.PROVIDER_PROMPT_DOCTRINES; }
+  get: function () { return chunkXTOSNRWT_cjs.PROVIDER_PROMPT_DOCTRINES; }
 });
 Object.defineProperty(exports, "REFERENCE_IMAGE_ROLES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.REFERENCE_IMAGE_ROLES; }
+  get: function () { return chunkXTOSNRWT_cjs.REFERENCE_IMAGE_ROLES; }
 });
 Object.defineProperty(exports, "SCENE3D_FIGURE_REFERENCE_RULE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_FIGURE_REFERENCE_RULE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_FIGURE_REFERENCE_RULE; }
 });
 Object.defineProperty(exports, "SCENE3D_FREE_PLATE_SLOTS", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_FREE_PLATE_SLOTS; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_FREE_PLATE_SLOTS; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_FOR", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_FOR; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_SCOPING_FOR; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_IGNORE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_IGNORE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_SCOPING_IGNORE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_MARKER", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_MARKER; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_LAYOUT_SCOPING_MARKER; }
 });
 Object.defineProperty(exports, "SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE; }
+  get: function () { return chunkXTOSNRWT_cjs.SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE; }
 });
 Object.defineProperty(exports, "TEXT_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.TEXT_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.TEXT_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "VIDEO_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.VIDEO_WIZARD_CATEGORIES; }
+  get: function () { return chunkXTOSNRWT_cjs.VIDEO_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "appendScene3DStillScopingLines", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.appendScene3DStillScopingLines; }
+  get: function () { return chunkXTOSNRWT_cjs.appendScene3DStillScopingLines; }
 });
 Object.defineProperty(exports, "buildAdCreativeAnalysisUserText", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildAdCreativeAnalysisUserText; }
+  get: function () { return chunkXTOSNRWT_cjs.buildAdCreativeAnalysisUserText; }
 });
 Object.defineProperty(exports, "buildCharacterPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildCharacterPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildCharacterPrompt; }
 });
 Object.defineProperty(exports, "buildCreaturePrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildCreaturePrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildCreaturePrompt; }
 });
 Object.defineProperty(exports, "buildFaceTemplateInputs", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildFaceTemplateInputs; }
+  get: function () { return chunkXTOSNRWT_cjs.buildFaceTemplateInputs; }
 });
 Object.defineProperty(exports, "buildLocationMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildLocationMotionPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildLocationMotionPrompt; }
 });
 Object.defineProperty(exports, "buildLocationPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildLocationPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildLocationPrompt; }
 });
 Object.defineProperty(exports, "buildLocationRefinePrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildLocationRefinePrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildLocationRefinePrompt; }
 });
 Object.defineProperty(exports, "buildMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildMotionPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildMotionPrompt; }
 });
 Object.defineProperty(exports, "buildObjectMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildObjectMotionPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildObjectMotionPrompt; }
 });
 Object.defineProperty(exports, "buildObjectPrompt", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildObjectPrompt; }
+  get: function () { return chunkXTOSNRWT_cjs.buildObjectPrompt; }
 });
 Object.defineProperty(exports, "buildScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildScene3DLayoutScopingLine; }
+  get: function () { return chunkXTOSNRWT_cjs.buildScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "buildScene3DUnreferencedFiguresWarning", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.buildScene3DUnreferencedFiguresWarning; }
+  get: function () { return chunkXTOSNRWT_cjs.buildScene3DUnreferencedFiguresWarning; }
 });
 Object.defineProperty(exports, "getCategoriesForNodeType", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.getCategoriesForNodeType; }
+  get: function () { return chunkXTOSNRWT_cjs.getCategoriesForNodeType; }
 });
 Object.defineProperty(exports, "getPromptDoctrine", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.getPromptDoctrine; }
+  get: function () { return chunkXTOSNRWT_cjs.getPromptDoctrine; }
 });
 Object.defineProperty(exports, "getPromptTips", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.getPromptTips; }
+  get: function () { return chunkXTOSNRWT_cjs.getPromptTips; }
 });
 Object.defineProperty(exports, "hasScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.hasScene3DLayoutScopingLine; }
+  get: function () { return chunkXTOSNRWT_cjs.hasScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "isWizardSupported", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.isWizardSupported; }
+  get: function () { return chunkXTOSNRWT_cjs.isWizardSupported; }
 });
 Object.defineProperty(exports, "ownMotionHint", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.ownMotionHint; }
+  get: function () { return chunkXTOSNRWT_cjs.ownMotionHint; }
 });
 Object.defineProperty(exports, "renderScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.renderScene3DLayoutScopingLine; }
+  get: function () { return chunkXTOSNRWT_cjs.renderScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "scene3DLayoutVideoCaptions", {
   enumerable: true,
-  get: function () { return chunkDQFQJECU_cjs.scene3DLayoutVideoCaptions; }
+  get: function () { return chunkXTOSNRWT_cjs.scene3DLayoutVideoCaptions; }
 });
 Object.defineProperty(exports, "CINEMATIC_LOOK_TAIL", {
   enumerable: true,

package/dist/index.js

@@ -8,7 +8,7 @@ import './chunk-GILUVQQJ.js';
 export { keepableDirectionHints } from './chunk-JZOPMVGY.js';
 export { PROMPT_HINT_SEPARATOR, joinPromptHints } from './chunk-35UHMDGS.js';
 export { computePackSidecarCoverage } from './chunk-FDOG7BNB.js';
-export { AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AUDIO_WIZARD_CATEGORIES, DEFAULT_OWN_MOTION, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, LLM_CHAT_WIZARD_CATEGORIES, MUSIC_WIZARD_CATEGORIES, OWN_MOTION_NODE_TYPES, POST_CONTENT_ANALYSIS_SYSTEM_PROMPT, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, TEXT_WIZARD_CATEGORIES, VIDEO_WIZARD_CATEGORIES, appendScene3DStillScopingLines, buildAdCreativeAnalysisUserText, buildCharacterPrompt, buildCreaturePrompt, buildFaceTemplateInputs, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMotionPrompt, buildObjectMotionPrompt, buildObjectPrompt, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, getCategoriesForNodeType, getPromptDoctrine, getPromptTips, hasScene3DLayoutScopingLine, isWizardSupported, ownMotionHint, renderScene3DLayoutScopingLine, scene3DLayoutVideoCaptions } from './chunk-C46256GZ.js';
+export { AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AUDIO_WIZARD_CATEGORIES, DEFAULT_OWN_MOTION, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, LLM_CHAT_WIZARD_CATEGORIES, MUSIC_WIZARD_CATEGORIES, OWN_MOTION_NODE_TYPES, POST_CONTENT_ANALYSIS_SYSTEM_PROMPT, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, TEXT_WIZARD_CATEGORIES, VIDEO_WIZARD_CATEGORIES, appendScene3DStillScopingLines, buildAdCreativeAnalysisUserText, buildCharacterPrompt, buildCreaturePrompt, buildFaceTemplateInputs, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMotionPrompt, buildObjectMotionPrompt, buildObjectPrompt, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, getCategoriesForNodeType, getPromptDoctrine, getPromptTips, hasScene3DLayoutScopingLine, isWizardSupported, ownMotionHint, renderScene3DLayoutScopingLine, scene3DLayoutVideoCaptions } from './chunk-QBUSJGV3.js';
 export { CINEMATIC_LOOK_TAIL, FILM_STILL_PREFIX, NEUTRAL_PERSON, REALISM_FINISH, REALISM_PASS_INSTRUCTION, REALISM_SKIN, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, SCENE_FRAME_RULE, filmStillPrefix, realismEmptyHands, realismViewpoint, referenceRulesBlock } from './chunk-T64D26P4.js';
 export { DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, applyTemplate, buildIdentityLockLine, characterLockToRefLock, collectIdentityLockClause, getIdentityLockClause, hasUpstreamCharacter, resolveTemplate, toIdentityLockMode, withForcedIdentityLock } from './chunk-BQWIPLLR.js';
 import './chunk-ADMHDFHB.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "Nodaro's prompt-engineering layer — person/picker catalogs with prompt hints, identity-lock clauses, entity prompt builders, brand presets, and prompt/reference assembly shared by the Nodaro platform and SDK.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",
@@ -70,7 +70,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nodaro/shared": "^3.34.0"
+    "@nodaro/shared": "^3.40.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",

package/src/prompt-wizard-categories.ts

@@ -268,6 +268,8 @@ export const PROVIDER_CAPABILITIES: Record<string, Record<string, string>> = {
     "wan-3": "Wan 3.0 — multimodal refs (10 images / 5 videos / 5 audio) or first+last frame, native audio, 2–30s, 480p/720p/1080p",
     "wan-3-prime": "Wan 3.0 Prime — high-speed Wan 3.0 tier; same surface, faster turnaround at a higher rate",
     "vidu-q4": "Vidu Q4 — start frame or up to 15 reference images + 3 MP3 audio refs, native audio, 3–16s, 540p–4K (image required)",
+    "kling-4": "Kling 4.0 — text, or up to 10 reference images / 5 videos / 7 characters / 3 voices; native audio, 3–30s, 720p/1080p",
+    "kling-4-keyframes": "Kling 4.0 Keyframes — start frame, up to 8 in-between frames and an end frame; native audio, 3–30s, 720p/1080p",
     "grok-imagine-video-1.5": "Grok Imagine 1.5 — image-to-video only; requires an input image",
   },
   "image-to-video": {
@@ -305,6 +307,8 @@ export const PROVIDER_CAPABILITIES: Record<string, Record<string, string>> = {
     "wan-3": "Wan 3.0 — multimodal refs (10 images / 5 videos / 5 audio) or first+last frame, native audio, 2–30s, 480p/720p/1080p",
     "wan-3-prime": "Wan 3.0 Prime — high-speed Wan 3.0 tier; same surface, faster turnaround at a higher rate",
     "vidu-q4": "Vidu Q4 — animate a start frame, or direct up to 15 reference images + 3 MP3 audio refs; native audio, 3–16s, 540p–4K",
+    "kling-4": "Kling 4.0 — a start frame joins up to 10 reference images, 5 videos, 7 characters and 3 voices; native audio, 3–30s, 720p/1080p",
+    "kling-4-keyframes": "Kling 4.0 Keyframes — start frame, up to 8 in-between frames and an end frame; native audio, 3–30s, 720p/1080p",
     "grok-imagine-video-1.5": "Grok Imagine 1.5 — stylized animation, 1–15s, 480p/720p (image required)",
   },
   "video-to-video": {

package/src/provider-prompt-doctrine.ts

@@ -423,6 +423,49 @@ Source: KIE Vidu Q4 market contracts (docs.kie.ai/market/vidu-q4/image-to-video,
 docs.kie.ai/market/vidu-q4/reference-to-video). Captured 2026-10-17.`,
 }
 
+// Kling 4.0 — two KIE endpoints, two ids. No public Kling 4.0 prompt guide is
+// captured, so like Vidu Q4 the body is KIE contract facts plus the
+// platform-standard structure. The provider runner maps the platform's
+// `@image_N` / `@audio_N` tokens and wired characters onto Kling's own names
+// (`@image_1`, `@keyframe_1`, a subject's `@Name`, a voice's `@VoiceN`) and drops
+// the `@` from any mention the request does not declare, which KIE rejects.
+const KLING_4_DOCTRINE: ProviderPromptDoctrine = {
+  providers: ["kling-4", "kling-4-keyframes"],
+  heading: "Kling 4.0 (kling-4, kling-4-keyframes)",
+  tips: [
+    "kling-4: text only, or up to 10 images, 5 videos (2-30s), 7 characters and 3 voices (15 in all). Name each: @image_1, @video_1, a character's @Name, a voice clip @audio_1.",
+    "kling-4-keyframes: start frame, up to 8 in-between frames (Image References, in order), end frame — @first_frame, @keyframe_1 …, @last_frame. 3s takes 4 frames in all, 9s or longer 10.",
+    "3-30s (default 5), 720p (default) / 1080p, native audio always on. A reference video lends its camera moves and pacing; keep-original-sound keeps its own audio.",
+    "Prompt cap 8,000 chars. Aspect auto / 16:9 / 9:16 / 1:1 / 21:9 — Keyframes follows the start frame's shape once a frame is attached.",
+  ],
+  doctrine: `Prompt structure (no public Kling 4.0 prompt guide is captured — the KIE API contract is the
+doctrine source; platform-standard structure applies):
+subject → action → scene/environment → lighting → camera movement → style → constraints.
+
+**Two models**
+- Kling 4.0 (kling-4) — reference-to-video. With no materials it is plain text-to-video. Materials: up to 10 reference images, 5 reference videos (2-30 seconds each), 7 subjects (characters) and 3 voices, at most 15 together. A wired start frame cannot be a frame here, so the platform adds it to the reference images and names it as the opening frame.
+- Kling 4.0 Keyframes (kling-4-keyframes) — keyframe-to-video. A start frame, up to 8 in-between frames in time order, and an end frame; the story passes through each. With no frame it is text-to-video.
+
+**Naming materials in the prompt**
+- Every material is named with "@": @image_1 … for reference images, @video_1 … for reference videos, a character by its own name (@Maya), a voice clip as @audio_1 (sent to Kling as a named voice). Keyframes: @first_frame, @keyframe_1 … @keyframe_8, @last_frame.
+- Kling refuses a prompt that names a material the request does not carry; the platform removes the "@" from such a mention so the run still starts — wire the material if the mention matters.
+- Write the binding explicitly: "@Maya walks through the street from @image_1 and greets the camera in the voice of @audio_1".
+
+**Keyframe rules**
+- Total frames (start + in-between + end) are capped by duration: 3s → 4, 4s → 5, 5s → 6, 6s → 7, 7s → 8, 8s → 9, 9s or longer → 10. Describe how the shot moves from one frame to the next.
+- Once any frame is attached the output takes the start frame's shape; aspect ratio applies to text-only runs.
+
+**Reference videos**
+- A reference video lends its camera moves and pacing — swap the characters or products in the prompt ("recreate the camera move of @video_1 with …"). Keep original sound keeps the clip's own audio; otherwise new sound is generated.
+
+**Duration, resolution, audio**
+- 3-30 seconds (default 5); 720p (default) or 1080p; aspect auto (follows the materials, 16:9 with none) / 16:9 / 9:16 / 1:1 / 21:9. Prompts up to 8,000 characters.
+- Native audio is always generated (the contract cites lip-sync and dialogue in 10+ languages); not yet verified for scripted lines here, so plan key dialogue as a TTS + lip-sync pass.
+
+Source: KIE Kling 4.0 market contracts (docs.kie.ai/market/kling/v4-reference-to-video,
+docs.kie.ai/market/kling/v4-keyframe-to-video), live-probed 2026-10-23.`,
+}
+
 const HAPPYHORSE_DOCTRINE: ProviderPromptDoctrine = {
   providers: ["happyhorse", "happyhorse-i2v", "happyhorse-ref2v", "happyhorse-edit"],
   heading: "HappyHorse 1.1 (happyhorse, happyhorse-i2v, happyhorse-ref2v)",
@@ -482,6 +525,7 @@ export const PROVIDER_PROMPT_DOCTRINES: readonly ProviderPromptDoctrine[] = [
   WAN_DOCTRINE,
   WAN_3_DOCTRINE,
   VIDU_Q4_DOCTRINE,
+  KLING_4_DOCTRINE,
   HAPPYHORSE_DOCTRINE,
   RUNWAY_KIE_DOCTRINE,
 ]