@fugood/bricks-project 2.24.0-beta.9 → 2.24.0

package/types/generators/Keyboard.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Listen to keyboard and remote control key events (keyDown, keyUp)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 interface GeneratorKeyboardDef {
   /*
@@ -27,13 +31,13 @@ Default property:
   property?: {
     /* Enable listening for input */
     enabled?: boolean | DataLink
-    /* Key map to transform key or key code to the designated content  
+    /* Key map to transform key or key code to the designated content
  Example: { 37: 'left', 38: 'up', 39: 'right', 40: 'down', 'Enter': 'confirm' }  
  Supports both key codes (numbers) and key names (strings) as keys */
     keyMap?: {} | DataLink
     /* Key outlet preference use key code or key. */
     keyOutletPrefer?: 'auto' | 'key-code' | 'key' | DataLink
-    /* Key or code to finish batch input  
+    /* Key or code to finish batch input
  Common values: 13 (Enter), 27 (Escape), 'Enter', 'Escape' */
     batchStopKeys?: Array<string | DataLink | number | DataLink | DataLink> | DataLink
     /* Debounce time (ms) to finish batch input */
@@ -43,27 +47,37 @@ Default property:
   }
   events?: {
     /* Event on key press */
-    onDown?: Array<EventAction>
+    onDown?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onDown']>>
     /* Event on key up */
-    onUp?: Array<EventAction>
+    onUp?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onUp']>>
     /* Event on batch input complete */
-    onBatch?: Array<EventAction>
+    onBatch?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onBatch']>>
   }
   outlets?: {
     /* Last key code pressed */
-    lastKeyDown?: () => Data
+    lastKeyDown?: () => Data<string | number>
     /* Modifier key information on last key press */
-    lastKeyDownFlags?: () => Data
+    lastKeyDownFlags?: () => Data<{ [key: string]: any }>
     /* Last key code released */
-    lastKeyUp?: () => Data
+    lastKeyUp?: () => Data<string | number>
     /* Modifier key information on last key release */
-    lastKeyUpFlags?: () => Data
+    lastKeyUpFlags?: () => Data<{ [key: string]: any }>
     /* Last batch event */
-    lastBatchEvents?: () => Data
+    lastBatchEvents?: () => Data<
+      Array<{
+        event?: string
+        key?: any
+        keyNoMapping?: any
+        keyCode?: any
+        keyCodeNoMapping?: any
+        flags?: { [key: string]: any }
+        [key: string]: any
+      }>
+    >
   }
 }
 
-/* Access keyboard (remote control) events */
+/* Listen to keyboard and remote control key events (keyDown, keyUp) */
 export type GeneratorKeyboard = Generator &
   GeneratorKeyboardDef & {
     templateKey: 'GENERATOR_KEYBOARD'

package/types/generators/LlmAnthropicCompat.ts

@@ -1,4 +1,13 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * LLM inference using Anthropic-compatible API endpoints
+ *
+ *  ## Features
+ *  - Compatible with Anthropic API format
+ *  - Supports function calling (tools)
+ *  - Streaming responses
+ *  - Custom API endpoints (Default to https://api.anthropic.com/v1/messages)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +19,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Run text completion */
 export type GeneratorAnthropicLLMActionCompletion = ActionWithParams & {
@@ -119,7 +129,7 @@ Default property:
             }
         >
       | DataLink
-    /* Tools for function calling following Anthropic format  
+    /* Tools for function calling following Anthropic format
  Format: Array of objects with {name, description, input_schema} structure  
  See: https://docs.anthropic.com/en/docs/tool-use */
     completionTools?: Array<{} | DataLink> | DataLink
@@ -143,25 +153,37 @@ Default property:
   }
   events?: {
     /* Error event */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onError']>>
     /* Completion event */
-    onCompletion?: Array<EventAction>
+    onCompletion?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onCompletion']>
+    >
     /* Completion finished event */
-    onCompletionFinished?: Array<EventAction>
+    onCompletionFinished?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onCompletionFinished']>
+    >
     /* Tool use event */
-    onToolUse?: Array<EventAction>
+    onToolUse?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onToolUse']>
+    >
   }
   outlets?: {
     /* Evaluating outlet */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Completion result outlet */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Completion details outlet */
-    completionDetails?: () => Data
+    completionDetails?: () => Data<{
+      model?: string
+      stop_reason?: string
+      usage?: { [key: string]: any }
+      content?: Array<any>
+      [key: string]: any
+    }>
   }
 }
 
