@fugood/bricks-project 2.23.5 → 2.23.7

package/compile/action-name-map.ts

@@ -716,6 +716,8 @@ export const templateActionNameMap = {
       parallelToolCalls: 'GENERATOR_LLM_PARALLEL_TOOL_CALLS',
       toolChoice: 'GENERATOR_LLM_TOOL_CHOICE',
       enableThinking: 'GENERATOR_LLM_ENABLE_THINKING',
+      thinkingBudgetTokens: 'GENERATOR_LLM_THINKING_BUDGET_TOKENS',
+      thinkingBudgetMessage: 'GENERATOR_LLM_THINKING_BUDGET_MESSAGE',
       prompt: 'GENERATOR_LLM_PROMPT',
       promptMediaPaths: 'GENERATOR_LLM_PROMPT_MEDIA_PATHS',
       promptTemplateData: 'GENERATOR_LLM_PROMPT_TEMPLATE_DATA',
@@ -724,6 +726,7 @@ export const templateActionNameMap = {
       chatTemplateKwargs: 'GENERATOR_LLM_CHAT_TEMPLATE_KWARGS',
       addGenerationPrompt: 'GENERATOR_LLM_ADD_GENERATION_PROMPT',
       now: 'GENERATOR_LLM_NOW',
+      forcePureContent: 'GENERATOR_LLM_FORCE_PURE_CONTENT',
     },
     GENERATOR_LLM_COMPLETION: {
       sessionKey: 'GENERATOR_LLM_SESSION_KEY',
@@ -733,6 +736,8 @@ export const templateActionNameMap = {
       parallelToolCalls: 'GENERATOR_LLM_PARALLEL_TOOL_CALLS',
       toolChoice: 'GENERATOR_LLM_TOOL_CHOICE',
       enableThinking: 'GENERATOR_LLM_ENABLE_THINKING',
+      thinkingBudgetTokens: 'GENERATOR_LLM_THINKING_BUDGET_TOKENS',
+      thinkingBudgetMessage: 'GENERATOR_LLM_THINKING_BUDGET_MESSAGE',
       useReasoningFormat: 'GENERATOR_LLM_USE_REASONING_FORMAT',
       prompt: 'GENERATOR_LLM_PROMPT',
       promptMediaPaths: 'GENERATOR_LLM_PROMPT_MEDIA_PATHS',
@@ -742,6 +747,7 @@ export const templateActionNameMap = {
       chatTemplateKwargs: 'GENERATOR_LLM_CHAT_TEMPLATE_KWARGS',
       addGenerationPrompt: 'GENERATOR_LLM_ADD_GENERATION_PROMPT',
       now: 'GENERATOR_LLM_NOW',
+      forcePureContent: 'GENERATOR_LLM_FORCE_PURE_CONTENT',
       grammar: 'GENERATOR_LLM_GRAMMAR',
       stopWords: 'GENERATOR_LLM_STOP_WORDS',
       predict: 'GENERATOR_LLM_PREDICT',
@@ -812,6 +818,24 @@ export const templateActionNameMap = {
       tools: 'GENERATOR_QNN_LLM_TOOLS',
     },
   },
+  GENERATOR_NEUROPILOT_LLM: {
+    GENERATOR_NEUROPILOT_LLM_LOAD_MODEL: {
+      runnerPath: 'GENERATOR_NEUROPILOT_LLM_RUNNER_PATH',
+      configPath: 'GENERATOR_NEUROPILOT_LLM_CONFIG_PATH',
+      workingDirectory: 'GENERATOR_NEUROPILOT_LLM_WORKING_DIRECTORY',
+      libraryPaths: 'GENERATOR_NEUROPILOT_LLM_LIBRARY_PATHS',
+      daemonHost: 'GENERATOR_NEUROPILOT_LLM_DAEMON_HOST',
+      daemonPort: 'GENERATOR_NEUROPILOT_LLM_DAEMON_PORT',
+      daemonSocketName: 'GENERATOR_NEUROPILOT_LLM_DAEMON_SOCKET_NAME',
+      daemonSocketNamespace: 'GENERATOR_NEUROPILOT_LLM_DAEMON_SOCKET_NAMESPACE',
+    },
+    GENERATOR_NEUROPILOT_LLM_GENERATE: {
+      prompt: 'GENERATOR_NEUROPILOT_LLM_PROMPT',
+      messages: 'GENERATOR_NEUROPILOT_LLM_MESSAGES',
+      maxNewTokens: 'GENERATOR_NEUROPILOT_LLM_MAX_NEW_TOKENS',
+      preformatter: 'GENERATOR_NEUROPILOT_LLM_PREFORMATTER',
+    },
+  },
   GENERATOR_OPENAI_LLM: {
     GENERATOR_OPENAI_LLM_COMPLETION: {
       messages: 'GENERATOR_OPENAI_LLM_MESSAGES',

package/compile/index.ts

@@ -91,6 +91,25 @@ const compileProperty = (property, errorReference: string, result = {}) => {
   return property
 }
 
+const compileScriptCalculationCode = (code = '') => {
+  try {
+    const program = parseAST(code, { sourceType: 'module', ecmaVersion: 2020 })
+    // export function main() { ... }
+    const declarationBody = (
+      (program.body[0] as ExportNamedDeclaration).declaration as FunctionDeclaration
+    )?.body
+    return escodegen.generate(declarationBody, {
+      format: {
+        indent: { style: '  ' },
+        semicolons: false,
+      },
+      comment: true,
+    })
+  } catch {
+    return code || ''
+  }
+}
+
 const compileEventActionValue = (templateKey, eventKey, value, errorReference) => {
   const tmplEventProperties = templateEventPropsMap[templateKey]
   const props = tmplEventProperties?.[eventKey]
@@ -524,6 +543,8 @@ export const compile = async (app: Application) => {
         title: subspace.title,
         description: subspace.description,
         hide_short_ref: subspace.hideShortRef,
+        unused: subspace.unused,
+        portal: subspace.portal,
         _expanded: subspace.unexpanded
           ? {
               brick: !subspace.unexpanded.brick,
@@ -1105,25 +1126,10 @@ export const compile = async (app: Application) => {
             const scriptCalc = dataCalc as DataCalculationScript
             calc.type = 'script'
 
-            let code: string
-            try {
-              const program = parseAST(scriptCalc.code, { sourceType: 'module', ecmaVersion: 2020 })
-              // export function main() { ... }
-              const declarationBody = (
-                (program.body[0] as ExportNamedDeclaration).declaration as FunctionDeclaration
-              )?.body
-              code = escodegen.generate(declarationBody, {
-                format: {
-                  indent: { style: '  ' },
-                  semicolons: false,
-                },
-                comment: true,
-              })
-            } catch {
-              code = scriptCalc.code || ''
-            }
+            const code = compileScriptCalculationCode(scriptCalc.code)
             calc.script_config = {
-              note: scriptCalc.note,
+              title: scriptCalc.title ?? '',
+              note: scriptCalc.note ?? '',
               code,
               enable_async: scriptCalc.enableAsync,
               trigger_mode: scriptCalc.triggerMode,
@@ -1151,7 +1157,7 @@ export const compile = async (app: Application) => {
                     'PROPERTY_BANK_DATA_NODE',
                     `(data calc: ${dataCalcId}, script output, subspace: ${subspaceId})`,
                   )
-                : undefined,
+                : null,
               outputs: scriptCalc.outputs.reduce((acc, output) => {
                 if (!acc[output.key]) acc[output.key] = []
                 const outputId = assertEntryId(
@@ -1168,7 +1174,7 @@ export const compile = async (app: Application) => {
                     'PROPERTY_BANK_DATA_NODE',
                     `(data calc: ${dataCalcId}, script error output, subspace: ${subspaceId})`,
                   )
-                : undefined,
+                : null,
             }
 
             Object.assign(

package/compile/util.ts

@@ -1,6 +1,8 @@
 import { makeId } from '../utils/id'
 
 type ScriptConfig = {
+  title?: string
+  note?: string
   inputs: Record<string, string>
   enable_async: boolean
   trigger_mode?: 'auto' | 'manual'

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.23.5",
+  "version": "2.23.7",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.23.5",
+    "@fugood/bricks-cli": "^2.23.7",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",

package/tools/deploy.ts

@@ -8,6 +8,8 @@ const {
     changelogs: changelogsArg,
     'changelogs-file': changelogsFile,
     'auto-commit': autoCommit,
+    'auto-version': autoVersion,
+    version: versionArg,
     yes,
     help,
   },
@@ -17,6 +19,8 @@ const {
     changelogs: { type: 'string' },
     'changelogs-file': { type: 'string' },
     'auto-commit': { type: 'boolean' },
+    'auto-version': { type: 'boolean' },
+    version: { type: 'string' },
     yes: { type: 'boolean', short: 'y' },
     help: { type: 'boolean', short: 'h' },
   },
@@ -28,6 +32,8 @@ if (help) {
   --changelogs <text>        Changelogs text for the release
   --changelogs-file <path>   Read changelogs from a file
   --auto-commit              Auto-commit unstaged changes before deploying
+  --auto-version             Auto-bump patch version before deploying
+  --version <version>        Set explicit version for the release
   -y, --yes                  Skip all prompts
   -h, --help                 Show this help message`)
   process.exit(0) // eslint-disable-line unicorn/no-process-exit
@@ -46,9 +52,28 @@ if (!isGitRepo && !yes) {
 const app = await Bun.file(`${cwd}/application.json`).json()
 const config = await Bun.file(`${cwd}/.bricks/build/application-config.json`).json()
 
-// Get version from project's package.json
+// Resolve version: explicit flag > auto-bump > package.json
 const pkgFile = Bun.file(`${cwd}/package.json`)
-const version = (await pkgFile.exists()) ? (await pkgFile.json()).version : undefined
+const pkgExists = await pkgFile.exists()
+let version: string | undefined
+
+if (versionArg) {
+  version = versionArg
+  if (pkgExists) {
+    const pkg = await pkgFile.json()
+    pkg.version = version
+    await Bun.write(`${cwd}/package.json`, `${JSON.stringify(pkg, null, 2)}\n`)
+  }
+} else if (autoVersion && pkgExists) {
+  const pkg = await pkgFile.json()
+  const parts = (pkg.version || '0.0.0').split('.')
+  parts[2] = String(Number(parts[2] || 0) + 1)
+  version = parts.join('.')
+  pkg.version = version
+  await Bun.write(`${cwd}/package.json`, `${JSON.stringify(pkg, null, 2)}\n`)
+} else {
+  version = pkgExists ? (await pkgFile.json()).version : undefined
+}
 
 // Get changelog from flag or file
 let changelogs = ''

package/tools/preview.ts

@@ -66,7 +66,7 @@ const useTypecheck = !values['skip-typecheck']
 
 const compile = async () => {
   if (useTypecheck) await $`bun typecheck`
-  await $`bun compile`
+  await $`bun compile.ts`
 }
 
 await compile()

package/types/bricks/Camera.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Camera view with photo capture and barcode scanning capabilities
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -215,7 +218,7 @@ Default property:
   }
 }
 
-/* Camera view brick */
+/* Camera view with photo capture and barcode scanning capabilities */
 export type BrickCamera = Brick &
   BrickCameraDef & {
     templateKey: 'BRICK_CAMERA'

package/types/bricks/Chart.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Chart brick, based on [Apache ECharts](https://echarts.apache.org/en/index.html).
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/GenerativeMedia.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Generative Media brick - Generate images and videos using AI
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Icon.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display vector icons from bundled icon sets (FontAwesome, Material, etc.)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -71,7 +74,7 @@ Default property:
   }
 }
 
-/* Icon brick */
+/* Display vector icons from bundled icon sets (FontAwesome, Material, etc.) */
 export type BrickIcon = Brick &
   BrickIconDef & {
     templateKey: 'BRICK_ICON'

package/types/bricks/Image.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display images from URL or local assets with resize modes and caching
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -87,7 +90,7 @@ Default property:
   }
 }
 
-/* Image brick */
+/* Display images from URL or local assets with resize modes and caching */
 export type BrickImage = Brick &
   BrickImageDef & {
     templateKey: 'BRICK_IMAGE'

package/types/bricks/Items.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Repeating list/grid that renders child bricks for each data item
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -433,7 +436,7 @@ Default property:
   }
 }
 
-/* Brick items component */
+/* Repeating list/grid that renders child bricks for each data item */
 export type BrickItems = Brick &
   BrickItemsDef & {
     templateKey: 'BRICK_ITEMS'

package/types/bricks/Lottie.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Lottie Adobe After Effects animations brick
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Maps.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Interactive map display with markers, regions, and user location tracking
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -231,7 +234,7 @@ Default property:
   }
 }
 
-/* Maps brick */
+/* Interactive map display with markers, regions, and user location tracking */
 export type BrickMaps = Brick &
   BrickMapsDef & {
     templateKey: 'BRICK_MAPS'

package/types/bricks/QrCode.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Generate and display QR codes from text or URL values
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -90,7 +93,7 @@ Default property:
   }
 }
 
-/* QRCode brick */
+/* Generate and display QR codes from text or URL values */
 export type BrickQrcode = Brick &
   BrickQrcodeDef & {
     templateKey: 'BRICK_QRCODE'

package/types/bricks/Rect.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rectangle shape with customizable fill, border, radius, and shadow
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -88,7 +91,7 @@ Default property:
   }
 }
 
-/* Rect brick */
+/* Rectangle shape with customizable fill, border, radius, and shadow */
 export type BrickRect = Brick &
   BrickRectDef & {
     templateKey: 'BRICK_RECT'

package/types/bricks/RichText.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rich text display supporting HTML content rendering
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -101,7 +104,7 @@ Default property:
   }
 }
 
-/* RichText brick */
+/* Rich text display supporting HTML content rendering */
 export type BrickRichText = Brick &
   BrickRichTextDef & {
     templateKey: 'BRICK_RICH_TEXT'

package/types/bricks/Rive.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rive file component
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Slideshow.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Auto-advancing slideshow of child bricks with transition effects
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -168,7 +171,7 @@ Default property:
   }
 }
 
-/* Slideshow brick */
+/* Auto-advancing slideshow of child bricks with transition effects */
 export type BrickSlideshow = Brick &
   BrickSlideshowDef & {
     templateKey: 'BRICK_SLIDESHOW'

package/types/bricks/Svg.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * SVG is an XML-based vector image format for 2D graphics
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Text.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display styled text with font, color, alignment, and truncation controls
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -121,7 +124,7 @@ Default property:
   }
 }
 
-/* Text brick */
+/* Display styled text with font, color, alignment, and truncation controls */
 export type BrickText = Brick &
   BrickTextDef & {
     templateKey: 'BRICK_TEXT'

package/types/bricks/TextInput.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Editable text input field with keyboard type, placeholder, and validation support
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -213,7 +216,7 @@ Default property:
   }
 }
 
-/* Text Input brick */
+/* Editable text input field with keyboard type, placeholder, and validation support */
 export type BrickTextInput = Brick &
   BrickTextInputDef & {
     templateKey: 'BRICK_TEXT_INPUT'

package/types/bricks/Video.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Video playback with play/pause controls and streaming support
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -148,7 +151,7 @@ Default property:
   }
 }
 
-/* Video brick */
+/* Video playback with play/pause controls and streaming support */
 export type BrickVideo = Brick &
   BrickVideoDef & {
     templateKey: 'BRICK_VIDEO'

package/types/bricks/VideoStreaming.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Brick video streaming component, supports RTSP / RTMP streaming.
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/WebRtcStream.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display WebRTC video/audio stream from a WebRTC generator connection
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -38,7 +41,7 @@ Default property:
   }
 }
 
-/* WebRTCStream brick */
+/* Display WebRTC video/audio stream from a WebRTC generator connection */
 export type BrickWebRTCStream = Brick &
   BrickWebRTCStreamDef & {
     templateKey: 'BRICK_WEBRTC_STREAM'

package/types/bricks/WebView.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * WebView brick
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/generators/AlarmClock.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Schedule events using cron expressions (e.g. daily, hourly)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -81,7 +84,7 @@ Default property:
   }
 }
 
-/* Execute event by cron tab */
+/* Schedule events using cron expressions (e.g. daily, hourly) */
 export type GeneratorAlarmClock = Generator &
   GeneratorAlarmClockDef & {
     templateKey: 'GENERATOR_ALARM_CLOCK'

package/types/generators/Assistant.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * AI assistant orchestrator combining LLM, STT, TTS, and tool-use into a conversational agent
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -434,7 +437,7 @@ Default property:
       | DataLink
     /* Whether to cache messages */
     cacheMessages?: boolean | DataLink
-    /* LLM Generator (Supports `LLM (GGML)`, `LLM (MLX)`, and `OpenAI LLM` generators) */
+    /* LLM Generator (Supports `LLM (GGML)`, `LLM (MLX)`, `OpenAI LLM`, `LLM (Qualcomm AI Engine)`, `LLM (ONNX)`, `LLM (Anthropic-compat)`, and `LLM (MediaTek NeuroPilot)` generators) */
     llmGeneratorId?: string | DataLink | (() => Generator)
     /* LLM Live Policy. If the policy is `only-in-use`, the LLM context will be released when the assistant is not in use.  
 
@@ -585,7 +588,7 @@ Default property:
   }
 }
 
-/* AI Assistant */
+/* AI assistant orchestrator combining LLM, STT, TTS, and tool-use into a conversational agent */
 export type GeneratorAssistant = Generator &
   GeneratorAssistantDef & {
     templateKey: 'GENERATOR_ASSISTANT'

package/types/generators/BleCentral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -212,7 +215,7 @@ Default property:
   }
 }
 
-/* BLE Central Mode Generator */
+/* Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals */
 export type GeneratorBleCentral = Generator &
   GeneratorBleCentralDef & {
     templateKey: 'GENERATOR_BLE_CENTRAL'

package/types/generators/BlePeripheral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy peripheral: advertise services and respond to central connections
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -181,7 +184,7 @@ Default property:
   }
 }
 
-/* BLE Peripheral Mode Generator */
+/* Bluetooth Low Energy peripheral: advertise services and respond to central connections */
 export type GeneratorBlePeripheral = Generator &
   GeneratorBlePeripheralDef & {
     templateKey: 'GENERATOR_BLE_PERIPHERAL'

package/types/generators/CanvasMap.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Trigger canvas navigation by setup rules
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {