@continuum-dev/prompts 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bryton Cooper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# @continuum-dev/prompts
+
+Prompt templates and assembly helpers for Continuum AI view generation.
+
+## Install
+
+```bash
+npm install @continuum-dev/prompts
+```
+
+## What this package provides
+
+- A production-ready base system prompt
+- Mode prompts for create, evolve, and correction loops
+- Optional addons for attachment extraction and strict continuity
+- Typed helpers to assemble system prompts and build user messages
+
+## Quick usage
+
+```typescript
+import {
+  assembleSystemPrompt,
+  buildEvolveUserMessage,
+  type PromptMode,
+} from '@continuum-dev/prompts';
+
+const mode: PromptMode = 'evolve-view';
+
+const systemPrompt = assembleSystemPrompt({
+  mode,
+  addons: ['strict-continuity'],
+});
+
+const userMessage = buildEvolveUserMessage({
+  currentView,
+  instruction: 'Add co-borrower employment and preserve semantic keys.',
+});
+```
+
+## Exports
+
+- `PROMPT_LIBRARY_VERSION`
+- `PROMPT_LIBRARY`
+- `SYSTEM_CORE`
+- `MODE_CREATE_VIEW`
+- `MODE_EVOLVE_VIEW`
+- `MODE_CORRECTION_LOOP`
+- `ADDON_ATTACHMENTS`
+- `ADDON_STRICT_CONTINUITY`
+- `assembleSystemPrompt`
+- `buildCreateUserMessage`
+- `buildEvolveUserMessage`
+- `buildCorrectionUserMessage`
+- `getModePrompt`
+- `getAddonPrompt`
+
+## Recommended request metadata
+
+Store this with each model request:
+
+- `promptVersion`
+- `mode`
+- enabled addons list
+
+This makes prompt behavior auditable and easier to tune.

package/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/types.js';
+export { ADDON_ATTACHMENTS, ADDON_STRICT_CONTINUITY, EXAMPLE_CORRECTION_LOOP_USER_MESSAGE, EXAMPLE_CREATE_VIEW_USER_MESSAGE, EXAMPLE_EVOLVE_VIEW_USER_MESSAGE, MODE_CORRECTION_LOOP, MODE_CREATE_VIEW, MODE_EVOLVE_VIEW, PROMPT_LIBRARY, PROMPT_LIBRARY_VERSION, SYSTEM_CORE, assembleSystemPrompt, buildCorrectionUserMessage, buildCreateUserMessage, buildEvolveUserMessage, getAddonPrompt, getModePrompt, } from './lib/templates.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/prompts/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oCAAoC,EACpC,gCAAgC,EAChC,gCAAgC,EAChC,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/index.js

@@ -0,0 +1,2 @@
+export * from './lib/types.js';
+export { ADDON_ATTACHMENTS, ADDON_STRICT_CONTINUITY, EXAMPLE_CORRECTION_LOOP_USER_MESSAGE, EXAMPLE_CREATE_VIEW_USER_MESSAGE, EXAMPLE_EVOLVE_VIEW_USER_MESSAGE, MODE_CORRECTION_LOOP, MODE_CREATE_VIEW, MODE_EVOLVE_VIEW, PROMPT_LIBRARY, PROMPT_LIBRARY_VERSION, SYSTEM_CORE, assembleSystemPrompt, buildCorrectionUserMessage, buildCreateUserMessage, buildEvolveUserMessage, getAddonPrompt, getModePrompt, } from './lib/templates.js';

package/lib/templates.d.ts