-/* LLM inference using Anthropic-compatible API endpoints  
+/* LLM inference using Anthropic-compatible API endpoints
 
  ## Features  
  - Compatible with Anthropic API format  

package/types/generators/LlmAppleBuiltin.ts

@@ -1,4 +1,14 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * LLM inference using Apple Intelligence on iOS/tvOS 26+
+ *
+ *  ## Features
+ *  - Native Apple Intelligence integration
+ *  - No model download required
+ *  - Privacy-focused on-device processing
+ *  - Optimized for Apple Silicon
+ *  - Requires iOS 26+ or tvOS 26+
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +20,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Load model */
 export type GeneratorAppleLLMActionLoadModel = Action & {
@@ -90,27 +101,31 @@ Default property:
   }
   events?: {
     /* Error event */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onError']>>
     /* Model loaded event */
     onModelLoaded?: Array<EventAction>
     /* Completion event */
-    onCompletion?: Array<EventAction>
+    onCompletion?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onCompletion']>
+    >
     /* Completion finished event */
-    onCompletionFinished?: Array<EventAction>
+    onCompletionFinished?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onCompletionFinished']>
+    >
   }
   outlets?: {
     /* Context state outlet */
-    contextState?: () => Data
+    contextState?: () => Data<string>
     /* Evaluating outlet */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Completion result outlet */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Last token outlet */
-    completionLastToken?: () => Data
+    completionLastToken?: () => Data<string>
   }
 }
 
