@triggerix-ai/fn 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 @@
+"use strict";const prompt=require("@triggerix-ai/prompt"),schema=require("@triggerix-ai/schema"),p="Generate Triggerix interactive output. Call this tool to produce a complete UI bundle: a list of atomic components to render, plus a list of triggers that bind user interactions to backend actions. The output schema constrains event types, action types, and component types to those registered by the developer.",l="Generate Triggerix triggers. Call this tool to produce a list of triggers that bind events to actions under given conditions. The output schema constrains event types and action types to those registered by the developer.";function defineFunctionCalling(e){const{registry:o,component:t}=e,n=e.toolName??"generate_triggerix_output",r=e.toolDescription??(t?p:l),i=prompt.generateSystemPrompt({registry:o,component:t}),s=schema.generateToolSchema({registry:o,component:t});return{systemPrompt:i,tools:[{type:"function",function:{name:n,description:r,parameters:s}}]}}exports.defineFunctionCalling=defineFunctionCalling;

package/dist/index.d.cts

@@ -0,0 +1,46 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+import { JSONSchema } from '@triggerix-ai/schema';
+
+/** Options accepted by `defineFunctionCalling`. */
+interface DefineFunctionCallingOptions {
+    /** Registry of AI-aware events, actions, conditions. */
+    registry: AIRegistry;
+    /** When provided, switches to component-generation mode. */
+    component?: ComponentRegistry;
+    /** Override the tool name. Defaults to `'generate_triggerix_output'`. */
+    toolName?: string;
+    /** Override the tool description (defaults to a generic explanation). */
+    toolDescription?: string;
+}
+/**
+ * A tool definition in OpenAI-compatible format.
+ * Compatible with OpenAI, Anthropic (with light adaptation), and most LLM SDKs.
+ */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchema;
+    };
+}
+/** Result of `defineFunctionCalling`. */
+interface FunctionCallingResult {
+    /** Complete system prompt (protocol spec + dynamic registry content). */
+    systemPrompt: string;
+    /** Tool definitions ready to pass to the LLM. */
+    tools: ToolDefinition[];
+}
+
+/**
+ * Build the complete `system` + `tools` payload for an LLM Function Calling call.
+ *
+ * Two output modes:
+ *  - **Component-generation mode** (with `component`): the tool returns `{ components, triggers }`
+ *  - **Trigger-only mode** (no `component`): the tool returns `{ triggers }` only
+ */
+declare function defineFunctionCalling(options: DefineFunctionCallingOptions): FunctionCallingResult;
+
+export { defineFunctionCalling };
+export type { DefineFunctionCallingOptions, FunctionCallingResult, ToolDefinition };

package/dist/index.d.mts

@@ -0,0 +1,46 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+import { JSONSchema } from '@triggerix-ai/schema';
+
+/** Options accepted by `defineFunctionCalling`. */
+interface DefineFunctionCallingOptions {
+    /** Registry of AI-aware events, actions, conditions. */
+    registry: AIRegistry;
+    /** When provided, switches to component-generation mode. */
+    component?: ComponentRegistry;
+    /** Override the tool name. Defaults to `'generate_triggerix_output'`. */
+    toolName?: string;
+    /** Override the tool description (defaults to a generic explanation). */
+    toolDescription?: string;
+}
+/**
+ * A tool definition in OpenAI-compatible format.
+ * Compatible with OpenAI, Anthropic (with light adaptation), and most LLM SDKs.
+ */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchema;
+    };
+}
+/** Result of `defineFunctionCalling`. */
+interface FunctionCallingResult {
+    /** Complete system prompt (protocol spec + dynamic registry content). */
+    systemPrompt: string;
+    /** Tool definitions ready to pass to the LLM. */
+    tools: ToolDefinition[];
+}
+
+/**
+ * Build the complete `system` + `tools` payload for an LLM Function Calling call.
+ *
+ * Two output modes:
+ *  - **Component-generation mode** (with `component`): the tool returns `{ components, triggers }`
+ *  - **Trigger-only mode** (no `component`): the tool returns `{ triggers }` only
+ */
+declare function defineFunctionCalling(options: DefineFunctionCallingOptions): FunctionCallingResult;
+
+export { defineFunctionCalling };
+export type { DefineFunctionCallingOptions, FunctionCallingResult, ToolDefinition };

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { ComponentRegistry } from '@triggerix-ai/component';
+import { AIRegistry } from '@triggerix-ai/registry';
+import { JSONSchema } from '@triggerix-ai/schema';
+
+/** Options accepted by `defineFunctionCalling`. */
+interface DefineFunctionCallingOptions {
+    /** Registry of AI-aware events, actions, conditions. */
+    registry: AIRegistry;
+    /** When provided, switches to component-generation mode. */
+    component?: ComponentRegistry;
+    /** Override the tool name. Defaults to `'generate_triggerix_output'`. */
+    toolName?: string;
+    /** Override the tool description (defaults to a generic explanation). */
+    toolDescription?: string;
+}
+/**
+ * A tool definition in OpenAI-compatible format.
+ * Compatible with OpenAI, Anthropic (with light adaptation), and most LLM SDKs.
+ */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchema;
+    };
+}
+/** Result of `defineFunctionCalling`. */
+interface FunctionCallingResult {
+    /** Complete system prompt (protocol spec + dynamic registry content). */
+    systemPrompt: string;
+    /** Tool definitions ready to pass to the LLM. */
+    tools: ToolDefinition[];
+}
+
+/**
+ * Build the complete `system` + `tools` payload for an LLM Function Calling call.
+ *
+ * Two output modes:
+ *  - **Component-generation mode** (with `component`): the tool returns `{ components, triggers }`
+ *  - **Trigger-only mode** (no `component`): the tool returns `{ triggers }` only
+ */
+declare function defineFunctionCalling(options: DefineFunctionCallingOptions): FunctionCallingResult;
+
+export { defineFunctionCalling };
+export type { DefineFunctionCallingOptions, FunctionCallingResult, ToolDefinition };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{generateSystemPrompt as a}from"@triggerix-ai/prompt";import{generateToolSchema as c}from"@triggerix-ai/schema";const p="Generate Triggerix interactive output. Call this tool to produce a complete UI bundle: a list of atomic components to render, plus a list of triggers that bind user interactions to backend actions. The output schema constrains event types, action types, and component types to those registered by the developer.",g="Generate Triggerix triggers. Call this tool to produce a list of triggers that bind events to actions under given conditions. The output schema constrains event types and action types to those registered by the developer.";function l(e){const{registry:o,component:t}=e,n=e.toolName??"generate_triggerix_output",r=e.toolDescription??(t?p:g),i=a({registry:o,component:t}),s=c({registry:o,component:t});return{systemPrompt:i,tools:[{type:"function",function:{name:n,description:r,parameters:s}}]}}export{l as defineFunctionCalling};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@triggerix-ai/fn",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "One-call Function Calling definition generator for Triggerix AI",
+  "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/fn"
+  },
+  "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/prompt": "0.0.0",
+    "@triggerix-ai/schema": "0.0.0",
+    "@triggerix-ai/registry": "0.0.0"
+  },
+  "devDependencies": {
+    "unbuild": "^3.6.1"
+  },
+  "scripts": {
+    "stub": "unbuild --stub",
+    "build": "unbuild"
+  }
+}