@fugood/bricks-project 2.24.0-beta.2 → 2.24.0-beta.21

package/types/generators/AlarmClock.ts

@@ -71,13 +71,13 @@ Default property:
   }
   outlets?: {
     /* Current time of each alarm clock trig */
-    trigTime?: () => Data
+    trigTime?: () => Data<string>
     /* Current timestamp (unix time) of each alarm clock trig */
-    trigTimestamp?: () => Data
+    trigTimestamp?: () => Data<string | number>
     /* Count of alarm clock trigs */
-    trigCount?: () => Data
+    trigCount?: () => Data<string | number>
     /* Is alarm clock running? */
-    running?: () => Data
+    running?: () => Data<boolean | string | number>
   }
 }
 
@@ -85,7 +85,7 @@ Default property:
 export type GeneratorAlarmClock = Generator &
   GeneratorAlarmClockDef & {
     templateKey: 'GENERATOR_ALARM_CLOCK'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAlarmClockDef & {
           conds?: Array<{

package/types/generators/Assistant.ts

@@ -364,7 +364,7 @@ export type GeneratorAssistantActionInsertMcpResource = ActionWithParams & {
   >
 }
 
-/* Summarize messages based on the conversation  
+/* Summarize messages based on the conversation
 
  Note: Summary uses the same LLM context size, so it is recommended only to use it when the system prompt (in Initial Messages) is long,  otherwise it may still fail when the context is full (Ctx Shift is NO). */
 export type GeneratorAssistantActionSummaryMessages = ActionWithParams & {
@@ -434,15 +434,15 @@ Default property:
       | DataLink
     /* Whether to cache messages */
     cacheMessages?: boolean | DataLink
-    /* LLM Generator (Supports `LLM (GGML)` and `OpenAI LLM` generators) */
+    /* LLM Generator (Supports `LLM (GGML)`, `LLM (MLX)`, and `OpenAI LLM` 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.  
+    /* LLM Live Policy. If the policy is `only-in-use`, the LLM context will be released when the assistant is not in use.
 
  Note: LLM (Qualcomm AI Engine) recommend use `manual` and loaded constantly. */
     llmLivePolicy?: 'only-in-use' | 'manual' | DataLink
     /* LLM main session key */
     llmSessionKey?: string | DataLink
-    /* Auto Summary Messages (Automatically summarize messages when the LLM context is full or content gets truncated, currently only supported with LLM (GGML) generators)  
+    /* Auto Summary Messages (Automatically summarize messages when the LLM context is full or content gets truncated, currently only supported with LLM (GGML) generators)
 
  Note: Summary uses the same LLM context size, so it is recommended only to use it when the system prompt (in Initial Messages) is long,  otherwise it may still fail when the context is full (Ctx Shift is NO). */
     llmAutoSummaryMessages?: boolean | DataLink
@@ -524,19 +524,64 @@ Default property:
   }
   outlets?: {
     /* Whether the assistant is heating up */
-    isHeatingUp?: () => Data
+    isHeatingUp?: () => Data<boolean>
     /* Whether the assistant is file processing */
-    isFileProcessing?: () => Data
+    isFileProcessing?: () => Data<boolean>
     /* Whether the assistant is responding */
-    isResponding?: () => Data
+    isResponding?: () => Data<boolean>
     /* Whether the assistant is busy */
-    isBusy?: () => Data
+    isBusy?: () => Data<boolean>
     /* Embedding files of the assistant */
-    files?: () => Data
+    files?: () => Data<Array<any>>
     /* Messages of the assistant */
-    messages?: () => Data
+    messages?: () => Data<
+      Array<{
+        role?: string
+        name?: string
+        content?: any
+        tool_call_id?: string
+        tool_calls?: Array<{
+          id?: string
+          type?: string
+          function?: {
+            name?: string
+            arguments?: string
+            [key: string]: any
+          }
+          [key: string]: any
+        }>
+        reasoning_content?: string
+        audio?: {
+          generating?: boolean
+          [key: string]: any
+        }
+        last_generated_at?: number
+        responding?: boolean
+        is_summary?: boolean
+        summary_created_at?: number
+        [key: string]: any
+      }>
+    >
     /* MCP servers status and available tools */
-    mcpServers?: () => Data
+    mcpServers?: () => Data<
+      Array<{
+        generatorId?: string
+        generatorKey?: string
+        name?: string
+        version?: string
+        connected?: boolean
+        error?: string
+        resources?: Array<{
+          name?: string
+          [key: string]: any
+        }>
+        tools?: Array<{
+          name?: string
+          [key: string]: any
+        }>
+        [key: string]: any
+      }>
+    >
   }
 }
 
@@ -544,7 +589,7 @@ Default property:
 export type GeneratorAssistant = Generator &
   GeneratorAssistantDef & {
     templateKey: 'GENERATOR_ASSISTANT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAssistantDef & {
           conds?: Array<{

package/types/generators/BleCentral.ts

@@ -196,11 +196,19 @@ Default property:
   }
   outlets?: {
     /* Is scaning */
-    isScaning?: () => Data
+    isScaning?: () => Data<boolean>
     /* Discovered device list */
-    discoveredDeviceList?: () => Data
+    discoveredDeviceList?: () => Data<
+      Array<{
+        id?: string
+        name?: string
+        rssi?: number
+        advertising?: { [key: string]: any }
+        [key: string]: any
+      }>
+    >
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
@@ -208,7 +216,7 @@ Default property:
 export type GeneratorBleCentral = Generator &
   GeneratorBleCentralDef & {
     templateKey: 'GENERATOR_BLE_CENTRAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBleCentralDef & {
           conds?: Array<{

package/types/generators/BlePeripheral.ts

@@ -149,7 +149,7 @@ Default property:
     beaconsEnable?: boolean | DataLink
     /* Measured RSSI @ 1m, used for calculate distance */
     beaconsTxPower?: number | DataLink
-    /* Beacon configs  
+    /* Beacon configs
   presets has pre-defined layout and manufacturerId  
   layout string is like AltBeacon's Beacon Layout, but replace "x" as extra data  
   id and data could be 0x prefixed hex, hex string, decimal or UUID  
@@ -173,11 +173,11 @@ Default property:
   events?: {}
   outlets?: {
     /* Is advertising */
-    isAdvertising?: () => Data
+    isAdvertising?: () => Data<boolean>
     /* Last receive written */
-    lastWrite?: () => Data
+    lastWrite?: () => Data<{ [key: string]: any }>
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
@@ -185,7 +185,7 @@ Default property:
 export type GeneratorBlePeripheral = Generator &
   GeneratorBlePeripheralDef & {
     templateKey: 'GENERATOR_BLE_PERIPHERAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBlePeripheralDef & {
           conds?: Array<{

package/types/generators/CanvasMap.ts

@@ -39,11 +39,11 @@ Default property:
   }
   outlets?: {
     /* Last matched trigger rule that caused canvas navigation */
-    lastMatchedRule?: () => Data
+    lastMatchedRule?: () => Data<{ [key: string]: any }>
     /* Index of the last matched rule in triggerList */
-    lastMatchedIndex?: () => Data
+    lastMatchedIndex?: () => Data<number>
     /* Total count of canvas navigations triggered by this generator */
-    navigationCount?: () => Data
+    navigationCount?: () => Data<number>
   }
 }
 
@@ -51,7 +51,7 @@ Default property:
 export type GeneratorCanvasMap = Generator &
   GeneratorCanvasMapDef & {
     templateKey: 'GENERATOR_CANVAS_MAP'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCanvasMapDef & {
           conds?: Array<{

package/types/generators/CastlesPay.ts

@@ -50,9 +50,9 @@ Default property:
   }
   outlets?: {
     /* Last Transaction Result */
-    lastTransactionResult?: () => Data
+    lastTransactionResult?: () => Data<{ [key: string]: any }>
     /* Last Error */
-    lastError?: () => Data
+    lastError?: () => Data<string>
   }
 }
 
@@ -60,7 +60,7 @@ Default property:
 export type GeneratorCastlesPay = Generator &
   GeneratorCastlesPayDef & {
     templateKey: 'GENERATOR_CASTLES_PAY'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCastlesPayDef & {
           conds?: Array<{

package/types/generators/DataBank.ts

@@ -71,7 +71,7 @@ Default property:
     spacekey?: string | DataLink
     /* Data need to be fetched */
     properties?: Array<string | DataLink> | DataLink
-    /* Determine the cache behavior  
+    /* Determine the cache behavior
   
  cache-first: Cache first if existing, then fetch from network  
  network-and-cache: Fetch from network, then save cache  
@@ -96,9 +96,36 @@ Default property:
   }
   outlets?: {
     /* Response for Data Bank fetch request, it will save to Data */
-    response?: () => Data
+    response?: () => Data<
+      Array<{
+        __typename?: string
+        id?: string
+        createAt?: string
+        updateAt?: string
+        spaceId?: string
+        propertyId?: string
+        definition?: {
+          type?: string
+          title?: string
+          schema?: { [key: string]: any }
+          [key: string]: any
+        }
+        meta?: string
+        value?: any
+        lastUpdateHash?: string
+        lastUpdateNote?: string
+        lastUpdateKey?: {
+          name?: string
+          enable_expired?: boolean
+          expired_at?: any
+          jwt?: boolean
+          [key: string]: any
+        }
+        [key: string]: any
+      }>
+    >
     /* Server response error of Data Bank fetch request,    it will save to Data */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 
@@ -106,7 +133,7 @@ Default property:
 export type GeneratorDataBank = Generator &
   GeneratorDataBankDef & {
     templateKey: 'GENERATOR_DATA_BANK'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorDataBankDef & {
           conds?: Array<{

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>
   }
 }
 
@@ -321,7 +370,7 @@ Default property:
 export type GeneratorFile = Generator &
   GeneratorFileDef & {
     templateKey: 'GENERATOR_FILE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorFileDef & {
           conds?: Array<{

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>
   }
 }
 
@@ -107,7 +107,7 @@ Default property:
 export type GeneratorGraphQL = Generator &
   GeneratorGraphQLDef & {
     templateKey: 'GENERATOR_GRAPHQL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorGraphQLDef & {
           conds?: Array<{

package/types/generators/Http.ts

@@ -141,7 +141,7 @@ Default property:
     redirect?: 'manual' | 'follow' | 'error' | DataLink
     /* Referrer of HTTP request */
     referrer?: 'no-referrer' | 'client' | DataLink
-    /* HTTP request body,  it will transform depends on `headers.Content-Type`    (`application/json`, `application/x-www-form-urlencoded` or `multipart/form-data`)  
+    /* HTTP request body,  it will transform depends on `headers.Content-Type`    (`application/json`, `application/x-www-form-urlencoded` or `multipart/form-data`)
   The multipart schema like `{ file: { uri: File, type: File MIME, name: File Name }, field: "value" }` */
     body?: {} | DataLink
     /* HTTP response type */
@@ -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>
   }
 }
 
@@ -174,7 +193,7 @@ Default property:
 export type GeneratorHTTP = Generator &
   GeneratorHTTPDef & {
     templateKey: 'GENERATOR_HTTP'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorHTTPDef & {
           conds?: Array<{

package/types/generators/HttpServer.ts

@@ -70,7 +70,7 @@ Default property:
     idleTimeout?: number | DataLink
     /* HTTP request body limit, 0 is unlimited */
     bodyLimit?: number | DataLink
-    /* CORS allowed origins  
+    /* CORS allowed origins
   You can use wildcard like `*`, `*.example.com`, `http://*.example.com` */
     corsOrigins?: Array<string | DataLink> | DataLink
     /* Authorization type of HTTP request */
@@ -81,15 +81,15 @@ Default property:
     basicAuthPassword?: string | DataLink
     /* Token of bearer auth */
     bearerToken?: string | DataLink
-    /* Asynchronous response mode  
+    /* Asynchronous response mode
   Will block connection until Response Body update. */
     asyncMode?: boolean | DataLink
-    /* Save request body as file  
+    /* Save request body as file
   Only work on `application/octet-stream` or `multipart/form-data`. */
     saveBodyAsFile?: boolean | DataLink
     /* Response status code */
     resStatusCode?: number | DataLink
-    /* Response Content-Type  
+    /* Response Content-Type
   `text/*` will not convert body.  
   `application/xml` convert object to XML, [example object struct](https://github.com/davidcalhoun/jstoxml#example-10-podcast-rss-feed)  
   `application/octet-stream` body should be Base64 string or file path. */
@@ -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>
   }
 }
 
@@ -149,7 +149,7 @@ Default property:
 export type GeneratorHTTPServer = Generator &
   GeneratorHTTPServerDef & {
     templateKey: 'GENERATOR_HTTP_SERVER'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorHTTPServerDef & {
           conds?: Array<{

package/types/generators/Information.ts

@@ -72,7 +72,7 @@ Default property:
   }
   outlets?: {
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
@@ -80,7 +80,7 @@ Default property:
 export type GeneratorInformation = Generator &
   GeneratorInformationDef & {
     templateKey: 'GENERATOR_INFORMATION'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorInformationDef & {
           conds?: Array<{

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
+    }>
   }
 }
 
@@ -139,7 +145,7 @@ Default property:
 export type GeneratorIntent = Generator &
   GeneratorIntentDef & {
     templateKey: 'GENERATOR_INTENT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorIntentDef & {
           conds?: Array<{

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>
   }
 }
 
@@ -85,7 +85,7 @@ Default property:
 export type GeneratorIterator = Generator &
   GeneratorIteratorDef & {
     templateKey: 'GENERATOR_ITERATOR'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorIteratorDef & {
           conds?: Array<{

package/types/generators/Keyboard.ts

@@ -27,13 +27,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 */
@@ -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
+      }>
+    >
   }
 }
 
@@ -67,7 +77,7 @@ Default property:
 export type GeneratorKeyboard = Generator &
   GeneratorKeyboardDef & {
     templateKey: 'GENERATOR_KEYBOARD'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorKeyboardDef & {
           conds?: Array<{