-/* LLM inference using Apple Intelligence on iOS/tvOS 26+  
+/* LLM inference using Apple Intelligence on iOS/tvOS 26+
 
  ## Features  
  - Native Apple Intelligence integration  

package/types/generators/LlmGgml.ts

@@ -1,4 +1,17 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Local Large Language Model (LLM) inference based on GGML and [llama.cpp](https://github.com/ggerganov/llama.cpp)
+ *
+ *  ## Notice
+ *  - The device RAM must be larger than 8GB
+ *  - iOS: Recommended use M1+ / A17+ chip device. Supported GPU acceleration by Metal.
+ *  - macOS: Recommended use M1+ chip device. Supported GPU acceleration by Metal.
+ *  - Android: Recommended use Android 13+ system.
+ *    - Supported GPU acceleration by OpenCL, currently only for Qualcomm Adreno 700+ GPUs, other GPUs are not supported.
+ *    - Supported Hexagon NPU for Qualcomm Snapdragon 8 Gen 1+ GPUs.
+ *  - Linux / Windows  [@nextline    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
+ *    - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +23,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Load the model */
 export type GeneratorLLMActionLoadModel = Action & {
@@ -97,6 +111,16 @@ export type GeneratorLLMActionProcessPrompt = ActionWithParams & {
         value?: boolean | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'thinkingBudgetTokens'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'thinkingBudgetMessage'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
     | {
         input: 'prompt'
         value?: string | DataLink | EventProperty
@@ -137,6 +161,11 @@ export type GeneratorLLMActionProcessPrompt = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'forcePureContent'
+        value?: boolean | DataLink | EventProperty
+        mapping?: string
+      }
   >
 }
 
@@ -179,6 +208,16 @@ export type GeneratorLLMActionCompletion = ActionWithParams & {
         value?: boolean | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'thinkingBudgetTokens'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'thinkingBudgetMessage'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
     | {
         input: 'useReasoningFormat'
         value?: string | DataLink | EventProperty
@@ -224,6 +263,11 @@ export type GeneratorLLMActionCompletion = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'forcePureContent'
+        value?: boolean | DataLink | EventProperty
+        mapping?: string
+      }
     | {
         input: 'grammar'
         value?: string | DataLink | EventProperty
@@ -432,6 +476,7 @@ Default property:
   "completionEnableThinking": true,
   "completionAddGenerationPrompt": true,
   "completionChatTemplateKwargs": {},
+  "completionForcePureContent": false,
   "completionUseReasoningFormat": "auto",
   "completionStopWords": [],
   "completionPredict": 400,
@@ -459,10 +504,10 @@ Default property:
 }
   */
   property?: {
-    /* Initialize the Llama context on generator initialization  
+    /* Initialize the Llama context on generator initialization
  Please note that it will take some RAM depending on the model size */
     init?: boolean | DataLink
-    /* The URL or path of model  
+    /* The URL or path of model
  We used GGUF format model, please refer to https://github.com/ggerganov/llama.cpp/tree/master#description */
     modelUrl?: string | DataLink
     /* Hash type of model */
@@ -477,10 +522,10 @@ Default property:
     mmprojHashType?: 'md5' | 'sha256' | 'sha1' | DataLink
     /* Hash of mmproj file (PREVIEW FEATURE) */
     mmprojHash?: string | DataLink
-    /* Minimum tokens for image encoding in multimodal (PREVIEW FEATURE)  
+    /* Minimum tokens for image encoding in multimodal (PREVIEW FEATURE)
  Useful for dynamic resolution models (e.g. Qwen-VL). Default: -1 (auto) */
     imageMinTokens?: number | DataLink
-    /* Maximum tokens for image encoding in multimodal (PREVIEW FEATURE)  
+    /* Maximum tokens for image encoding in multimodal (PREVIEW FEATURE)
  Limit tokens for dynamic resolution models to balance speed vs. detail. Default: -1 (auto) */
     imageMaxTokens?: number | DataLink
     /* Chat Template (Jinja format) to override the default template from model */
@@ -493,13 +538,13 @@ Default property:
     uBatchSize?: number | DataLink
     /* Number of threads */
     maxThreads?: number | DataLink
-    /* Accelerator variant (Only for desktop)  
+    /* Accelerator variant (Only for desktop)
  `default` - CPU / Metal (macOS)  
  `vulkan` - Use Vulkan  
  `cuda` - Use CUDA  
  `snapdragon` - Use OpenCL/Hexagon of Qualcomm Snapdragon */
     accelVariant?: 'default' | 'vulkan' | 'cuda' | 'snapdragon' | DataLink
-    /* Devices. For example:  
+    /* Devices. For example:
   
  Metal or CPU for iOS/tvOS/MacOS  
  OpenCL or CPU for Android  
@@ -514,6 +559,8 @@ Default property:
     useMlock?: boolean | DataLink
     /* Use mmap */
     useMmap?: boolean | DataLink
+    /* Disable extra buffer types for weight repacking. Reduces memory usage at the cost of slower prompt processing. */
+    noExtraBuffs?: boolean | DataLink
     /* Use Flash Attention for inference (Recommended with GPU enabled) */
     useFlashAttn?: 'auto' | 'on' | 'off' | DataLink
     /* KV cache data type for the K (Default: f16) */
@@ -534,7 +581,7 @@ Default property:
     transformScriptCode?: string | DataLink
     /* Variables used in Transform Script (object) */
     transformScriptVariables?: {} | DataLink
-    /* Session save mode  
+    /* Session save mode
  `none` - No session saving  
  `prompt` - Save session when prompt processed  
  `completion` - Save session when completion finished  
@@ -546,7 +593,7 @@ Default property:
     sessionRemain?: number | DataLink
     /* TODO:loran_gqarms_norm_epsrope_freq_baserope_freq_scale */
     completionMode?: 'auto' | 'chat' | 'text' | DataLink
-    /* Tools for chat mode using OpenAI-compatible function calling format  
+    /* Tools for chat mode using OpenAI-compatible function calling format
  Format: Array of objects with {type, function: {name, description, parameters}} structure  
  See: https://platform.openai.com/docs/guides/function-calling */
     completionTools?: Array<{} | DataLink> | DataLink
@@ -566,7 +613,7 @@ Default property:
       | DataLink
     /* Prompt (text mode) */
     completionPrompt?: string | DataLink
-    /* Media paths to be used in the prompt template (PREVIEW FEATURE)  
+    /* Media paths to be used in the prompt template (PREVIEW FEATURE)
  In prompt, use `<__media__>` for position of media content */
     completionPromptMediaPaths?: Array<string | DataLink> | DataLink
     /* Data to be used in the prompt template (e.g. `Hello ${name}`). Supports nested data, such as `Hello ${user.name}`. */
@@ -588,13 +635,19 @@ Default property:
         }
     /* Enable thinking */
     completionEnableThinking?: boolean | DataLink
+    /* Maximum tokens allowed inside the model's thinking block before forcing it closed. Only applies when chat formatting exposes thinking tags. */
+    completionThinkingBudgetTokens?: number | DataLink
+    /* Message injected before the thinking end tag when the thinking budget is exhausted. */
+    completionThinkingBudgetMessage?: string | DataLink
     /* Add generation prompt */
     completionAddGenerationPrompt?: boolean | DataLink
     /* Now (for fill current date in chat template if supported) */
     completionNow?: string | DataLink
     /* Additional keyword arguments for chat template (object) */
     completionChatTemplateKwargs?: {} | DataLink
-    /* Use reasoning format for enhanced response structure  
+    /* Force pure content (accept any model that has a chat_template without requiring template validation) */
+    completionForcePureContent?: boolean | DataLink
+    /* Use reasoning format for enhanced response structure
  `auto` - Auto-determine the reasoning format of the model  
  `none` - Disable reasoning format */
     completionUseReasoningFormat?: 'auto' | 'none' | DataLink
@@ -666,47 +719,103 @@ Default property:
   }
   events?: {
     /* Event triggered when context state changes */
-    onContextStateChange?: Array<EventAction>
+    onContextStateChange?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Llm']['onContextStateChange']>
+    >
     /* Event triggered when error occurs */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['Llm']['onError']>>
     /* Event triggered when completion */
-    onCompletion?: Array<EventAction>
+    onCompletion?: Array<EventAction<string & keyof TemplateEventPropsMap['Llm']['onCompletion']>>
     /* Event triggered when completion finished */
-    onCompletionFinished?: Array<EventAction>
+    onCompletionFinished?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Llm']['onCompletionFinished']>
+    >
     /* Event triggered on get function call request */
-    onCompletionFunctionCall?: Array<EventAction>
+    onCompletionFunctionCall?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Llm']['onCompletionFunctionCall']>
+    >
   }
   outlets?: {
     /* Context state */
-    contextState?: () => Data
+    contextState?: () => Data<string>
     /* Context load progress (0-100) */
-    contextLoadProgress?: () => Data
+    contextLoadProgress?: () => Data<number>
     /* Context details */
-    contextDetails?: () => Data
+    contextDetails?: () => Data<{
+      state?: string
+      contextId?: string
+      gpu?: string
+      reasonNoGPU?: string
+      model?: { [key: string]: any }
+      isMultimodalEnabled?: boolean
+      [key: string]: any
+    }>
     /* Session details */
-    sessions?: () => Data
+    sessions?: () => Data<{
+      last_session_id?: string
+      sessions?: Array<{
+        id?: string
+        type?: string
+        prompt?: string
+        sessionKey?: string
+        model_instance_id?: string
+        tokens_evaluated?: number
+        t?: number
+        [key: string]: any
+      }>
+      last_custom_session_id?: string
+      custom_sessions?: Array<{
+        id?: string
+        type?: string
+        prompt?: string
+        sessionKey?: string
+        model_instance_id?: string
+        tokens_evaluated?: number
+        t?: number
+        [key: string]: any
+      }>
+      [key: string]: any
+    }>
     /* Is evaluating */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Tokenize result */
-    tokenizeResult?: () => Data
+    tokenizeResult?: () => Data<Array<number>>
     /* Detokenize result */
-    detokenizeResult?: () => Data
+    detokenizeResult?: () => Data<string>
     /* Last formatted prompt (messages or prompt) */
-    completionLastFormattedPrompt?: () => Data
+    completionLastFormattedPrompt?: () => Data<string>
     /* Last completion token */
-    completionLastToken?: () => Data
+    completionLastToken?: () => Data<string>
     /* Completion result */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Reasoning content from model responses */
-    completionReasoningContent?: () => Data
+    completionReasoningContent?: () => Data<string>
     /* Full context (Prompt + Completion) */
-    completionFullContext?: () => Data
+    completionFullContext?: () => Data<string>
     /* Inference result details */
-    completionResultDetails?: () => Data
+    completionResultDetails?: () => Data<{
+      prompt?: string
+      full_context?: string
+      text?: string
+      content?: string
+      reasoning_content?: string
+      token?: string
+      tool_calls?: Array<{
+        id?: string
+        type?: string
+        function?: {
+          name?: string
+          arguments?: string
+          [key: string]: any
+        }
+        [key: string]: any
+      }>
+      [key: string]: any
+    }>
   }
 }
 
-/* Local Large Language Model (LLM) inference based on GGML and [llama.cpp](https://github.com/ggerganov/llama.cpp)  
+/* Local Large Language Model (LLM) inference based on GGML and [llama.cpp](https://github.com/ggerganov/llama.cpp)
 
  ## Notice  
  - The device RAM must be larger than 8GB