@jigs.design/prompt 0.3.4 → 0.3.6

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { askOf, documentOf, withDocument } from "./document.js";
 import { editRepairText, fullDocumentText, needsRepair, repairText } from "./repair.js";
-import { PromptMode, PromptOptions, SystemPromptParts, systemPrompt, systemPromptParts } from "./system-prompt.js";
+import { PromptMode, PromptOptions, PromptTag, SystemPromptParts, savedTagsSection, systemPrompt, systemPromptParts } from "./system-prompt.js";
 import { TOOL_RESULTS, toolResultsSlot } from "./tool-results.js";
 import { typeText } from "./types.js";
-export { type PromptMode, type PromptOptions, type SystemPromptParts, TOOL_RESULTS, askOf, documentOf, editRepairText, fullDocumentText, needsRepair, repairText, systemPrompt, systemPromptParts, toolResultsSlot, typeText, withDocument };
+export { type PromptMode, type PromptOptions, type PromptTag, type SystemPromptParts, TOOL_RESULTS, askOf, documentOf, editRepairText, fullDocumentText, needsRepair, repairText, savedTagsSection, systemPrompt, systemPromptParts, toolResultsSlot, typeText, withDocument };

package/dist/index.js

@@ -2,5 +2,5 @@ import { askOf, documentOf, withDocument } from "./document.js";
 import { editRepairText, fullDocumentText, needsRepair, repairText } from "./repair.js";
 import { typeText } from "./types.js";
 import { TOOL_RESULTS, toolResultsSlot } from "./tool-results.js";
-import { systemPrompt, systemPromptParts } from "./system-prompt.js";
-export { TOOL_RESULTS, askOf, documentOf, editRepairText, fullDocumentText, needsRepair, repairText, systemPrompt, systemPromptParts, toolResultsSlot, typeText, withDocument };
+import { savedTagsSection, systemPrompt, systemPromptParts } from "./system-prompt.js";
+export { TOOL_RESULTS, askOf, documentOf, editRepairText, fullDocumentText, needsRepair, repairText, savedTagsSection, systemPrompt, systemPromptParts, toolResultsSlot, typeText, withDocument };

package/dist/system-prompt.d.ts

@@ -11,6 +11,12 @@ export interface PromptOptions {
   instructions?: string;
   /** Default "document". */
   mode?: PromptMode;
+  /**
+   * Tags one user saved, rendered as `## Saved tags`, the third part
+   * (`tail`), after everything the host renders. None by default, and
+   * then the prompt is the host's alone.
+   */
+  savedTags?: ReadonlyArray<PromptTag>;
   /**
    * The host carries the `toolResults` slot (`toolResultsSlot`): add the
    * rules on reading a tool's results instead of copying them. The slot
@@ -18,6 +24,21 @@ export interface PromptOptions {
    */
   toolResults?: boolean;
 }
+/** A tag as the prompt lists it: its signature from `source`, then what it is for. */
+export interface PromptTag {
+  description: string;
+  /** A one-line use. */
+  example?: string;
+  name: string;
+  /** One `<define>`, with or without a pragma line. */
+  source: string;
+}
+/**
+ * The `## Saved tags` section for one user's tags, each as a `### <signature>`
+ * block like the app's tags; empty for none. `systemPromptParts` renders it
+ * as `tail`.
+ */
+export declare function savedTagsSection(tags: ReadonlyArray<PromptTag>): string;
 /**
  * The system prompt for writing Jigs against `host`. In document mode
  * (the default) every reply is one UI, as a session expects; in chat mode a
@@ -34,17 +55,26 @@ export interface PromptOptions {
  * changes the prefix.
  */
 export declare function systemPrompt(host: Host, options?: PromptOptions): string;
