@fugood/bricks-project 2.23.4 → 2.23.5-1

package/types/generators/File.ts

@@ -289,31 +289,80 @@ Default property:
   }
   outlets?: {
     /* File init error result will be stored in Data */
-    initError?: () => Data
+    initError?: () => Data<string>
     /* File read stats result will be stored in Data */
-    readStats?: () => Data
+    readStats?: () => Data<{
+      path?: string
+      size?: number
+      isDirectory?: boolean
+      mtime?: string
+      ctime?: string
+      mode?: number
+      originalFilepath?: string
+      [key: string]: any
+    }>
     /* File read content result will be stored in Data */
-    readContent?: () => Data
+    readContent?: () => Data<any>
     /* File read details result will be stored in Data */
-    readDetails?: () => Data
+    readDetails?: () => Data<{
+      path?: string
+      content?: any
+      size?: number
+      exists?: boolean
+      [key: string]: any
+    }>
     /* File read error result will be stored in Data */
-    readError?: () => Data
+    readError?: () => Data<string>
     /* File append content result will be stored in Data */
-    appendDetails?: () => Data
+    appendDetails?: () => Data<{
+      path?: string
+      appended?: boolean
+      contentLength?: number
+      [key: string]: any
+    }>
     /* File append error result will be stored in Data */
-    appendError?: () => Data
+    appendError?: () => Data<string>
     /* File write details result will be stored in Data */
-    writeDetails?: () => Data
+    writeDetails?: () => Data<{
+      path?: string
+      written?: boolean
+      contentLength?: number
+      [key: string]: any
+    }>
     /* File write error result will be stored in Data */
-    writeError?: () => Data
+    writeError?: () => Data<string>
     /* File upload progress result will be stored in Data */
-    uploadProgress?: () => Data
+    uploadProgress?: () => Data<{
+      id?: string
+      path?: string
+      uri?: string
+      hash?: string
+      hashType?: string
+      headers?: { [key: string]: any }
+      fields?: { [key: string]: any }
+      method?: string
+      progress?: number
+      isLastUpdated?: boolean
+      [key: string]: any
+    }>
     /* File upload complete result will be stored in Data */
-    uploadResult?: () => Data
+    uploadResult?: () => Data<any>
     /* File download progress result will be stored in Data */
-    downloadProgress?: () => Data
+    downloadProgress?: () => Data<{
+      id?: string
+      path?: string
+      uri?: string
+      hash?: string
+      hashType?: string
+      headers?: { [key: string]: any }
+      fields?: { [key: string]: any }
+      method?: string
+      progress?: number
+      isLastUpdated?: boolean
+      [key: string]: any
+    }>
     /* File download complete result will be stored in Data */
-    downloadResult?: () => Data
+    downloadResult?: () => Data<any>
   }
 }
 

package/types/generators/GraphQl.ts

@@ -97,9 +97,9 @@ Default property:
   }
   outlets?: {
     /* Response for GraphQL request, it will save to Data */
-    response?: () => Data
+    response?: () => Data<{ [key: string]: any }>
     /* Server response error of GraphQL request,    it will save to Data */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 

package/types/generators/Http.ts

@@ -156,17 +156,36 @@ Default property:
   events?: {}
   outlets?: {
     /* Response for HTTP request */
-    response?: () => Data
+    response?: () => Data<string | { [key: string]: any }>
     /* Response details for HTTP request */
-    responseDetails?: () => Data
+    responseDetails?: () => Data<{
+      ok?: boolean
+      redirected?: boolean
+      type?: string
+      status?: number
+      statusText?: string
+      headers?: { [key: string]: any }
+      body?: any
+      event?: string
+      id?: string
+      data?: any
+      [key: string]: any
+    }>
     /* All received data from event stream */
-    eventLog?: () => Data
+    eventLog?: () => Data<Array<any>>
     /* All received event details from event stream */
-    eventLogDetails?: () => Data
+    eventLogDetails?: () => Data<
+      Array<{
+        event?: string
+        id?: string
+        data?: any
+        [key: string]: any
+      }>
+    >
     /* EventSource state */
-    sseState?: () => Data
+    sseState?: () => Data<string>
     /* Server response error of HTTP request */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 

package/types/generators/HttpServer.ts

@@ -135,13 +135,13 @@ Default property:
   }
   outlets?: {
     /* Server is listening */
-    isListening?: () => Data
+    isListening?: () => Data<boolean>
     /* Query of request */
-    requestQuery?: () => Data
+    requestQuery?: () => Data<{ [key: string]: any }>
     /* Body of request */
-    requestBody?: () => Data
+    requestBody?: () => Data<any>
     /* Remote address of request */
-    clientAddress?: () => Data
+    clientAddress?: () => Data<string>
   }
 }
 

