@fugood/bricks-project 2.24.0-beta.15 → 2.24.0-beta.17

package/compile/action-name-map.ts

@@ -772,6 +772,20 @@ export const templateActionNameMap = {
       documents: 'GENERATOR_RERANKER_DOCUMENTS',
     },
   },
+  GENERATOR_MLX_LLM: {
+    GENERATOR_MLX_LLM_LOAD_MODEL: {
+      modelId: 'GENERATOR_MLX_LLM_MODEL_ID',
+      vlm: 'GENERATOR_MLX_LLM_VLM',
+    },
+    GENERATOR_MLX_LLM_COMPLETION: {
+      messages: 'GENERATOR_MLX_LLM_MESSAGES',
+      tools: 'GENERATOR_MLX_LLM_TOOLS',
+      maxTokens: 'GENERATOR_MLX_LLM_MAX_TOKENS',
+      temperature: 'GENERATOR_MLX_LLM_TEMPERATURE',
+      topP: 'GENERATOR_MLX_LLM_TOP_P',
+      repetitionPenalty: 'GENERATOR_MLX_LLM_REPETITION_PENALTY',
+    },
+  },
   GENERATOR_QNN_LLM: {
     GENERATOR_QNN_LLM_PROCESS: {
       prompt: 'GENERATOR_QNN_LLM_PROMPT',

package/compile/index.ts

@@ -266,6 +266,7 @@ const compileApplicationSettings = (settings: Application['settings']) => ({
         use_gemini_api_key_system_data: settings.ai.useGeminiApiKeySystemData,
       }
     : undefined,
+  hide_short_refs: settings?.hideShortRefs,
 })
 
 const animationTypeMap = {
@@ -385,6 +386,7 @@ function compileRunArray(run: unknown[]): unknown[] {
 const compileTestCase = (testCase: TestCase) => ({
   id: testCase.id,
   name: testCase.name,
+  hide_short_ref: testCase.hideShortRef,
   run: compileRunArray(testCase.run),
   exit_on_failed: testCase.exit_on_failed,
   commented: testCase.commented,
@@ -449,6 +451,7 @@ const compileAutomationTest = (
   return {
     id: testId,
     title: test.title,
+    hide_short_ref: test.hideShortRef,
     timeout: test.timeout,
     trigger_type: test.trigger_type,
     cron: test.cron,
@@ -476,6 +479,7 @@ const compileAutomationTestMap = (testMap: AutomationTestMap, mapId: string) =>
 
   return {
     title: testMap.title,
+    hide_short_ref: testMap.hideShortRef,
     createdAt: testMap.createdAt,
     map: arrayToIdMap(
       testMap.tests,
@@ -519,6 +523,7 @@ export const compile = async (app: Application) => {
       subspaceMap[subspaceId] = {
         title: subspace.title,
         description: subspace.description,
+        hide_short_ref: subspace.hideShortRef,
         _expanded: subspace.unexpanded
           ? {
               brick: !subspace.unexpanded.brick,
@@ -556,8 +561,10 @@ export const compile = async (app: Application) => {
           if (animation.__typename === 'Animation') {
             const animationDef = animation as AnimationDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               property: animationDef.property,
               type: animationTypeMap[animationDef.config.__type],
@@ -569,8 +576,10 @@ export const compile = async (app: Application) => {
           } else if (animation.__typename === 'AnimationCompose') {
             const animationDef = animation as AnimationComposeDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               compose_type: animationDef.composeType,
               item_list: animationDef.items.map((item, index) => {
@@ -670,6 +679,8 @@ export const compile = async (app: Application) => {
                 buildList(item, index, 'brickList'),
               )
               property.brickList = brickList
+            } else if (!brickItems.brickList) {
+              property.brickList = []
             } else {
               // Not supported Data for brickList
               throw new TypeError('Not supported Data for brickList directly')
@@ -679,6 +690,8 @@ export const compile = async (app: Application) => {
                 buildList(item, index, 'brickDetails'),
               )
               property.brickDetails = brickDetails
+            } else if (!brickItems.brickDetails) {
+              property.brickDetails = []
             } else {
               // Not supported Data for brickList
               throw new TypeError('Not supported Data for brickList directly')
@@ -686,8 +699,10 @@ export const compile = async (app: Application) => {
           }
           map[brickId] = {
             template_key: brick.templateKey,
+            alias: brick.alias,
             title: brick.title,
             description: brick.description,
+            hide_short_ref: brick.hideShortRef,
             property,
             animation: compileAnimations(
               brick.templateKey,
@@ -754,8 +769,10 @@ export const compile = async (app: Application) => {
           )
 
           map[canvasId] = {
+            alias: canvas.alias,
             title: canvas.title,
             description: canvas.description,
+            hide_short_ref: canvas.hideShortRef,
             property: compileProperty(
               canvas.property,
               `(canvas: ${canvasId}, subspace ${subspaceId})`,
@@ -834,8 +851,10 @@ export const compile = async (app: Application) => {
 
           map[generatorId] = {
             template_key: generator.templateKey,
+            alias: generator.alias,
             title: generator.title,
             description: generator.description,
+            hide_short_ref: generator.hideShortRef,
             local_sync: generator.localSyncRunMode
               ? {
                   run_mode: generator.localSyncRunMode,
@@ -904,8 +923,10 @@ export const compile = async (app: Application) => {
           )
 
           map[dataId] = {
+            alias: data.alias,
             title: data.title,
             description: data.description,
+            hide_short_ref: data.hideShortRef,
             linked: data.metadata?.linked,
             linkedFrom: data.metadata?.linkedFrom,
             local_sync: data.localSyncUpdateMode
@@ -939,6 +960,7 @@ export const compile = async (app: Application) => {
           const calc: any = {
             title: dataCalc.title,
             description: dataCalc.description,
+            hide_short_ref: dataCalc.hideShortRef,
           }
           if (dataCalc.triggerMode) calc.trigger_type = dataCalc.triggerMode
           if (dataCalc.__typename === 'DataCalculationMap') {
@@ -1025,6 +1047,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(dataNode, 'data node', nodeIndex)] = {
                   title: dataNode.title,
                   description: dataNode.description,
+                  hide_short_ref: dataNode.hideShortRef,
                   type: 'data-node',
                   properties: {},
                   in: generateInputPorts(dataNode.inputs),
@@ -1050,6 +1073,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(commandNode, 'command node', nodeIndex)] = {
                   title: commandNode.title,
                   description: commandNode.description,
+                  hide_short_ref: commandNode.hideShortRef,
                   type: `command-node-${type}`,
                   properties: {
                     command: commandNode.__commandName,

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.24.0-beta.15",
+  "version": "2.24.0-beta.17",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.24.0-beta.15",
+    "@fugood/bricks-cli": "^2.24.0-beta.17",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
@@ -24,5 +24,5 @@
   "peerDependencies": {
     "oxfmt": "^0.36.0"
   },
-  "gitHead": "acd51daff8ae31ef803c59b974dfe55fa21af9ed"
+  "gitHead": "d99917a2e6eacce97d527fee3c2d6c5bbdcfeef5"
 }

package/skills/bricks-project/rules/architecture-patterns.md

@@ -37,6 +37,13 @@ Built-in commands for direct state and UI changes.
 ### Data Calculation (Priority 4)
 ONLY for deriving, formatting, or aggregating values from other data. Not for orchestration, side effects, or flow control.
 
+## Entity Aliases
+
+Set `alias` on entities to give them a stable, human-readable name:
+- Code generation uses alias as the variable name (e.g., `alias: 'submitBtn'` → `export const submitBtn`)
+- At runtime, devtools MCP tools accept alias instead of short ID and selectors can match by alias. Note: bricks-project does not directly interact with devtools MCP — aliases here primarily affect code generation
+- Aliases must be unique across the application — duplicates are excluded from resolution
+
 ## Flow Decomposition
 
 When the user describes a complex flow, decompose it BEFORE writing code:

package/skills/bricks-project/rules/buttress.md

@@ -14,8 +14,9 @@ When mobile devices or embedded systems lack hardware for local AI inference (LL
 
 ## Supported Generators
 
-- [LLM (GGML)](generator_LLM) - Local Large Language Model inference
-- [Speech-to-Text (GGML)](generator_SpeechInference) - Local Speech-to-Text inference
+- LLM (GGML) (LlmMlx.ts) - Local Large Language Model inference with GGML
+- LLM (MLX) (LlmGgml.ts) - Local Large Language Model inference with MLX
+- Speech-to-Text (GGML) (SpeechToTextGgml.ts) - Local Speech-to-Text inference with GGML
 
 ## Client Configuration
 
@@ -50,10 +51,12 @@ const llmGenerator: GeneratorLLM = {
   property: {
     modelUrl: 'https://huggingface.co/ggml-org/gemma-3-12b-it-qat-GGUF/resolve/main/gemma-3-12b-it-qat-q4_0.gguf',
     contextSize: 8192,
-    buttressEnabled: true,
-    buttressUrl: 'http://192.168.1.100:2080',
-    buttressFallbackType: 'use-local',
-    buttressStrategy: 'prefer-best',
+    buttressConnectionSettings: {
+      enabled: true,
+      url: 'http://192.168.1.100:2080',
+      fallbackType: 'use-local',
+      strategy: 'prefer-best',
+    },
   },
   events: {},
   switches: [],

package/tools/mcp-tools/huggingface.ts

@@ -102,6 +102,7 @@ type HFSibling = {
   rfilename: string
   size?: number
   lfs?: { sha256?: string }
+  blobId?: string
 }
 
 type HFModel = {
@@ -132,8 +133,9 @@ type GeneratorType =
   | 'GeneratorOnnxLLM'
   | 'GeneratorOnnxSTT'
   | 'GeneratorTTS'
+  | 'GeneratorMlxLLM'
 
-type ModelKind = 'gguf' | 'onnx'
+type ModelKind = 'gguf' | 'onnx' | 'mlx'
 
 interface GeneratorConfig {
   modelKind: ModelKind
@@ -219,6 +221,11 @@ const generatorConfigs: Record<GeneratorType, GeneratorConfig> = {
     filter: 'onnx,text-to-speech',
     hasValidStructure: hasValidOnnxStructure,
   },
+  GeneratorMlxLLM: {
+    modelKind: 'mlx',
+    filter: 'mlx',
+    taskFilter: supportedLlmTasks,
+  },
 }
 
 const searchHFModels = async (filter: string, search?: string, limit = 50): Promise<HFModel[]> => {
@@ -276,6 +283,7 @@ export function register(server: McpServer) {
           'GeneratorOnnxLLM',
           'GeneratorOnnxSTT',
           'GeneratorTTS',
+          'GeneratorMlxLLM',
         ])
         .describe('Generator type to search models for')
         .default('GeneratorLLM'),
@@ -407,6 +415,7 @@ export function register(server: McpServer) {
           'GeneratorOnnxLLM',
           'GeneratorOnnxSTT',
           'GeneratorTTS',
+          'GeneratorMlxLLM',
         ])
         .describe('Generator type for model selection')
         .default('GeneratorLLM'),
@@ -489,7 +498,107 @@ export function register(server: McpServer) {
 
           // Return JSON for huggingface_select to allow direct parsing by consumers
           return {
-            content: [{ type: 'text', text: JSON5.stringify(result, null, 2) }],
+            content: [
+              {
+                type: 'text',
+                text: `${JSON5.stringify(result, null, 2)} // Please use _hfRepoInfo undocumented field with @ts-ignore`,
+              },
+            ],
+          }
+        }
+
+        // Handle MLX models (repo-level, like ONNX)
+        if (config.modelKind === 'mlx') {
+          // Fetch config.json for model architecture metadata
+          const headers: Record<string, string> = {}
+          if (HF_TOKEN) headers['Authorization'] = `Bearer ${HF_TOKEN}`
+          let mlxModelConfig: Record<string, any> | null = null
+          try {
+            const configRes = await fetch(
+              `https://huggingface.co/${modelId}/resolve/main/config.json`,
+              { headers },
+            )
+            if (configRes.ok) mlxModelConfig = await configRes.json()
+          } catch {
+            // Non-critical
+          }
+
+          const modelType =
+            mlxModelConfig?.model_type || details.config?.model_type || details.cardData?.model_type
+
+          // Build MLX model metadata from config.json (for hardware guardrails)
+          const cfg = mlxModelConfig || ({} as Record<string, any>)
+          const textCfg = cfg.text_config || cfg
+          const numHeads = textCfg.num_attention_heads || textCfg.n_heads || 0
+          const hiddenSize = textCfg.hidden_size || textCfg.dim || 0
+          const kvLoraRank = textCfg.kv_lora_rank || 0
+          const quant = cfg.quantization || cfg.quantization_config || null
+
+          // Sum safetensors/npz file sizes for model weight bytes
+          const modelBytes = siblings
+            .filter((f) => /\.(safetensors|npz)$/.test(f.rfilename))
+            .reduce((sum, f) => sum + (f.size ?? 0), 0)
+
+          // Build _mlxDownloadFiles list (safetensors, json, jinja, tokenizer.model)
+          const mlxDownloadFiles = siblings
+            .filter(
+              (f) =>
+                f.rfilename.endsWith('.safetensors') ||
+                f.rfilename.endsWith('.json') ||
+                f.rfilename.endsWith('.jinja') ||
+                f.rfilename === 'tokenizer.model',
+            )
+            .map((f) => ({
+              url: `https://huggingface.co/${modelId}/resolve/main/${f.rfilename}?download=true`,
+              filename: `${modelId.replace('/', '-')}/${f.rfilename}`,
+              hash_type: f.lfs ? 'sha256' : f.blobId ? 'sha1' : undefined,
+              sha256: f.lfs?.sha256,
+              sha1: f.lfs ? undefined : f.blobId,
+            }))
+
+          const result = {
+            modelId,
+            modelType,
+            _mlxDownloadFiles: mlxDownloadFiles,
+            _hfRepoInfo: {
+              repo: modelId,
+              model: {
+                id: details.id,
+                downloads: details.downloads,
+                likes: details.likes,
+                author: details.author,
+              },
+              generatorType,
+              modelType,
+              ...(modelBytes > 0 && { size: modelBytes }),
+              ...(mlxModelConfig && {
+                mlxModelMetadata: {
+                  hiddenSize,
+                  numLayers: textCfg.num_hidden_layers || textCfg.n_layers || 0,
+                  numHeads,
+                  numKvHeads: textCfg.num_key_value_heads ?? numHeads,
+                  headDim:
+                    textCfg.head_dim ||
+                    textCfg.v_head_dim ||
+                    (numHeads > 0 && hiddenSize > 0 ? hiddenSize / numHeads : 0),
+                  maxCtx: textCfg.max_position_embeddings || 0,
+                  kvLoraRank,
+                  qkRopeHeadDim: textCfg.qk_rope_head_dim || 0,
+                  isMLA: kvLoraRank > 0,
+                  quantBits: quant?.bits || null,
+                  quantGroupSize: quant?.group_size || null,
+                },
+              }),
+            },
+          }
+
+          return {
+            content: [
+              {
+                type: 'text',
+                text: `${JSON5.stringify(result, null, 2)} // IMPORTANT: Use _mlxDownloadFiles / _hfRepoInfo undocumented fields with @ts-ignore`,
+              },
+            ],
           }
         }
 
@@ -638,7 +747,7 @@ export function register(server: McpServer) {
             content: [
               {
                 type: 'text',
-                text: `${JSON5.stringify(result, null, 2)} // Please use _hfRepoInfo undocumented field with @ts-ignore`,
+                text: `${JSON5.stringify(result, null, 2)} // IMPORTANT: Use _hfRepoInfo undocumented field with @ts-ignore`,
               },
             ],
           }

package/types/animation.ts

@@ -61,8 +61,10 @@ export interface AnimationDecayConfig {
 export interface AnimationDef {
   __typename: 'Animation'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   runType?: 'once' | 'loop'
   property:
     | 'transform.translateX'
@@ -80,8 +82,10 @@ export interface AnimationDef {
 export interface AnimationComposeDef {
   __typename: 'AnimationCompose'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   runType?: 'once' | 'loop'
   composeType: 'parallel' | 'sequence'
   items: Array<() => Animation>

package/types/automation.ts

@@ -182,6 +182,7 @@ export interface TestCase {
   __typename: 'TestCase'
   id: string
   name: string
+  hideShortRef?: boolean
   run: TestMethodRun
   exit_on_failed: boolean
   commented: boolean
@@ -203,6 +204,7 @@ export interface AutomationTest {
   __typename: 'AutomationTest'
   id: string
   title: string
+  hideShortRef?: boolean
   timeout: number
   trigger_type?: TestTriggerType
   cron?: string // Cron expression when trigger_type is 'cron'
@@ -220,6 +222,7 @@ export interface AutomationTestMap {
   __typename: 'AutomationTestMap'
   id: string
   title: string
+  hideShortRef?: boolean
   createdAt: number
   tests: AutomationTest[]
 }

package/types/bricks/Camera.ts

@@ -188,7 +188,7 @@ Default property:
   }
 }
 
-/* Camera view brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378589-camera)) */
+/* Camera view brick */
 export type BrickCamera = Brick &
   BrickCameraDef & {
     templateKey: 'BRICK_CAMERA'

package/types/bricks/Image.ts

@@ -87,7 +87,7 @@ Default property:
   }
 }
 
-/* Image brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378576-image)) */
+/* Image brick */
 export type BrickImage = Brick &
   BrickImageDef & {
     templateKey: 'BRICK_IMAGE'

package/types/bricks/Lottie.ts

@@ -137,7 +137,7 @@ Default property:
   }
 }
 
-/* Lottie Adobe After Effects animations brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378583-lottie)) */
+/* Lottie Adobe After Effects animations brick */
 export type BrickLottie = Brick &
   BrickLottieDef & {
     templateKey: 'BRICK_LOTTIE'

package/types/bricks/Maps.ts

@@ -231,7 +231,7 @@ Default property:
   }
 }
 
-/* Maps brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/maps)) */
+/* Maps brick */
 export type BrickMaps = Brick &
   BrickMapsDef & {
     templateKey: 'BRICK_MAPS'

package/types/bricks/QrCode.ts

@@ -90,7 +90,7 @@ Default property:
   }
 }
 
-/* QRCode brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378579-qr-code)) */
+/* QRCode brick */
 export type BrickQrcode = Brick &
   BrickQrcodeDef & {
     templateKey: 'BRICK_QRCODE'

package/types/bricks/Rect.ts

@@ -88,7 +88,7 @@ Default property:
   }
 }
 
-/* Rect brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378573-rect)) */
+/* Rect brick */
 export type BrickRect = Brick &
   BrickRectDef & {
     templateKey: 'BRICK_RECT'

package/types/bricks/Slideshow.ts

@@ -168,7 +168,7 @@ Default property:
   }
 }
 
-/* Slideshow brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378580-slideshow)) */
+/* Slideshow brick */
 export type BrickSlideshow = Brick &
   BrickSlideshowDef & {
     templateKey: 'BRICK_SLIDESHOW'

package/types/bricks/Text.ts

@@ -121,7 +121,7 @@ Default property:
   }
 }
 
-/* Text brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378574-text)) */
+/* Text brick */
 export type BrickText = Brick &
   BrickTextDef & {
     templateKey: 'BRICK_TEXT'

package/types/bricks/TextInput.ts

@@ -209,7 +209,7 @@ Default property:
   }
 }
 
-/* Text Input brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378575-text-input)) */
+/* Text Input brick */
 export type BrickTextInput = Brick &
   BrickTextInputDef & {
     templateKey: 'BRICK_TEXT_INPUT'

package/types/bricks/Video.ts

@@ -148,7 +148,7 @@ Default property:
   }
 }
 
-/* Video brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378577-video)) */
+/* Video brick */
 export type BrickVideo = Brick &
   BrickVideoDef & {
     templateKey: 'BRICK_VIDEO'

package/types/bricks/WebView.ts

@@ -141,7 +141,7 @@ Default property:
   }
 }
 
-/* WebView brick ([Tutorial](https://intercom.help/bricks-dag-inc/articles/5378588-web-view)) */
+/* WebView brick */
 export type BrickWebView = Brick &
   BrickWebViewDef & {
     templateKey: 'BRICK_WEBVIEW'

package/types/canvas.ts

@@ -36,8 +36,10 @@ interface CanvasDef {
 export type Canvas = CanvasDef & {
   __typename: 'Canvas'
   id: string
+  alias?: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   switches?: Array<
     SwitchDef &
       CanvasDef & {

package/types/common.ts

@@ -6,9 +6,11 @@ import type { AutomationMap } from './automation'
 export interface Brick {
   __typename: 'Brick'
   id: string
+  alias?: string
   templateKey: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   property?: {}
   events: {}
   outlets?: {}
@@ -24,9 +26,11 @@ export enum LocalSyncStrategy {
 export interface Generator {
   __typename: 'Generator'
   id: string
+  alias?: string
   templateKey: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   localSyncRunMode?: LocalSyncStrategy
   property?: {}
   events: {}
@@ -121,6 +125,7 @@ export type ApplicationSettings = {
     useOpenAiApiKeySystemData?: boolean
     useGeminiApiKeySystemData?: boolean
   }
+  hideShortRefs?: boolean
 }
 
 export type Application = {

package/types/data-calc-command.ts

@@ -6,6 +6,7 @@ export interface DataCalculationData {
   __typename: 'DataCalculationData'
   title?: string
   description?: string
+  hideShortRef?: boolean
   data: () => Data
   inputs: Array<{
     key: 'change'
@@ -26,6 +27,7 @@ export interface DataCommand {
   id: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   inputs: Array<{
     key: string
     source: (() => DataCalculationData | DataCommand) | any

package/types/data-calc.ts

@@ -4,6 +4,7 @@ export interface DataCalculation {
   id: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   // Auto: Run the calculation when inputs change and allow triggers. Careful with circular dependencies!
   // Manual: Only run the calculation when manually triggered by System Action PROPERTY_BANK_COMMAND
   triggerMode?: 'auto' | 'manual'

package/types/data.ts

@@ -17,8 +17,10 @@ interface DataDef {
 export type Data<T = any> = DataDef & {
   __typename: 'Data'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   metadata?: {
     linked?: Array<SubspaceID>
     linkedFrom?: SubspaceID

package/types/generators/Assistant.ts

@@ -434,7 +434,7 @@ 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.
 

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
+    /* Model load progress (0-1) */
+    loadProgress?: () => Data
+    /* Whether the model is evaluating */
+    isEvaluating?: () => Data
+    /* Completion result */
+    completionResult?: () => Data
+    /* Last token */
+    completionLastToken?: () => Data
+  }
+}
+
+/* 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/index.ts

@@ -44,6 +44,7 @@ export * from './RealtimeTranscription'
 export * from './LlmGgml'
 export * from './TextToSpeechGgml'
 export * from './RerankerGgml'
+export * from './LlmMlx'
 export * from './LlmQualcommAiEngine'
 export * from './LlmOpenAiCompat'
 export * from './TextToSpeechOpenAiLike'

package/types/subspace.ts

@@ -9,6 +9,7 @@ export type Subspace = {
   id: string
   title: string
   description?: string
+  hideShortRef?: boolean
   // Unexpanded information in Editor
   unexpanded?: {
     data?: boolean

package/utils/event-props.ts

@@ -905,6 +905,22 @@ export const templateEventPropsMap = {
       'GENERATOR_RERANKER_ERROR', // type: string
     ],
   },
+  GENERATOR_MLX_LLM: {
+    onContextStateChange: [
+      'GENERATOR_MLX_LLM_CONTEXT_STATE', // type: string
+    ],
+    onError: [
+      'GENERATOR_MLX_LLM_ERROR', // type: string
+    ],
+    onCompletion: [
+      'GENERATOR_MLX_LLM_COMPLETION_TOKEN', // type: string
+      'GENERATOR_MLX_LLM_COMPLETION_RESULT', // type: string
+    ],
+    onCompletionFinished: [
+      'GENERATOR_MLX_LLM_COMPLETION_RESULT', // type: string
+      'GENERATOR_MLX_LLM_COMPLETION_RESULT_DETAILS', // type: object
+    ],
+  },
   GENERATOR_QNN_LLM: {
     onContextStateChange: [
       'GENERATOR_QNN_LLM_CONTEXT_STATE', // type: string