@@ -0,0 +1,19 @@
+import type { AssembleSystemPromptArgs, BuildUserMessageArgs, PromptAddon, PromptLibrary, PromptMode } from './types.js';
+export declare const PROMPT_LIBRARY_VERSION = "2026-03-06.1";
+export declare const SYSTEM_CORE = "You generate Continuum ViewDefinition JSON.\n\nOutput requirements:\n- Return JSON only (no markdown, no commentary).\n- Top-level shape:\n  {\n    \"viewId\": string,\n    \"version\": string,\n    \"nodes\": ViewNode[]\n  }\n\nCore continuity rules:\n- Keep viewId stable for the same logical workflow.\n- Change version when structure changes.\n- Keep node ids unique in the full tree.\n- Keep semantic keys stable across versions when meaning is unchanged.\n- Preserve unchanged semantics whenever possible.\n\nRendering constraints:\n- Only use node types that this app explicitly supports.\n- Include required fields for each node type.\n- For option-based nodes, include options as [{ \"value\": string, \"label\": string }].\n- For collection nodes, include a valid template node.";
+export declare const MODE_CREATE_VIEW = "Mode: Create a brand-new view from user intent.\n\nGuidance:\n- Optimize for clarity and completion of the user task.\n- Choose a layout that fits the task and data complexity.\n- Include labels and sensible defaults when helpful.\n- Prefer semantic keys that remain meaningful in future versions.\n\nFor this app, supported node types are:\n- field (requires dataType: string | number | boolean)\n- textarea\n- date\n- select (requires options)\n- radio-group (requires options)\n- slider (requires min and max)\n- toggle\n- action (requires intentId and label)\n- group (requires children)\n- row (requires children)\n- grid (requires children, optional columns)\n- collection (requires template, optional defaultValues)\n- presentation (requires contentType and content)\n\nIf uncertain:\n- Use simple, explicit structures first.\n- Avoid creating deeply nested trees unless clearly beneficial.";
+export declare const MODE_EVOLVE_VIEW = "Mode: Evolve an existing view.\n\nInput context will include:\n- currentView JSON\n- user instruction describing changes\n\nGuidance:\n- Evolve currentView instead of regenerating from scratch.\n- Preserve semantic continuity when meaning is unchanged.\n- Keep stable keys for unchanged semantics.\n- You may restructure layout containers when useful.\n- If semantics change, update key/type intentionally and clearly.\n\nContinuity preferences:\n- Preserve existing node ids when possible.\n- If id changes, keep key stable when semantics are unchanged.\n- Avoid unnecessary key churn.\n\nOutput:\n- Full next ViewDefinition JSON.";
+export declare const MODE_CORRECTION_LOOP = "Mode: Correct a rejected or problematic view.\n\nInput context will include:\n- currentView JSON\n- original instruction\n- validation errors\n- runtime errors\n- detached node ids (if any)\n\nCorrection goals:\n- Resolve all listed validation and runtime errors.\n- Preserve semantic keys for unchanged fields.\n- Avoid duplicate ids and duplicate scoped keys.\n- Reduce detached outcomes unless semantics truly changed.\n\nOutput requirements:\n- Return a corrected full ViewDefinition.\n- Keep only relevant structural changes needed to resolve errors.";
+export declare const ADDON_ATTACHMENTS = "Attachment extraction addon.\n\nWhen attachments (documents/images) are present:\n- Extract known values and populate defaultValue/defaultValues when confidence is high.\n- Do not invent uncertain values.\n- Use placeholder as hint text only, not as extracted data storage.\n\nField-specific rules:\n- date values should be YYYY-MM-DD.\n- select/radio-group defaultValue should be one of the option values.\n- collection defaultValues should include one entry per extracted line item.";
+export declare const ADDON_STRICT_CONTINUITY = "Strict continuity addon.\n\nApply stronger bias toward continuity:\n- Do not change keys for unchanged semantic meaning.\n- Do not change node type for unchanged semantic meaning.\n- Do not remove existing fields unless the user explicitly requests removal.\n- Do not split or merge collections unless explicitly requested.\n\nAllowed flexibility:\n- Layout container changes are allowed when semantics are preserved.\n- New fields can be added when clearly requested or required.";
+export declare const EXAMPLE_CREATE_VIEW_USER_MESSAGE = "Create a mortgage intake form for first-time home buyers.\n\nRequirements:\n- Capture borrower identity, contact info, employment, income, assets, liabilities.\n- Include a co-borrower section that can stay hidden until user enables it.\n- Include a collection for liabilities with creditor, balance, monthlyPayment.\n- Include one action node for \"submit_prequal\".\n\nKeep the structure understandable for non-technical users.";
+export declare const EXAMPLE_EVOLVE_VIEW_USER_MESSAGE = "Current view is provided.\n\nPlease evolve it with these changes:\n- Add a co-borrower employment subsection.\n- Add a date field for lease_end_date in housing details.\n- Keep all existing semantic keys for unchanged meaning.\n- Keep action intent ids unchanged.\n\nYou may adjust layout containers if needed.";
+export declare const EXAMPLE_CORRECTION_LOOP_USER_MESSAGE = "Current view and diagnostics are provided.\n\nRegenerate a corrected full view that:\n- resolves all validation errors\n- resolves runtime errors\n- avoids duplicate ids and duplicate scoped keys\n- preserves semantic keys and node types for unchanged meaning\n\nDo not make unrelated structural changes.";
+export declare const PROMPT_LIBRARY: PromptLibrary;
+export declare function assembleSystemPrompt(args: AssembleSystemPromptArgs): string;
+export declare function buildCreateUserMessage(instruction: string): string;
+export declare function buildEvolveUserMessage(args: BuildUserMessageArgs): string;
+export declare function buildCorrectionUserMessage(args: BuildUserMessageArgs): string;
+export declare function getModePrompt(mode: PromptMode): string;
+export declare function getAddonPrompt(addon: PromptAddon): string;
+//# sourceMappingURL=templates.d.ts.map

