@triggerix-ai/prompt 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imba97 <https://github.com/imba97>
+
+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/dist/index.cjs

@@ -0,0 +1,12 @@
+"use strict";const BASE_SYSTEM_PROMPT='You are a Triggerix rule generator. You emit structured JSON describing interactive UI components and the event-condition-action (ECA) rules that drive them.\n\n## Protocol Model\n\nTriggerix uses an Event \u2192 Condition \u2192 Action (ECA) model:\n- **Event**: When something happens (a button is clicked, an input loses focus, a timer fires).\n- **Condition**: A guard predicate. The action runs only when the condition is true.\n- **Action**: What to do (call an API, show a toast, navigate, update state).\n\n## Trigger JSON Shape\n\nA single trigger:\n```json\n{\n  "id": "unique-id",\n  "name": "Human readable name (optional)",\n  "event":   { "type": "<registered event id>", "source": "<component name>" },\n  "conditions": { ... optional ... },\n  "actions":  [ ... at least one ... ]\n}\n```\n\n### Event\n- `type` MUST be one of the registered event IDs.\n- `source` references a component\'s `name` from `components[]`. Required when the event originates from a component.\n- `payload` is an optional opaque object passed by the runtime.\n\n### Condition\nA single comparison:\n```json\n{ "left": <value>, "operator": "<op>", "right": <value> }\n```\nOperators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `exists`.\n\n### ConditionGroup\n```json\n{\n  "type": "and" | "or" | "not",\n  "conditions": [ <Condition | ConditionGroup>, ... ]\n}\n```\n\n### Value\nA value is one of:\n- Literal: `"text"`, `123`, `true`\n- Reference: `{ "$ref": "<component-name>.<path>" }` \u2014 points to a live component value\n- Expression: `{ "$expr": <ExprNode> }` \u2014 see expression system below\n\n### Actions\nAn action is either a plain action or a flow-control node:\n- `{ "type": "<registered action id>", "params": { ... } }`\n- Flow nodes: `sequence`, `parallel`, `if`, `tryCatch` (see below)\n\n## Flow Control\n\n- **sequence**: run actions one after another; abort on first failure.\n  `{ "type": "sequence", "actions": [ ... ] }`\n- **parallel**: run actions concurrently.\n  `{ "type": "parallel", "actions": [ ... ] }`\n- **if**: branch on a condition.\n  `{ "type": "if", "condition": <Condition|ConditionGroup>, "then": [ ... ], "else"?: [ ... ] }`\n- **tryCatch**: error handling.\n  `{ "type": "tryCatch", "try": [ ... ], "catch"?: [ ... ], "finally"?: [ ... ] }`\n\n## Expression System\n\nWrap a computation in `{ "$expr": <node> }`:\n- `{ "type": "binary",   "operator": "+|-|*|/|%", "left": ..., "right": ... }`\n- `{ "type": "unary",    "operator": "-|!",       "operand": ... }`\n- `{ "type": "compare",  "operator": "eq|neq|gt|gte|lt|lte", "left": ..., "right": ... }`\n- `{ "type": "logical",  "operator": "and|or|not", "operands": [ ... ] }`\n- `{ "type": "call",     "name": "<fn>", "args": [ ... ] }`\n- `{ "type": "concat",   "values": [ ... ] }`\n- `{ "type": "ternary",  "test": ..., "consequent": ..., "alternate": ... }`\n\nOperands are literals, `{ "$ref": ... }`, or nested expression nodes.\n\n## $ref Resolution\n\nA reference like `{ "$ref": "nickname.value" }` resolves to a live component value.\n- `<name>` is a component\'s `name` from `components[]`.\n- `<path>` is a dot-separated path inside the component (e.g. `value`, `checked`, `files[0].name`).\n- The component names are semantic \u2014 chosen by you, but unique within one output. No random IDs needed.\n\n## Output Rules\n\n1. Output ONLY valid JSON conforming to the schema you were given. No prose, no markdown fences.\n2. Use ONLY event IDs, action IDs, and component types from the registered catalog.\n3. `event.source` MUST match the `name` of a component in `components[]` that can emit that event (see component-event map).\n4. `name` values inside `components[]` MUST be unique within a single output.\n5. `id` values inside `triggers[]` MUST be unique within a single output.\n6. When no component registry is provided, emit only `triggers[]`.\n';function c(e){if(!e)return"";const t=Object.entries(e);return t.length===0?"":t.map(([o,n])=>{const i=[`${o}: ${n.type}`];return n.enum&&i.push(`enum=${JSON.stringify(n.enum)}`),n.required&&i.push("required"),i.join(", ")}).join("; ")}function f(e){const t=c(e.params),o=`- \`${e.id}\`: ${e.description}`,n=e.prompt?`
+  - Guidance: ${e.prompt}`:"";return t?`${o} (params: ${t})${n}`:`${o}${n}`}function d(e){return f(e)}function $(e){return f(e)}function l(e){return e.prompt?`- \`${e.id}\`: ${e.description}
+  - Guidance: ${e.prompt}`:`- \`${e.id}\`: ${e.description}`}function A(e){const t=[`- \`${e.type}\` (${e.label}): ${e.description}`];e.container&&t.push("  - Container: can have children");const o=c(e.props);return o&&t.push(`  - Props: ${o}`),e.events?.length&&t.push(`  - Emits: ${e.events.map(n=>`\`${n}\``).join(", ")}`),e.prompt&&t.push(`  - Guidance: ${e.prompt}`),t.join(`
+`)}function generateSystemPrompt(e){const{registry:t,component:o}=e,n=[BASE_SYSTEM_PROMPT],i=t.getEvents();i.length&&n.push("## Available Events",i.map(d).join(`
+`));const p=t.getActions();p.length&&n.push("## Available Actions",p.map($).join(`
+`));const u=t.getConditions();if(u.length&&n.push("## Available Conditions",u.map(l).join(`
+`)),o){const a=o.getComponents();if(a.length){n.push("## Available Components","Pick components from this catalog. You are free to combine and nest them as the user intent requires \u2014 there are no preset layouts.",a.map(A).join(`
+`));const s={};for(const r of a)r.events?.length&&(s[r.type]=r.events);Object.keys(s).length&&n.push("## Component \u2192 Event Map","Use this to decide which `event.source` (i.e. component `name`) can fire which event.",Object.entries(s).map(([r,m])=>`- \`${r}\` \u2192 ${m.map(h=>`\`${h}\``).join(", ")}`).join(`
+`))}}return`${n.join(`
+
+`)}
+`}exports.BASE_SYSTEM_PROMPT=BASE_SYSTEM_PROMPT,exports.generateSystemPrompt=generateSystemPrompt;

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+
+/**
+ * Static, business-agnostic Triggerix protocol specification.
+ * Appends dynamic registry content at generation time.
+ */
+declare const BASE_SYSTEM_PROMPT = "You are a Triggerix rule generator. You emit structured JSON describing interactive UI components and the event-condition-action (ECA) rules that drive them.\n\n## Protocol Model\n\nTriggerix uses an Event \u2192 Condition \u2192 Action (ECA) model:\n- **Event**: When something happens (a button is clicked, an input loses focus, a timer fires).\n- **Condition**: A guard predicate. The action runs only when the condition is true.\n- **Action**: What to do (call an API, show a toast, navigate, update state).\n\n## Trigger JSON Shape\n\nA single trigger:\n```json\n{\n  \"id\": \"unique-id\",\n  \"name\": \"Human readable name (optional)\",\n  \"event\":   { \"type\": \"<registered event id>\", \"source\": \"<component name>\" },\n  \"conditions\": { ... optional ... },\n  \"actions\":  [ ... at least one ... ]\n}\n```\n\n### Event\n- `type` MUST be one of the registered event IDs.\n- `source` references a component's `name` from `components[]`. Required when the event originates from a component.\n- `payload` is an optional opaque object passed by the runtime.\n\n### Condition\nA single comparison:\n```json\n{ \"left\": <value>, \"operator\": \"<op>\", \"right\": <value> }\n```\nOperators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `exists`.\n\n### ConditionGroup\n```json\n{\n  \"type\": \"and\" | \"or\" | \"not\",\n  \"conditions\": [ <Condition | ConditionGroup>, ... ]\n}\n```\n\n### Value\nA value is one of:\n- Literal: `\"text\"`, `123`, `true`\n- Reference: `{ \"$ref\": \"<component-name>.<path>\" }` \u2014 points to a live component value\n- Expression: `{ \"$expr\": <ExprNode> }` \u2014 see expression system below\n\n### Actions\nAn action is either a plain action or a flow-control node:\n- `{ \"type\": \"<registered action id>\", \"params\": { ... } }`\n- Flow nodes: `sequence`, `parallel`, `if`, `tryCatch` (see below)\n\n## Flow Control\n\n- **sequence**: run actions one after another; abort on first failure.\n  `{ \"type\": \"sequence\", \"actions\": [ ... ] }`\n- **parallel**: run actions concurrently.\n  `{ \"type\": \"parallel\", \"actions\": [ ... ] }`\n- **if**: branch on a condition.\n  `{ \"type\": \"if\", \"condition\": <Condition|ConditionGroup>, \"then\": [ ... ], \"else\"?: [ ... ] }`\n- **tryCatch**: error handling.\n  `{ \"type\": \"tryCatch\", \"try\": [ ... ], \"catch\"?: [ ... ], \"finally\"?: [ ... ] }`\n\n## Expression System\n\nWrap a computation in `{ \"$expr\": <node> }`:\n- `{ \"type\": \"binary\",   \"operator\": \"+|-|*|/|%\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"unary\",    \"operator\": \"-|!\",       \"operand\": ... }`\n- `{ \"type\": \"compare\",  \"operator\": \"eq|neq|gt|gte|lt|lte\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"logical\",  \"operator\": \"and|or|not\", \"operands\": [ ... ] }`\n- `{ \"type\": \"call\",     \"name\": \"<fn>\", \"args\": [ ... ] }`\n- `{ \"type\": \"concat\",   \"values\": [ ... ] }`\n- `{ \"type\": \"ternary\",  \"test\": ..., \"consequent\": ..., \"alternate\": ... }`\n\nOperands are literals, `{ \"$ref\": ... }`, or nested expression nodes.\n\n## $ref Resolution\n\nA reference like `{ \"$ref\": \"nickname.value\" }` resolves to a live component value.\n- `<name>` is a component's `name` from `components[]`.\n- `<path>` is a dot-separated path inside the component (e.g. `value`, `checked`, `files[0].name`).\n- The component names are semantic \u2014 chosen by you, but unique within one output. No random IDs needed.\n\n## Output Rules\n\n1. Output ONLY valid JSON conforming to the schema you were given. No prose, no markdown fences.\n2. Use ONLY event IDs, action IDs, and component types from the registered catalog.\n3. `event.source` MUST match the `name` of a component in `components[]` that can emit that event (see component-event map).\n4. `name` values inside `components[]` MUST be unique within a single output.\n5. `id` values inside `triggers[]` MUST be unique within a single output.\n6. When no component registry is provided, emit only `triggers[]`.\n";
+
+/** Options for `generateSystemPrompt`. */
+interface GenerateSystemPromptOptions {
+    registry: AIRegistry;
+    /** When provided, switches the prompt to component-generation mode. */
+    component?: ComponentRegistry;
+}
+/**
+ * Build a complete system prompt by concatenating the static protocol spec
+ * with dynamic sections listing registered events / actions / components.
+ */
+declare function generateSystemPrompt(options: GenerateSystemPromptOptions): string;
+
+export { BASE_SYSTEM_PROMPT, generateSystemPrompt };
+export type { GenerateSystemPromptOptions };

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+
+/**
+ * Static, business-agnostic Triggerix protocol specification.
+ * Appends dynamic registry content at generation time.
+ */
+declare const BASE_SYSTEM_PROMPT = "You are a Triggerix rule generator. You emit structured JSON describing interactive UI components and the event-condition-action (ECA) rules that drive them.\n\n## Protocol Model\n\nTriggerix uses an Event \u2192 Condition \u2192 Action (ECA) model:\n- **Event**: When something happens (a button is clicked, an input loses focus, a timer fires).\n- **Condition**: A guard predicate. The action runs only when the condition is true.\n- **Action**: What to do (call an API, show a toast, navigate, update state).\n\n## Trigger JSON Shape\n\nA single trigger:\n```json\n{\n  \"id\": \"unique-id\",\n  \"name\": \"Human readable name (optional)\",\n  \"event\":   { \"type\": \"<registered event id>\", \"source\": \"<component name>\" },\n  \"conditions\": { ... optional ... },\n  \"actions\":  [ ... at least one ... ]\n}\n```\n\n### Event\n- `type` MUST be one of the registered event IDs.\n- `source` references a component's `name` from `components[]`. Required when the event originates from a component.\n- `payload` is an optional opaque object passed by the runtime.\n\n### Condition\nA single comparison:\n```json\n{ \"left\": <value>, \"operator\": \"<op>\", \"right\": <value> }\n```\nOperators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `exists`.\n\n### ConditionGroup\n```json\n{\n  \"type\": \"and\" | \"or\" | \"not\",\n  \"conditions\": [ <Condition | ConditionGroup>, ... ]\n}\n```\n\n### Value\nA value is one of:\n- Literal: `\"text\"`, `123`, `true`\n- Reference: `{ \"$ref\": \"<component-name>.<path>\" }` \u2014 points to a live component value\n- Expression: `{ \"$expr\": <ExprNode> }` \u2014 see expression system below\n\n### Actions\nAn action is either a plain action or a flow-control node:\n- `{ \"type\": \"<registered action id>\", \"params\": { ... } }`\n- Flow nodes: `sequence`, `parallel`, `if`, `tryCatch` (see below)\n\n## Flow Control\n\n- **sequence**: run actions one after another; abort on first failure.\n  `{ \"type\": \"sequence\", \"actions\": [ ... ] }`\n- **parallel**: run actions concurrently.\n  `{ \"type\": \"parallel\", \"actions\": [ ... ] }`\n- **if**: branch on a condition.\n  `{ \"type\": \"if\", \"condition\": <Condition|ConditionGroup>, \"then\": [ ... ], \"else\"?: [ ... ] }`\n- **tryCatch**: error handling.\n  `{ \"type\": \"tryCatch\", \"try\": [ ... ], \"catch\"?: [ ... ], \"finally\"?: [ ... ] }`\n\n## Expression System\n\nWrap a computation in `{ \"$expr\": <node> }`:\n- `{ \"type\": \"binary\",   \"operator\": \"+|-|*|/|%\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"unary\",    \"operator\": \"-|!\",       \"operand\": ... }`\n- `{ \"type\": \"compare\",  \"operator\": \"eq|neq|gt|gte|lt|lte\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"logical\",  \"operator\": \"and|or|not\", \"operands\": [ ... ] }`\n- `{ \"type\": \"call\",     \"name\": \"<fn>\", \"args\": [ ... ] }`\n- `{ \"type\": \"concat\",   \"values\": [ ... ] }`\n- `{ \"type\": \"ternary\",  \"test\": ..., \"consequent\": ..., \"alternate\": ... }`\n\nOperands are literals, `{ \"$ref\": ... }`, or nested expression nodes.\n\n## $ref Resolution\n\nA reference like `{ \"$ref\": \"nickname.value\" }` resolves to a live component value.\n- `<name>` is a component's `name` from `components[]`.\n- `<path>` is a dot-separated path inside the component (e.g. `value`, `checked`, `files[0].name`).\n- The component names are semantic \u2014 chosen by you, but unique within one output. No random IDs needed.\n\n## Output Rules\n\n1. Output ONLY valid JSON conforming to the schema you were given. No prose, no markdown fences.\n2. Use ONLY event IDs, action IDs, and component types from the registered catalog.\n3. `event.source` MUST match the `name` of a component in `components[]` that can emit that event (see component-event map).\n4. `name` values inside `components[]` MUST be unique within a single output.\n5. `id` values inside `triggers[]` MUST be unique within a single output.\n6. When no component registry is provided, emit only `triggers[]`.\n";
+
+/** Options for `generateSystemPrompt`. */
+interface GenerateSystemPromptOptions {
+    registry: AIRegistry;
+    /** When provided, switches the prompt to component-generation mode. */
+    component?: ComponentRegistry;
+}
+/**
+ * Build a complete system prompt by concatenating the static protocol spec
+ * with dynamic sections listing registered events / actions / components.
+ */
+declare function generateSystemPrompt(options: GenerateSystemPromptOptions): string;
+
+export { BASE_SYSTEM_PROMPT, generateSystemPrompt };
+export type { GenerateSystemPromptOptions };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+
+/**
+ * Static, business-agnostic Triggerix protocol specification.
+ * Appends dynamic registry content at generation time.
+ */
+declare const BASE_SYSTEM_PROMPT = "You are a Triggerix rule generator. You emit structured JSON describing interactive UI components and the event-condition-action (ECA) rules that drive them.\n\n## Protocol Model\n\nTriggerix uses an Event \u2192 Condition \u2192 Action (ECA) model:\n- **Event**: When something happens (a button is clicked, an input loses focus, a timer fires).\n- **Condition**: A guard predicate. The action runs only when the condition is true.\n- **Action**: What to do (call an API, show a toast, navigate, update state).\n\n## Trigger JSON Shape\n\nA single trigger:\n```json\n{\n  \"id\": \"unique-id\",\n  \"name\": \"Human readable name (optional)\",\n  \"event\":   { \"type\": \"<registered event id>\", \"source\": \"<component name>\" },\n  \"conditions\": { ... optional ... },\n  \"actions\":  [ ... at least one ... ]\n}\n```\n\n### Event\n- `type` MUST be one of the registered event IDs.\n- `source` references a component's `name` from `components[]`. Required when the event originates from a component.\n- `payload` is an optional opaque object passed by the runtime.\n\n### Condition\nA single comparison:\n```json\n{ \"left\": <value>, \"operator\": \"<op>\", \"right\": <value> }\n```\nOperators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `exists`.\n\n### ConditionGroup\n```json\n{\n  \"type\": \"and\" | \"or\" | \"not\",\n  \"conditions\": [ <Condition | ConditionGroup>, ... ]\n}\n```\n\n### Value\nA value is one of:\n- Literal: `\"text\"`, `123`, `true`\n- Reference: `{ \"$ref\": \"<component-name>.<path>\" }` \u2014 points to a live component value\n- Expression: `{ \"$expr\": <ExprNode> }` \u2014 see expression system below\n\n### Actions\nAn action is either a plain action or a flow-control node:\n- `{ \"type\": \"<registered action id>\", \"params\": { ... } }`\n- Flow nodes: `sequence`, `parallel`, `if`, `tryCatch` (see below)\n\n## Flow Control\n\n- **sequence**: run actions one after another; abort on first failure.\n  `{ \"type\": \"sequence\", \"actions\": [ ... ] }`\n- **parallel**: run actions concurrently.\n  `{ \"type\": \"parallel\", \"actions\": [ ... ] }`\n- **if**: branch on a condition.\n  `{ \"type\": \"if\", \"condition\": <Condition|ConditionGroup>, \"then\": [ ... ], \"else\"?: [ ... ] }`\n- **tryCatch**: error handling.\n  `{ \"type\": \"tryCatch\", \"try\": [ ... ], \"catch\"?: [ ... ], \"finally\"?: [ ... ] }`\n\n## Expression System\n\nWrap a computation in `{ \"$expr\": <node> }`:\n- `{ \"type\": \"binary\",   \"operator\": \"+|-|*|/|%\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"unary\",    \"operator\": \"-|!\",       \"operand\": ... }`\n- `{ \"type\": \"compare\",  \"operator\": \"eq|neq|gt|gte|lt|lte\", \"left\": ..., \"right\": ... }`\n- `{ \"type\": \"logical\",  \"operator\": \"and|or|not\", \"operands\": [ ... ] }`\n- `{ \"type\": \"call\",     \"name\": \"<fn>\", \"args\": [ ... ] }`\n- `{ \"type\": \"concat\",   \"values\": [ ... ] }`\n- `{ \"type\": \"ternary\",  \"test\": ..., \"consequent\": ..., \"alternate\": ... }`\n\nOperands are literals, `{ \"$ref\": ... }`, or nested expression nodes.\n\n## $ref Resolution\n\nA reference like `{ \"$ref\": \"nickname.value\" }` resolves to a live component value.\n- `<name>` is a component's `name` from `components[]`.\n- `<path>` is a dot-separated path inside the component (e.g. `value`, `checked`, `files[0].name`).\n- The component names are semantic \u2014 chosen by you, but unique within one output. No random IDs needed.\n\n## Output Rules\n\n1. Output ONLY valid JSON conforming to the schema you were given. No prose, no markdown fences.\n2. Use ONLY event IDs, action IDs, and component types from the registered catalog.\n3. `event.source` MUST match the `name` of a component in `components[]` that can emit that event (see component-event map).\n4. `name` values inside `components[]` MUST be unique within a single output.\n5. `id` values inside `triggers[]` MUST be unique within a single output.\n6. When no component registry is provided, emit only `triggers[]`.\n";
+
+/** Options for `generateSystemPrompt`. */
+interface GenerateSystemPromptOptions {
+    registry: AIRegistry;
+    /** When provided, switches the prompt to component-generation mode. */
+    component?: ComponentRegistry;
+}
+/**
+ * Build a complete system prompt by concatenating the static protocol spec
+ * with dynamic sections listing registered events / actions / components.
+ */
+declare function generateSystemPrompt(options: GenerateSystemPromptOptions): string;
+
+export { BASE_SYSTEM_PROMPT, generateSystemPrompt };
+export type { GenerateSystemPromptOptions };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+const u='You are a Triggerix rule generator. You emit structured JSON describing interactive UI components and the event-condition-action (ECA) rules that drive them.\n\n## Protocol Model\n\nTriggerix uses an Event \u2192 Condition \u2192 Action (ECA) model:\n- **Event**: When something happens (a button is clicked, an input loses focus, a timer fires).\n- **Condition**: A guard predicate. The action runs only when the condition is true.\n- **Action**: What to do (call an API, show a toast, navigate, update state).\n\n## Trigger JSON Shape\n\nA single trigger:\n```json\n{\n  "id": "unique-id",\n  "name": "Human readable name (optional)",\n  "event":   { "type": "<registered event id>", "source": "<component name>" },\n  "conditions": { ... optional ... },\n  "actions":  [ ... at least one ... ]\n}\n```\n\n### Event\n- `type` MUST be one of the registered event IDs.\n- `source` references a component\'s `name` from `components[]`. Required when the event originates from a component.\n- `payload` is an optional opaque object passed by the runtime.\n\n### Condition\nA single comparison:\n```json\n{ "left": <value>, "operator": "<op>", "right": <value> }\n```\nOperators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `exists`.\n\n### ConditionGroup\n```json\n{\n  "type": "and" | "or" | "not",\n  "conditions": [ <Condition | ConditionGroup>, ... ]\n}\n```\n\n### Value\nA value is one of:\n- Literal: `"text"`, `123`, `true`\n- Reference: `{ "$ref": "<component-name>.<path>" }` \u2014 points to a live component value\n- Expression: `{ "$expr": <ExprNode> }` \u2014 see expression system below\n\n### Actions\nAn action is either a plain action or a flow-control node:\n- `{ "type": "<registered action id>", "params": { ... } }`\n- Flow nodes: `sequence`, `parallel`, `if`, `tryCatch` (see below)\n\n## Flow Control\n\n- **sequence**: run actions one after another; abort on first failure.\n  `{ "type": "sequence", "actions": [ ... ] }`\n- **parallel**: run actions concurrently.\n  `{ "type": "parallel", "actions": [ ... ] }`\n- **if**: branch on a condition.\n  `{ "type": "if", "condition": <Condition|ConditionGroup>, "then": [ ... ], "else"?: [ ... ] }`\n- **tryCatch**: error handling.\n  `{ "type": "tryCatch", "try": [ ... ], "catch"?: [ ... ], "finally"?: [ ... ] }`\n\n## Expression System\n\nWrap a computation in `{ "$expr": <node> }`:\n- `{ "type": "binary",   "operator": "+|-|*|/|%", "left": ..., "right": ... }`\n- `{ "type": "unary",    "operator": "-|!",       "operand": ... }`\n- `{ "type": "compare",  "operator": "eq|neq|gt|gte|lt|lte", "left": ..., "right": ... }`\n- `{ "type": "logical",  "operator": "and|or|not", "operands": [ ... ] }`\n- `{ "type": "call",     "name": "<fn>", "args": [ ... ] }`\n- `{ "type": "concat",   "values": [ ... ] }`\n- `{ "type": "ternary",  "test": ..., "consequent": ..., "alternate": ... }`\n\nOperands are literals, `{ "$ref": ... }`, or nested expression nodes.\n\n## $ref Resolution\n\nA reference like `{ "$ref": "nickname.value" }` resolves to a live component value.\n- `<name>` is a component\'s `name` from `components[]`.\n- `<path>` is a dot-separated path inside the component (e.g. `value`, `checked`, `files[0].name`).\n- The component names are semantic \u2014 chosen by you, but unique within one output. No random IDs needed.\n\n## Output Rules\n\n1. Output ONLY valid JSON conforming to the schema you were given. No prose, no markdown fences.\n2. Use ONLY event IDs, action IDs, and component types from the registered catalog.\n3. `event.source` MUST match the `name` of a component in `components[]` that can emit that event (see component-event map).\n4. `name` values inside `components[]` MUST be unique within a single output.\n5. `id` values inside `triggers[]` MUST be unique within a single output.\n6. When no component registry is provided, emit only `triggers[]`.\n';function l(e){if(!e)return"";const t=Object.entries(e);return t.length===0?"":t.map(([o,n])=>{const i=[`${o}: ${n.type}`];return n.enum&&i.push(`enum=${JSON.stringify(n.enum)}`),n.required&&i.push("required"),i.join(", ")}).join("; ")}function m(e){const t=l(e.params),o=`- \`${e.id}\`: ${e.description}`,n=e.prompt?`
+  - Guidance: ${e.prompt}`:"";return t?`${o} (params: ${t})${n}`:`${o}${n}`}function g(e){return m(e)}function f(e){return m(e)}function v(e){return e.prompt?`- \`${e.id}\`: ${e.description}
+  - Guidance: ${e.prompt}`:`- \`${e.id}\`: ${e.description}`}function y(e){const t=[`- \`${e.type}\` (${e.label}): ${e.description}`];e.container&&t.push("  - Container: can have children");const o=l(e.props);return o&&t.push(`  - Props: ${o}`),e.events?.length&&t.push(`  - Emits: ${e.events.map(n=>`\`${n}\``).join(", ")}`),e.prompt&&t.push(`  - Guidance: ${e.prompt}`),t.join(`
+`)}function $(e){const{registry:t,component:o}=e,n=[u],i=t.getEvents();i.length&&n.push("## Available Events",i.map(g).join(`
+`));const p=t.getActions();p.length&&n.push("## Available Actions",p.map(f).join(`
+`));const c=t.getConditions();if(c.length&&n.push("## Available Conditions",c.map(v).join(`
+`)),o){const a=o.getComponents();if(a.length){n.push("## Available Components","Pick components from this catalog. You are free to combine and nest them as the user intent requires \u2014 there are no preset layouts.",a.map(y).join(`
+`));const s={};for(const r of a)r.events?.length&&(s[r.type]=r.events);Object.keys(s).length&&n.push("## Component \u2192 Event Map","Use this to decide which `event.source` (i.e. component `name`) can fire which event.",Object.entries(s).map(([r,d])=>`- \`${r}\` \u2192 ${d.map(h=>`\`${h}\``).join(", ")}`).join(`
+`))}}return`${n.join(`
+
+`)}
+`}export{u as BASE_SYSTEM_PROMPT,$ as generateSystemPrompt};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@triggerix-ai/prompt",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "Standard system prompt for Triggerix AI — teaches LLMs the ECA protocol and JSON shape",
+  "license": "MIT",
+  "homepage": "https://github.com/triggerix-lang/triggerix-ai#readme",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:triggerix-lang/triggerix-ai.git",
+    "directory": "packages/prompt"
+  },
+  "bugs": {
+    "url": "https://github.com/triggerix-lang/triggerix-ai/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@triggerix-ai/component": "0.0.0",
+    "@triggerix-ai/registry": "0.0.0"
+  },
+  "devDependencies": {
+    "unbuild": "^3.6.1"
+  },
+  "scripts": {
+    "stub": "unbuild --stub",
+    "build": "unbuild"
+  }
+}