package/types/generators/Information.ts

@@ -72,7 +72,7 @@ Default property:
   }
   outlets?: {
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 

package/types/generators/Intent.ts

@@ -131,7 +131,13 @@ Default property:
   }
   outlets?: {
     /* Last intent result */
-    result?: () => Data
+    result?: () => Data<{
+      action?: string
+      data?: string
+      type?: string
+      extras?: { [key: string]: any }
+      [key: string]: any
+    }>
   }
 }
 

package/types/generators/Iterator.ts

@@ -69,15 +69,15 @@ Default property:
   }
   outlets?: {
     /* Elements that have been iterated (including current one) */
-    iteratedArray?: () => Data
+    iteratedArray?: () => Data<Array<any>>
     /* Elements that will be iterated but have not been iterated yet */
-    upcomingArray?: () => Data
+    upcomingArray?: () => Data<Array<any>>
     /* Current iteration element */
-    value?: () => Data
+    value?: () => Data<any>
     /* Key of the current iteration element (for number: same as value, for array/string: index, for object: string key) */
-    key?: () => Data
+    key?: () => Data<any>
     /* Current iteration count (if data is 6 and step is 2, this will return: 1,2,3 in sequence) */
-    index?: () => Data
+    index?: () => Data<number>
   }
 }
 

package/types/generators/Keyboard.ts

@@ -51,15 +51,25 @@ Default property:
   }
   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
+      }>
+    >
   }
 }
 

package/types/generators/LlmAnthropicCompat.ts

@@ -153,11 +153,17 @@ Default property:
   }
   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
+    }>
   }
 }
 

package/types/generators/LlmAppleBuiltin.ts

@@ -100,13 +100,13 @@ Default property:
   }
   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>
   }
 }
 

package/types/generators/LlmGgml.ts

@@ -678,31 +678,81 @@ Default property:
   }
   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
+    }>
   }
 }
 

package/types/generators/LlmMlx.ts