-/** The system prompt in two parts: what stays the same from turn to turn, and the rest. */
+/**
+ * The system prompt in parts: what stays the same from turn to turn, the
+ * rest of what the host renders, and one user's saved tags.
+ */
 export interface SystemPromptParts {
   /** The output rules, the language and the catalog: the part a provider can cache. */
   stable: string;
+  /**
+   * The `## Saved tags` section for `PromptOptions.savedTags`, after
+   * `variable`; empty without any. It differs per user, so it comes last.
+   */
+  tail: string;
   /** The app's instructions, the procedures and the images. */
   variable: string;
 }
 /**
  * `systemPrompt` split where what a turn may change begins, so a model call
- * can mark the first part for a provider's prompt cache. `systemPrompt` is
- * the two joined by a blank line.
+ * can mark the first part for a provider's prompt cache, and where one
+ * user's saved tags begin, so the host's parts stay the same for every user.
+ * `systemPrompt` is the first two joined by a blank line.
  */
 export declare function systemPromptParts(host: Host, options?: PromptOptions): SystemPromptParts;
 //#endregion

package/dist/system-prompt.js

@@ -228,6 +228,8 @@ function insertAfter(text, after, line) {
 }
 const TAGS_INTRO = `## App tags
 Tags this app wrote in Jigs. Use them like any tag, with the props shown; a bare prop is required. They are already defined: never write their <define>. Prefer one over building the same thing from components. When one of them alone answers the ask, the UI is that one tag and nothing else.`;
+const SAVED_TAGS_INTRO = `## Saved tags
+Tags this user saved, written in Jigs. Use them like the app's tags: with the props shown, a bare prop required, never writing their \`<define>\`. Prefer one over building the same thing from components. When one of them alone answers the ask, the UI is that one tag and nothing else.`;
 function tagSection(entry) {
 	const lines = [`### ${jigSignature({
 		name: entry.name,
@@ -236,6 +238,14 @@ function tagSection(entry) {
 	if (entry.example !== void 0) lines.push(`Example: \`${entry.example}\``);
 	return lines.join("\n");
 }
+/**
+* The `## Saved tags` section for one user's tags, each as a `### <signature>`
+* block like the app's tags; empty for none. `systemPromptParts` renders it
+* as `tail`.
+*/
+function savedTagsSection(tags) {
+	return tags.length === 0 ? "" : [SAVED_TAGS_INTRO, ...tags.map((entry) => tagSection(entry))].join("\n\n");
+}
 const SITUATIONS_INTRO = `## Situations
 Find the situation whose When matches what the reader will do with this UI. Follow its guidance where it differs from Design. Ignore the others. If none matches, follow Design alone.`;
 /**
@@ -325,8 +335,9 @@ function systemPrompt(host, options) {
 }
 /**
 * `systemPrompt` split where what a turn may change begins, so a model call
-* can mark the first part for a provider's prompt cache. `systemPrompt` is
-* the two joined by a blank line.
+* can mark the first part for a provider's prompt cache, and where one
+* user's saved tags begin, so the host's parts stay the same for every user.
+* `systemPrompt` is the first two joined by a blank line.
 */
 function systemPromptParts(host, options) {
 	const entries = Object.entries(host.procedures);
@@ -365,8 +376,9 @@ function systemPromptParts(host, options) {
 	variable.push(host.imageHosts.length === 0 ? "## Images\n- No image hosts are allowed. Do not use images." : `## Images\n- Images may only load from: ${host.imageHosts.join(", ")}. Any other URL is dropped.`);
 	return {
 		stable: sections.join("\n\n"),
+		tail: savedTagsSection(options?.savedTags ?? []),
 		variable: variable.join("\n\n")
 	};
 }
 //#endregion
-export { systemPrompt, systemPromptParts };
+export { savedTagsSection, systemPrompt, systemPromptParts };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jigs.design/prompt",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "The system prompt and the repair text, rendered from a host and from diagnostics.",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@jigs.design/compiler": "0.3.4",
-    "@jigs.design/host": "0.3.4",
-    "@jigs.design/protocol": "0.3.4"
+    "@jigs.design/compiler": "0.3.6",
+    "@jigs.design/host": "0.3.6",
+    "@jigs.design/protocol": "0.3.6"
   },
   "peerDependencies": {
     "zod": "^4.0.0"