@fugood/bricks-project 2.24.5 → 2.24.7

package/compile/action-name-map.ts

@@ -899,10 +899,12 @@ export const templateActionNameMap = {
     GENERATOR_APPLE_STT_TRANSCRIBE_FILE: {
       fileUrl: 'GENERATOR_APPLE_STT_FILE_URL',
       language: 'GENERATOR_APPLE_STT_LANGUAGE',
+      contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
     },
     GENERATOR_APPLE_STT_TRANSCRIBE_DATA: {
       data: 'GENERATOR_APPLE_STT_DATA',
       language: 'GENERATOR_APPLE_STT_LANGUAGE',
+      contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
     },
   },
   GENERATOR_APPLE_TTS: {

package/compile/index.ts

@@ -511,9 +511,10 @@ const compileKind = (kind: Data['kind']) => {
 }
 
 const compileRemoteUpdate = (remoteUpdate: Data['remoteUpdate']) => {
-  if (!remoteUpdate) return {}
-  if (remoteUpdate.type === 'auto') return { enable_remote_update: true }
+  if (!remoteUpdate) return { bank_type: 'none' }
+  if (remoteUpdate.type === 'auto') return { bank_type: 'create', enable_remote_update: true }
   return {
+    bank_type: remoteUpdate.type === 'device-specific' ? 'create-device-specific' : 'global',
     enable_remote_update: true,
     ...(remoteUpdate.type === 'device-specific' ? { use_remote_id_prefix: true } : {}),
     ...(remoteUpdate.type === 'global-data' ? { global_remote_update_prop: remoteUpdate.id } : {}),

package/package.json

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

package/skills/bricks-ctor/SKILL.md

@@ -11,24 +11,24 @@ This skill covers advanced BRICKS features not in the main project instructions.
 
 | Rule | Description |
 |------|-------------|
-| [Architecture Patterns](rules/architecture-patterns.md) | **Read first** — decompose flows and select patterns |
-| [Animation](rules/animation.md) | Animation system for brick transforms and opacity |
-| [Standby Transition](rules/standby-transition.md) | Canvas enter/exit animations |
-| [Automations](rules/automations.md) | E2E testing and scheduled tasks |
-| [Data Calculation](rules/data-calculation.md) | JS sandbox libraries (25+ available) |
-| [Local Sync](rules/local-sync.md) | LAN device synchronization |
-| [Remote Data Bank](rules/remote-data-bank.md) | Cloud data sync and API access |
-| [Media Flow](rules/media-flow.md) | Media asset management |
-| [Buttress](rules/buttress.md) | Remote inference for AI generators |
-| [Verification Toolchain](rules/verification-toolchain.md) | Definition of done, compile, preview tool selection, on-device DevTools, Path 1/2/3 decision rule |
+| [Architecture Patterns](references/architecture-patterns.md) | **Read first** — decompose flows and select patterns |
+| [Animation](references/animation.md) | Animation system for brick transforms and opacity |
+| [Standby Transition](references/standby-transition.md) | Canvas enter/exit animations |
+| [Automations](references/automations.md) | E2E testing and scheduled tasks |
+| [Data Calculation](references/data-calculation.md) | JS sandbox libraries (25+ available) |
+| [Local Sync](references/local-sync.md) | LAN device synchronization |
+| [Remote Data Bank](references/remote-data-bank.md) | Cloud data sync and API access |
+| [Media Flow](references/media-flow.md) | Media asset management |
+| [Buttress](references/buttress.md) | Remote inference for AI generators |
+| [Verification Toolchain](references/verification-toolchain.md) | Definition of done, compile, preview tool selection, on-device DevTools, Path 1/2/3 decision rule |
 
 ## Quick Reference
 
-- **Complex flows**: See [Architecture Patterns](rules/architecture-patterns.md) for decomposing multi-step workflows
-- **Multi-device**: See [Local Sync](rules/local-sync.md) for LAN coordination
-- **Cloud data**: See [Remote Data Bank](rules/remote-data-bank.md) for sync and API access
-- **Media assets**: See [Media Flow](rules/media-flow.md) for centralized asset management
-- **AI offloading**: See [Buttress](rules/buttress.md) for GPU server delegation
-- **E2E testing**: See [Automations](rules/automations.md) for test automation
-- **Enter animations**: See [Standby Transition](rules/standby-transition.md) for canvas transitions
-- **Verification before done**: See [Verification Toolchain](rules/verification-toolchain.md) for the definition-of-done gate and Path 1/2/3 decision rule
+- **Complex flows**: See [Architecture Patterns](references/architecture-patterns.md) for decomposing multi-step workflows
+- **Multi-device**: See [Local Sync](references/local-sync.md) for LAN coordination
+- **Cloud data**: See [Remote Data Bank](references/remote-data-bank.md) for sync and API access
+- **Media assets**: See [Media Flow](references/media-flow.md) for centralized asset management
+- **AI offloading**: See [Buttress](references/buttress.md) for GPU server delegation
+- **E2E testing**: See [Automations](references/automations.md) for test automation
+- **Enter animations**: See [Standby Transition](references/standby-transition.md) for canvas transitions
+- **Verification before done**: See [Verification Toolchain](references/verification-toolchain.md) for the definition-of-done gate and Path 1/2/3 decision rule

package/tools/_last-pushed-commit.ts

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises'
 
 // Local sync marker: the git commit hash that was on HEAD when we last
-// successfully pushed to the server (deploy or update-config) or pulled
+// successfully pushed to the server (deploy or push-config) or pulled
 // from it. Stored at the `.bricks/` top level (gitignored explicitly) — it's
 // per-clone state, not a build artifact, so it doesn't belong under
 // `.bricks/build/`.

package/tools/pull.ts

@@ -78,7 +78,7 @@ if (result.exitCode !== 0) {
 
 const { files, lastCommitId: serverLastCommitId } = JSON.parse(result.stdout.toString())
 
-// The locally-saved commit (recorded by deploy/update-config) is the
+// The locally-saved commit (recorded by deploy/push-config) is the
 // authoritative merge base for THIS clone — the server's value can be an
 // opaque nanoid (config-only updates) or point to a commit other clients
 // produced. Fall back to the server's value only if we have no local

package/tools/{update-config.ts → push-config.ts}

@@ -88,7 +88,7 @@ const updateConfig = {
   ...config,
   bricks_project_last_commit_id: commitId || undefined,
 }
-const configPath = `${cwd}/.bricks/build/update-config.json`
+const configPath = `${cwd}/.bricks/build/push-config.json`
 await writeFile(configPath, JSON.stringify(updateConfig))
 
 const args = ['bricks', command, 'update', app.id, '-f', configPath, '--json']

package/types/{automation.ts → automation.d.ts}

@@ -83,9 +83,22 @@ export type TestMethodName =
   | 'delay'
 
 /**
- * Run array types for each test method
- * Each method has a specific signature: [methodName, ...args]
+ * Union type for all test method run arrays
  */
+export type TestMethodRun =
+  | TestMethodRunBrickPress
+  | TestMethodRunBrickExists
+  | TestMethodRunWaitUntilBrickExists
+  | TestMethodRunWaitUntilEventTrigger
+  | TestMethodRunWaitUntilCanvasChange
+  | TestMethodRunKeydown
+  | TestMethodRunKeyup
+  | TestMethodRunHttpRequest
+  | TestMethodRunAssertProperty
+  | TestMethodRunWaitUntilPropertyChange
+  | TestMethodRunExecuteAction
+  | TestMethodRunMatchScreenshot
+  | TestMethodRunDelay
 
 // [methodName, subspaceId, brickId, options?]
 export type TestMethodRunBrickPress = ['brick_press', SubspaceRef, BrickRef, Record<string, any>?]
@@ -157,24 +170,6 @@ export type TestMethodRunMatchScreenshot = ['match_screenshot', string, number?,
 // [methodName, subspaceId?, propertyId?, defaultValue?]
 export type TestMethodRunDelay = ['delay', SubspaceRef?, DataRef?, number?]
 
-/**
- * Union type for all test method run arrays
- */
-export type TestMethodRun =
-  | TestMethodRunBrickPress
-  | TestMethodRunBrickExists
-  | TestMethodRunWaitUntilBrickExists
-  | TestMethodRunWaitUntilEventTrigger
-  | TestMethodRunWaitUntilCanvasChange
-  | TestMethodRunKeydown
-  | TestMethodRunKeyup
-  | TestMethodRunHttpRequest
-  | TestMethodRunAssertProperty
-  | TestMethodRunWaitUntilPropertyChange
-  | TestMethodRunExecuteAction
-  | TestMethodRunMatchScreenshot
-  | TestMethodRunDelay
-
 /**
  * Test case definition
  */

package/types/{common.ts → common.d.ts}

@@ -18,10 +18,7 @@ export interface Brick {
   switches?: Array<SwitchDef>
 }
 
-export enum LocalSyncStrategy {
-  mainOnly = 'main-only',
-  minorOnly = 'minor-only',
-}
+export type LocalSyncStrategy = 'main-only' | 'minor-only'
 
 export interface Generator {
   __typename: 'Generator'

package/types/generators/{Assistant.ts → Assistant.d.ts}

@@ -511,7 +511,7 @@ Default property:
     mcpResourceAnnotationKeyword?: string | DataLink
     /* Fallback text when MCP server or resource is not found. If empty, an error will be thrown. */
     mcpResourceAnnotationFallback?: string | DataLink
-    /* Guardrails — safety checks applied at specific pipeline hook points.  Each entry runs a `pattern` regex or `llm` verdict check at the specified `on` hook,  and fires the configured `action` when triggered.  Template slots available in `llmUserPromptTemplate` / `llmSystemPrompt`: `{input}`, `{output}`, `{tool_call}`, `{tool_args}`, `{tool_result}`.  For `action: 'redact'` with `kind: 'llm'`, `llmSystemPrompt` is also used as the sanitiser system prompt (defaults to a built-in rewrite instruction when omitted). */
+    /* Guardrails — safety checks applied at specific pipeline hook points.  Each entry runs a `pattern` regex or `llm` verdict check at the specified `on` hook,  and fires the configured `action` when triggered.  Jinja template kwargs for `llmUserPromptTemplate` / `llmSystemPrompt`:    `input` (string) — last user message text    `output` (string) — LLM response text    `tool_call` (string) — tool function name    `tool_args` (object) — tool call arguments (use `{{ tool_args | tojson }}` for JSON string, `{{ tool_args.key }}` for field access)    `tool_result` (string) — tool execution result    `messages` (array) — conversation history as `[{role, content}, ...]`  Legacy `{var}` format is auto-upgraded to `{{ var }}`.  For `action: 'redact'` with `kind: 'llm'`, `llmSystemPrompt` is also used as the sanitiser system prompt (defaults to a built-in rewrite instruction when omitted).  `redactReplacement` — custom replacement string for pattern redaction (defaults to `[REDACTED]`).  Hook semantics: `before-llm` only fires on initial user submissions (skipped on tool-result continuations).  `after-llm` fires on all non-tool-call responses (skipped only on tool-call-only responses). */
     guardrails?:
       | Array<
           | DataLink
@@ -526,6 +526,7 @@ Default property:
               llmUserPromptTemplate?: string | DataLink
               llmResultMatch?: string | DataLink
               action?: 'block' | 'redact' | 'log-only' | DataLink
+              redactReplacement?: string | DataLink
             }
         >
       | DataLink

package/types/generators/{LlmGgml.ts → LlmGgml.d.ts}

@@ -11,6 +11,8 @@
  *    - 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)
+ *  - Web: Supported with CPU and WebGPU acceleration.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -863,7 +865,9 @@ Default property:
    - 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) */
+   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)  
+ - Web: Supported with CPU and WebGPU acceleration.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorLLM = Generator &
   GeneratorLLMDef & {
     templateKey: 'GENERATOR_LLM'

package/types/generators/{RerankerGgml.ts → RerankerGgml.d.ts}

@@ -12,6 +12,8 @@
  *  - Linux / Windows
  *    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
  *    - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)
+ *  - Web: Supported with CPU and WebGPU acceleration.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -163,7 +165,9 @@ Default property:
    - Supported Hexagon NPU for Qualcomm Snapdragon 8 Gen 2+ GPUs.  
  - Linux / Windows  
    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property  
-   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux) */
+   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)  
+ - Web: Supported with CPU and WebGPU acceleration.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorReranker = Generator &
   GeneratorRerankerDef & {
     templateKey: 'GENERATOR_RERANKER'

package/types/generators/{SoundRecorder.ts → SoundRecorder.d.ts}

@@ -54,7 +54,8 @@ Default property:
   "autoCuttingVocalFreqMin": 75,
   "autoCuttingVocalFreqMax": 900,
   "autoCuttingFreqClarity": 0.5,
-  "autoCuttingSpeakSpacing": 0.5
+  "autoCuttingSpeakSpacing": 0.5,
+  "userMediaAudioOptions": {}
 }
   */
   property?: {
@@ -86,6 +87,14 @@ Default property:
     autoCuttingVolumeThreshold?: number | DataLink
     /* Speak spacing of cutting fragments */
     autoCuttingSpeakSpacing?: number | DataLink
+    /* Custom getUserMedia audio options for Web / Desktop. Merged into the audio constraints. */
+    userMediaAudioOptions?:
+      | DataLink
+      | {
+          autoGainControl?: boolean | DataLink
+          echoCancellation?: boolean | DataLink
+          noiseSuppression?: boolean | DataLink
+        }
   }
   events?: {
     /* Event for chunk data (Base64 encoded PCM) */

package/types/generators/{SpeechToTextGgml.ts → SpeechToTextGgml.d.ts}

@@ -7,6 +7,8 @@
  *  - macOS: Supported GPU acceleration, recommended use M1+ chip device
  *  - Android: Currently not supported GPU acceleration (Coming soon), recommended use Android 13+ system
  *  - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
+ *  - Web: Supported with WASM CPU and optional WebGPU acceleration in Web Preview.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -389,7 +391,9 @@ Default property:
  - iOS: Supported GPU acceleration, recommended use M1+ / A17+ chip device  
  - macOS: Supported GPU acceleration, recommended use M1+ chip device  
  - Android: Currently not supported GPU acceleration (Coming soon), recommended use Android 13+ system  
- - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property */
+ - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property  
+ - Web: Supported with WASM CPU and optional WebGPU acceleration in Web Preview.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorSpeechInference = Generator &
   GeneratorSpeechInferenceDef & {
     templateKey: 'GENERATOR_SPEECH_INFERENCE'

package/types/generators/{SttAppleBuiltin.ts → SttAppleBuiltin.d.ts}

@@ -1,13 +1,13 @@
 /* Auto generated by build script
  *
- * Speech recognition on iOS 26+ (Not supported on tvOS)
+ * Speech recognition on iOS 26+ and Desktop (macOS 26+). Not supported on tvOS
  *
  *  ## Features
  *  - Native Apple speech recognition
  *  - High accuracy transcription
  *  - Privacy-focused on-device processing
  *  - Supports file and data transcription
- *  - Requires iOS 26+ (Not supported on tvOS)
+ *  - Requires iOS 26+ or Desktop on macOS 26+. Not supported on tvOS
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -41,6 +41,11 @@ export type GeneratorAppleSTTActionTranscribeFile = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'contextualStrings'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
   >
 }
 
@@ -58,15 +63,26 @@ export type GeneratorAppleSTTActionTranscribeData = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'contextualStrings'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
   >
 }
 
+/* Release context */
+export type GeneratorAppleSTTActionReleaseContext = Action & {
+  __actionName: 'GENERATOR_APPLE_STT_RELEASE_CONTEXT'
+}
+
 interface GeneratorAppleSTTDef {
   /*
 Default property:
 {
   "init": false,
   "language": "en-US",
+  "contextualStrings": [],
   "enablePartialResults": true
 }
   */
@@ -75,6 +91,13 @@ Default property:
     init?: boolean | DataLink
     /* Language/locale for recognition (e.g., 'en-US') */
     language?: string | DataLink
+    /* Phrases that should be recognized, even if they are not in the system vocabulary. */
+    contextualStrings?:
+      | Array<string | DataLink>
+      | DataLink
+      | Record<string, Array<string | DataLink> | DataLink>
+      | DataLink
+      | DataLink
     /* Enable partial results during transcription */
     enablePartialResults?: boolean | DataLink
     /* The file URL or path to be transcribed */
@@ -100,14 +123,14 @@ Default property:
   }
 }
 
-/* Speech recognition on iOS 26+ (Not supported on tvOS)
+/* Speech recognition on iOS 26+ and Desktop (macOS 26+). Not supported on tvOS
 
  ## Features  
  - Native Apple speech recognition  
  - High accuracy transcription  
  - Privacy-focused on-device processing  
  - Supports file and data transcription  
- - Requires iOS 26+ (Not supported on tvOS) */
+ - Requires iOS 26+ or Desktop on macOS 26+. Not supported on tvOS */
 export type GeneratorAppleSTT = Generator &
   GeneratorAppleSTTDef & {
     templateKey: 'GENERATOR_APPLE_STT'

package/types/generators/{VadGgml.ts → VadGgml.d.ts}

@@ -1,6 +1,11 @@
 /* Auto generated by build script
  *
- * Local Voice Activity Detection (VAD) inference based on GGML and [whisper.rn](https://github.com/mybigday/whisper.rn)
+ * Local Voice Activity Detection (VAD) inference based on GGML and [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
+ *
+ *  ## Notice
+ *  - Web: Supported with WASM CPU in Web Preview.
+ *    - WebGPU is not used for browser VAD; the wasm package falls back to CPU for the VAD graph.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -222,7 +227,12 @@ Default property:
   }
 }
 
-/* Local Voice Activity Detection (VAD) inference based on GGML and [whisper.rn](https://github.com/mybigday/whisper.rn) */
+/* Local Voice Activity Detection (VAD) inference based on GGML and [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
+
+ ## Notice  
+ - Web: Supported with WASM CPU in Web Preview.  
+   - WebGPU is not used for browser VAD; the wasm package falls back to CPU for the VAD graph.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorVadInference = Generator &
   GeneratorVadInferenceDef & {
     templateKey: 'GENERATOR_VAD_INFERENCE'

package/package.json.bak

@@ -1,28 +0,0 @@
-{
-  "name": "@fugood/bricks-ctor",
-  "version": "2.24.5",
-  "main": "index.ts",
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "build": "bun scripts/build.js"
-  },
-  "dependencies": {
-    "@fugood/bricks-cli": "^2.24.5",
-    "@huggingface/gguf": "^0.3.2",
-    "@iarna/toml": "^3.0.0",
-    "@modelcontextprotocol/sdk": "^1.15.0",
-    "@toon-format/toon": "^2.1.0",
-    "@types/bun": "^1.3.9",
-    "@types/escodegen": "^0.0.10",
-    "@types/lodash": "^4.17.12",
-    "acorn": "^8.13.0",
-    "escodegen": "2.1.0",
-    "fuse.js": "^7.0.0",
-    "json5": "^2.0.1",
-    "lodash": "^4.17.4",
-    "uuid": "^8.3.1"
-  },
-  "peerDependencies": {
-    "oxfmt": "^0.36.0"
-  }
-}