@@ -0,0 +1,210 @@
+/* Auto generated by build script */
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
+import type { Data, DataLink } from '../data'
+import type {
+  Brick,
+  Generator,
+  EventAction,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from '../common'
+
+/* Load model */
+export type GeneratorMlxLLMActionLoadModel = ActionWithParams & {
+  __actionName: 'GENERATOR_MLX_LLM_LOAD_MODEL'
+  params?: Array<
+    | {
+        input: 'modelId'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'vlm'
+        value?: boolean | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+/* Run text completion */
+export type GeneratorMlxLLMActionCompletion = ActionWithParams & {
+  __actionName: 'GENERATOR_MLX_LLM_COMPLETION'
+  params?: Array<
+    | {
+        input: 'messages'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'tools'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'maxTokens'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'temperature'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'topP'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'repetitionPenalty'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+/* Stop text completion */
+export type GeneratorMlxLLMActionStopCompletion = Action & {
+  __actionName: 'GENERATOR_MLX_LLM_STOP_COMPLETION'
+}
+
+/* Release model context */
+export type GeneratorMlxLLMActionReleaseContext = Action & {
+  __actionName: 'GENERATOR_MLX_LLM_RELEASE_CONTEXT'
+}
+
+interface GeneratorMlxLLMDef {
+  /*
+Default property:
+{
+  "init": false,
+  "modelId": "mlx-community/Qwen3-4B-4bit",
+  "vlm": false,
+  "completionMessages": [
+    {
+      "role": "system",
+      "content": "You are a helpful assistant."
+    },
+    {
+      "role": "user",
+      "content": "Hello"
+    }
+  ],
+  "completionMaxTokens": 1024,
+  "completionTemperature": 0.6,
+  "completionTopP": 1,
+  "completionRepetitionContextSize": 20
+}
+  */
+  property?: {
+    /* Initialize model on generator init */
+    init?: boolean | DataLink
+    /* HuggingFace model ID or local path to model directory  
+ e.g. "mlx-community/Qwen3-4B-4bit" */
+    modelId?: string | DataLink
+    /* Enable Vision Language Model (VLM) mode */
+    vlm?: boolean | DataLink
+    /* Chat messages (if first message has role 'system', it will be used as system prompt) */
+    completionMessages?:
+      | Array<
+          | DataLink
+          | {
+              role?: string | DataLink
+              content?: string | DataLink
+            }
+        >
+      | DataLink
+    /* Maximum tokens to generate */
+    completionMaxTokens?: number | DataLink
+    /* Temperature (0.0 to 2.0) */
+    completionTemperature?: number | DataLink
+    /* Top P sampling */
+    completionTopP?: number | DataLink
+    /* Repetition penalty factor */
+    completionRepetitionPenalty?: number | DataLink
+    /* Number of tokens to consider for repetition penalty */
+    completionRepetitionContextSize?: number | DataLink
+    /* Maximum KV cache size (context window). Uses rotating cache to limit memory.  
+ Smaller values (e.g. 512) use less memory but lower quality.  
+ Larger values (e.g. 4096) use more memory but better quality.  
+ Leave empty for unlimited (model default). */
+    contextSize?: number | DataLink
+    /* Enable thinking mode (model-dependent, e.g. Qwen3).  
+ When enabled, passes enable_thinking=true to the chat template.  
+ The model may output reasoning in &lt;think&gt; tags which will be extracted as reasoning_content. */
+    completionEnableThinking?: boolean | DataLink
+    /* Additional keyword arguments for chat template (object) */
+    completionChatTemplateKwargs?: {} | DataLink
+    /* 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
+    /* Buttress connection settings for remote inference */
+    buttressConnectionSettings?:
+      | DataLink
+      | {
+          enabled?: boolean | DataLink
+          url?: string | DataLink
+          fallbackType?: 'use-local' | 'no-op' | DataLink
+          strategy?: 'prefer-local' | 'prefer-buttress' | 'prefer-best' | DataLink
+        }
+  }
+  events?: {
+    /* Event triggered when context state changes */
+    onContextStateChange?: Array<EventAction>
+    /* Error event */
+    onError?: Array<EventAction>
+    /* Completion streaming event (emitted for each token) */
+    onCompletion?: Array<EventAction>
+    /* Completion finished event */
+    onCompletionFinished?: Array<EventAction>
+  }
+  outlets?: {
+    /* Context state */
+    contextState?: () => Data<string>
+    /* Model load progress (0-1) */
+    loadProgress?: () => Data<number>
+    /* Whether the model is evaluating */
+    isEvaluating?: () => Data<boolean>
+    /* Completion result */
+    completionResult?: () => Data<string>
+    /* Last token */
+    completionLastToken?: () => Data<string>
+  }
+}
+
+/* On-device LLM inference using Apple MLX framework on iOS/tvOS  
+
+ ## Features  
+ - Powered by MLX (Apple's ML framework optimized for Apple Silicon)  
+ - Download models directly from HuggingFace Hub  
+ - Streaming token generation  
+ - Supports LLM and VLM (Vision Language Models)  
+ - Requires iOS 17+ or tvOS 17+ */
+export type GeneratorMlxLLM = Generator &
+  GeneratorMlxLLMDef & {
+    templateKey: 'GENERATOR_MLX_LLM'
+    switches?: Array<
+      SwitchDef &
+        GeneratorMlxLLMDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet:
+                    | 'contextState'
+                    | 'loadProgress'
+                    | 'isEvaluating'
+                    | 'completionResult'
+                    | 'completionLastToken'
+                  value: any
+                }
+          }>
+        }
+    >
+  }

package/types/generators/LlmOnnx.ts

@@ -159,13 +159,22 @@ Default property:
   }
   outlets?: {
     /* Context state */
-    contextState?: () => Data
+    contextState?: () => Data<string>
     /* Generated output */
-    generated?: () => Data
+    generated?: () => Data<string>
     /* Full result of generation */
-    fullResult?: () => Data
+    fullResult?: () => Data<string>
     /* Last function call */
-    lastFunctionCall?: () => Data
+    lastFunctionCall?: () => Data<{
+      id?: string
+      type?: string
+      function?: {
+        name?: string
+        arguments?: string
+        [key: string]: any
+      }
+      [key: string]: any
+    }>
   }
 }
 

package/types/generators/LlmOpenAiCompat.ts

@@ -167,11 +167,27 @@ Default property:
   }
   outlets?: {
     /* Evaluating outlet */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Completion result outlet */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Completion details outlet */
-    completionDetails?: () => Data
+    completionDetails?: () => Data<{
+      text?: string
+      content?: string
+      finish_reason?: string
+      usage?: { [key: string]: any }
+      tool_calls?: Array<{
+        id?: string
+        type?: string
+        function?: {
+          name?: string
+          arguments?: string
+          [key: string]: any
+        }
+        [key: string]: any
+      }>
+      [key: string]: any
+    }>
   }
 }