package/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../packages/prompts/src/lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,eAAO,MAAM,WAAW,yxBAsB+B,CAAC;AAExD,eAAO,MAAM,gBAAgB,s4BAyBmC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,4nBAmBI,CAAC;AAElC,eAAO,MAAM,oBAAoB,gjBAiBiC,CAAC;AAEnE,eAAO,MAAM,iBAAiB,yeAU+C,CAAC;AAE9E,eAAO,MAAM,uBAAuB,qeAU0B,CAAC;AAE/D,eAAO,MAAM,gCAAgC,kbAQc,CAAC;AAE5D,eAAO,MAAM,gCAAgC,2TAQD,CAAC;AAE7C,eAAO,MAAM,oCAAoC,qTAQP,CAAC;AAE3C,eAAO,MAAM,cAAc,EAAE,aAY5B,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAM3E;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CASzE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAgB7E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEzD"}

package/lib/templates.js

@@ -0,0 +1,193 @@
+export const PROMPT_LIBRARY_VERSION = '2026-03-06.1';
+export const SYSTEM_CORE = `You generate Continuum ViewDefinition JSON.
+
+Output requirements:
+- Return JSON only (no markdown, no commentary).
+- Top-level shape:
+  {
+    "viewId": string,
+    "version": string,
+    "nodes": ViewNode[]
+  }
+
+Core continuity rules:
+- Keep viewId stable for the same logical workflow.
+- Change version when structure changes.
+- Keep node ids unique in the full tree.
+- Keep semantic keys stable across versions when meaning is unchanged.
+- Preserve unchanged semantics whenever possible.
+
+Rendering constraints:
+- Only use node types that this app explicitly supports.
+- Include required fields for each node type.
+- For option-based nodes, include options as [{ "value": string, "label": string }].
+- For collection nodes, include a valid template node.`;
+export const MODE_CREATE_VIEW = `Mode: Create a brand-new view from user intent.
+
+Guidance:
+- Optimize for clarity and completion of the user task.
+- Choose a layout that fits the task and data complexity.
+- Include labels and sensible defaults when helpful.
+- Prefer semantic keys that remain meaningful in future versions.
+
+For this app, supported node types are:
+- field (requires dataType: string | number | boolean)
+- textarea
+- date
+- select (requires options)
+- radio-group (requires options)
+- slider (requires min and max)
+- toggle
+- action (requires intentId and label)
+- group (requires children)
+- row (requires children)
+- grid (requires children, optional columns)
+- collection (requires template, optional defaultValues)
+- presentation (requires contentType and content)
+
+If uncertain:
+- Use simple, explicit structures first.
+- Avoid creating deeply nested trees unless clearly beneficial.`;
+export const MODE_EVOLVE_VIEW = `Mode: Evolve an existing view.
+
+Input context will include:
+- currentView JSON
+- user instruction describing changes
+
+Guidance:
+- Evolve currentView instead of regenerating from scratch.
+- Preserve semantic continuity when meaning is unchanged.
+- Keep stable keys for unchanged semantics.
+- You may restructure layout containers when useful.
+- If semantics change, update key/type intentionally and clearly.
+
+Continuity preferences:
+- Preserve existing node ids when possible.
+- If id changes, keep key stable when semantics are unchanged.
+- Avoid unnecessary key churn.
+
+Output:
+- Full next ViewDefinition JSON.`;
+export const MODE_CORRECTION_LOOP = `Mode: Correct a rejected or problematic view.
+
+Input context will include:
+- currentView JSON
+- original instruction
+- validation errors
+- runtime errors
+- detached node ids (if any)
+
+Correction goals:
+- Resolve all listed validation and runtime errors.
+- Preserve semantic keys for unchanged fields.
+- Avoid duplicate ids and duplicate scoped keys.
+- Reduce detached outcomes unless semantics truly changed.
+
+Output requirements:
+- Return a corrected full ViewDefinition.
+- Keep only relevant structural changes needed to resolve errors.`;
+export const ADDON_ATTACHMENTS = `Attachment extraction addon.
+
+When attachments (documents/images) are present:
+- Extract known values and populate defaultValue/defaultValues when confidence is high.
+- Do not invent uncertain values.
+- Use placeholder as hint text only, not as extracted data storage.
+
+Field-specific rules:
+- date values should be YYYY-MM-DD.
+- select/radio-group defaultValue should be one of the option values.
+- collection defaultValues should include one entry per extracted line item.`;
+export const ADDON_STRICT_CONTINUITY = `Strict continuity addon.
+
+Apply stronger bias toward continuity:
+- Do not change keys for unchanged semantic meaning.
+- Do not change node type for unchanged semantic meaning.
+- Do not remove existing fields unless the user explicitly requests removal.
+- Do not split or merge collections unless explicitly requested.
+
+Allowed flexibility:
+- Layout container changes are allowed when semantics are preserved.
+- New fields can be added when clearly requested or required.`;
+export const EXAMPLE_CREATE_VIEW_USER_MESSAGE = `Create a mortgage intake form for first-time home buyers.
+
+Requirements:
+- Capture borrower identity, contact info, employment, income, assets, liabilities.
+- Include a co-borrower section that can stay hidden until user enables it.
+- Include a collection for liabilities with creditor, balance, monthlyPayment.
+- Include one action node for "submit_prequal".
+
+Keep the structure understandable for non-technical users.`;
+export const EXAMPLE_EVOLVE_VIEW_USER_MESSAGE = `Current view is provided.
+
+Please evolve it with these changes:
+- Add a co-borrower employment subsection.
+- Add a date field for lease_end_date in housing details.
+- Keep all existing semantic keys for unchanged meaning.
+- Keep action intent ids unchanged.
+
+You may adjust layout containers if needed.`;
+export const EXAMPLE_CORRECTION_LOOP_USER_MESSAGE = `Current view and diagnostics are provided.
+
+Regenerate a corrected full view that:
+- resolves all validation errors
+- resolves runtime errors
+- avoids duplicate ids and duplicate scoped keys
+- preserves semantic keys and node types for unchanged meaning
+
+Do not make unrelated structural changes.`;
+export const PROMPT_LIBRARY = {
+    version: PROMPT_LIBRARY_VERSION,
+    base: SYSTEM_CORE,
+    modes: {
+        'create-view': MODE_CREATE_VIEW,
+        'evolve-view': MODE_EVOLVE_VIEW,
+        'correction-loop': MODE_CORRECTION_LOOP,
+    },
+    addons: {
+        attachments: ADDON_ATTACHMENTS,
+        'strict-continuity': ADDON_STRICT_CONTINUITY,
+    },
+};
+function uniqueAddons(addons = []) {
+    return Array.from(new Set(addons));
+}
+export function assembleSystemPrompt(args) {
+    const sections = [PROMPT_LIBRARY.base, PROMPT_LIBRARY.modes[args.mode]];
+    for (const addon of uniqueAddons(args.addons)) {
+        sections.push(PROMPT_LIBRARY.addons[addon]);
+    }
+    return sections.join('\n\n');
+}
+export function buildCreateUserMessage(instruction) {
+    return instruction.trim();
+}
+export function buildEvolveUserMessage(args) {
+    if (typeof args.currentView === 'undefined') {
+        throw new Error('buildEvolveUserMessage requires currentView');
+    }
+    return [
+        `Current view:\n${JSON.stringify(args.currentView, null, 2)}`,
+        `Instruction:\n${args.instruction.trim()}`,
+    ].join('\n\n');
+}
+export function buildCorrectionUserMessage(args) {
+    if (typeof args.currentView === 'undefined') {
+        throw new Error('buildCorrectionUserMessage requires currentView');
+    }
+    const validationErrors = args.validationErrors ?? [];
+    const runtimeErrors = args.runtimeErrors ?? [];
+    const detachedNodeIds = args.detachedNodeIds ?? [];
+    return [
+        `Current view:\n${JSON.stringify(args.currentView, null, 2)}`,
+        `Instruction:\n${args.instruction.trim()}`,
+        `Validation errors:\n${validationErrors.length > 0 ? validationErrors.join('\n') : 'none'}`,
+        `Runtime errors:\n${runtimeErrors.length > 0 ? runtimeErrors.join(', ') : 'none'}`,
+        `Detached node ids:\n${detachedNodeIds.length > 0 ? detachedNodeIds.join(', ') : 'none'}`,
+    ].join('\n\n');
+}
+export function getModePrompt(mode) {
+    return PROMPT_LIBRARY.modes[mode];
+}
+export function getAddonPrompt(addon) {
+    return PROMPT_LIBRARY.addons[addon];
+}

package/lib/types.d.ts

@@ -0,0 +1,20 @@
+export type PromptMode = 'create-view' | 'evolve-view' | 'correction-loop';
+export type PromptAddon = 'attachments' | 'strict-continuity';
+export interface PromptLibrary {
+    version: string;
+    base: string;
+    modes: Record<PromptMode, string>;
+    addons: Record<PromptAddon, string>;
+}
+export interface AssembleSystemPromptArgs {
+    mode: PromptMode;
+    addons?: PromptAddon[];
+}
+export interface BuildUserMessageArgs {
+    currentView?: unknown;
+    instruction: string;
+    validationErrors?: string[];
+    runtimeErrors?: string[];
+    detachedNodeIds?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/prompts/src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@continuum-dev/prompts",
+  "version": "0.1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Prompt templates and helpers for Continuum AI view generation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brytoncooper/cooper-continuum.git",
+    "directory": "packages/prompts"
+  },
+  "author": "Bryton Cooper",
+  "keywords": [
+    "continuum",
+    "ai",
+    "prompt",
+    "viewdefinition",
+    "reconciliation"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "**/*.js",
+    "**/*.d.ts",
+    "**/*.d.ts.map",
+    "README.md",
+    "LICENSE*"
+  ]
+}