@fugood/bricks-project 2.21.11 → 2.21.13

package/compile/action-name-map.ts

@@ -713,6 +713,11 @@ export const templateActionNameMap = {
     },
   },
   GENERATOR_QNN_LLM: {
+    GENERATOR_QNN_LLM_PROCESS: {
+      prompt: 'GENERATOR_QNN_LLM_PROMPT',
+      messages: 'GENERATOR_QNN_LLM_MESSAGES',
+      tools: 'GENERATOR_QNN_LLM_TOOLS',
+    },
     GENERATOR_QNN_LLM_GENERATE: {
       prompt: 'GENERATOR_QNN_LLM_PROMPT',
       messages: 'GENERATOR_QNN_LLM_MESSAGES',
@@ -739,6 +744,19 @@ export const templateActionNameMap = {
       text: 'GENERATOR_OPENAI_TTS_TEXT',
     },
   },
+  GENERATOR_ANTHROPIC_LLM: {
+    GENERATOR_ANTHROPIC_LLM_COMPLETION: {
+      systemMessage: 'GENERATOR_ANTHROPIC_LLM_SYSTEM_MESSAGE',
+      messages: 'GENERATOR_ANTHROPIC_LLM_MESSAGES',
+      maxTokens: 'GENERATOR_ANTHROPIC_LLM_MAX_TOKENS',
+      temperature: 'GENERATOR_ANTHROPIC_LLM_TEMPERATURE',
+      topP: 'GENERATOR_ANTHROPIC_LLM_TOP_P',
+      topK: 'GENERATOR_ANTHROPIC_LLM_TOP_K',
+      stopSequences: 'GENERATOR_ANTHROPIC_LLM_STOP_SEQUENCES',
+      tools: 'GENERATOR_ANTHROPIC_LLM_TOOLS',
+      toolChoice: 'GENERATOR_ANTHROPIC_LLM_TOOL_CHOICE',
+    },
+  },
   GENERATOR_ASSISTANT: {
     GENERATOR_ASSISTANT_ADD_MESSAGE: {
       role: 'GENERATOR_ASSISTANT_ROLE',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.21.11",
+  "version": "2.21.13",
   "main": "index.ts",
   "scripts": {
     "build": "node scripts/build.js"

package/types/generators.ts

@@ -1929,9 +1929,10 @@ interface GeneratorBleCentralDef {
 Default property:
 {
   "init": false,
-  "scanTime": 0,
-  "updateInterval": 100,
+  "scanTime": 10,
+  "updateInterval": 1000,
   "retainTime": 120,
+  "maximumDiscoveredDevice": 256,
   "allowDuplicates": false,
   "scanMode": "LowPower"
 }
@@ -4671,6 +4672,8 @@ Default property:
 }
   */
   property?: {
+    /* Application-scoped generator key, key cannot be the same with other application-scoped generators */
+    globalGeneratorKey?: string | DataLink
     /* Initialize the MCP client on start */
     init?: boolean | DataLink
     /* Type of the MCP connection, e.g. sse or direct-link (generator) */
@@ -6626,6 +6629,10 @@ Default property:
     cacheKType?: 'f16' | 'f32' | 'q8_0' | 'q4_0' | 'q4_1' | 'iq4_nl' | 'q5_0' | 'q5_1' | DataLink
     /* KV cache data type for the V (Default: f16) */
     cacheVType?: 'f16' | 'f32' | 'q8_0' | 'q4_0' | 'q4_1' | 'iq4_nl' | 'q5_0' | 'q5_1' | DataLink
+    /* Use a unified buffer across the input sequences when computing the attention */
+    useKVUnified?: boolean | DataLink
+    /* Use full-size SWA cache. May improve performance for multiple sequences but uses more memory. */
+    useSwaFull?: boolean | DataLink
     /* Enable context shift */
     ctxShift?: boolean | DataLink
     /* Enable Transform Script for processing the prompt */
@@ -6869,7 +6876,7 @@ Default property:
   "completionTopK": 40,
   "completionTopP": 0.9,
   "completionMinP": 0.05,
-  "useGuideToken": false,
+  "useGuideToken": true,
   "contextSize": 8192,
   "batchSize": 8192,
   "microBatchSize": 512,
@@ -7146,6 +7153,28 @@ export type GeneratorQnnLlmActionAbortModelDownload = Action & {
   __actionName: 'GENERATOR_QNN_LLM_ABORT_MODEL_DOWNLOAD'
 }
 
+/* Pre-process the prompt, to prepare KV cache */
+export type GeneratorQnnLlmActionProcess = ActionWithParams & {
+  __actionName: 'GENERATOR_QNN_LLM_PROCESS'
+  params?: Array<
+    | {
+        input: 'prompt'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'messages'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'tools'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
 /* Generate text */
 export type GeneratorQnnLlmActionGenerate = ActionWithParams & {
   __actionName: 'GENERATOR_QNN_LLM_GENERATE'
@@ -7188,6 +7217,10 @@ Default property:
   "toolCallParser": "llama3_json",
   "toolChoice": "auto",
   "parallelToolCalls": false,
+  "temperature": 0.8,
+  "seed": 42,
+  "topK": 40,
+  "topP": 0.95,
   "greedy": false
 }
   */
@@ -7208,10 +7241,10 @@ Default property:
     /* SOC model */
     socModel?: 'X Elite' | 'X Plus' | '8 Elite' | '8 Gen 3' | 'QCS8550' | DataLink
     /* Custom model base URL  
- The URL directory should contain `config.json` (model config) file, `model_part_*_of_*.bin` (model split files) files and `tokenizer.json` (tokenizer config) file. */
+ The model should be bundled, for details see https://github.com/mybigday/node-qnn-llm?tab=readme-ov-file#bundled-file */
     customModelUrl?: string | DataLink
-    /* Custom model split parts */
-    customModelSplitParts?: number | DataLink
+    /* Custom model MD5 */
+    customModelMd5?: string | DataLink
     /* Chat format */
     chatFormat?:
       | 'Llama 2'
@@ -7607,6 +7640,184 @@ export type GeneratorOpenAiTTS = Generator &
     >
   }
 
+/* Run text completion */
+export type GeneratorAnthropicLLMActionCompletion = ActionWithParams & {
+  __actionName: 'GENERATOR_ANTHROPIC_LLM_COMPLETION'
+  params?: Array<
+    | {
+        input: 'systemMessage'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'messages'
+        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: 'topK'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'stopSequences'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'tools'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'toolChoice'
+        value?: {} | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+/* Stop text completion */
+export type GeneratorAnthropicLLMActionStopCompletion = Action & {
+  __actionName: 'GENERATOR_ANTHROPIC_LLM_STOP_COMPLETION'
+}
+
+interface GeneratorAnthropicLLMDef {
+  /*
+Default property:
+{
+  "apiEndpoint": "https://api.anthropic.com/v1/messages",
+  "model": "claude-3-5-sonnet-20241022",
+  "systemMessage": "You are a helpful assistant.",
+  "completionMessages": [],
+  "completionMaxTokens": 1024,
+  "completionTemperature": 1,
+  "completionTopP": 1,
+  "completionStopSequences": []
+}
+  */
+  property?: {
+    /* API endpoint URL */
+    apiEndpoint?: string | DataLink
+    /* API key */
+    apiKey?: string | DataLink
+    /* Model name (Default: claude-3-5-sonnet-20241022) */
+    model?: string | DataLink
+    /* System message content */
+    systemMessage?: string | DataLink
+    /* Chat messages (user/assistant only) */
+    completionMessages?:
+      | Array<
+          | DataLink
+          | {
+              role?: 'user' | 'assistant' | DataLink
+              content?:
+                | string
+                | DataLink
+                | Array<
+                    | DataLink
+                    | {
+                        type?: 'text' | 'image' | DataLink
+                        text?: string | DataLink
+                        source?:
+                          | DataLink
+                          | {
+                              type?: string | DataLink
+                              media_type?: string | DataLink
+                              data?: string | DataLink
+                            }
+                      }
+                  >
+                | DataLink
+                | DataLink
+            }
+        >
+      | DataLink
+    /* Tools for function calling following Anthropic format  
+ Format: Array of objects with {name, description, input_schema} structure  
+ See: https://docs.anthropic.com/en/docs/tool-use */
+    completionTools?: Array<{} | DataLink> | DataLink
+    /* Tool choice for function calling */
+    completionToolChoice?:
+      | DataLink
+      | {
+          type?: 'auto' | 'any' | 'tool' | DataLink
+          name?: string | DataLink
+        }
+    /* Maximum tokens to generate */
+    completionMaxTokens?: number | DataLink
+    /* Temperature */
+    completionTemperature?: number | DataLink
+    /* Top P sampling */
+    completionTopP?: number | DataLink
+    /* Top K sampling */
+    completionTopK?: number | DataLink
+    /* Stop sequences */
+    completionStopSequences?: Array<string | DataLink> | DataLink
+  }
+  events?: {
+    /* Error event */
+    onError?: Array<EventAction>
+    /* Completion event */
+    onCompletion?: Array<EventAction>
+    /* Completion finished event */
+    onCompletionFinished?: Array<EventAction>
+    /* Tool use event */
+    onToolUse?: Array<EventAction>
+  }
+  outlets?: {
+    /* Evaluating outlet */
+    isEvaluating?: () => Data
+    /* Completion result outlet */
+    completionResult?: () => Data
+    /* Completion details outlet */
+    completionDetails?: () => Data
+  }
+}
+
+/* LLM inference using Anthropic-compatible API endpoints  
+
+ ## Features  
+ - Compatible with Anthropic API format  
+ - Supports function calling (tools)  
+ - Streaming responses  
+ - Custom API endpoints (Default to https://api.anthropic.com/v1/messages) */
+export type GeneratorAnthropicLLM = Generator &
+  GeneratorAnthropicLLMDef & {
+    templateKey: 'GENERATOR_ANTHROPIC_LLM'
+    switches: Array<
+      SwitchDef &
+        GeneratorAnthropicLLMDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet: 'isEvaluating' | 'completionResult' | 'completionDetails'
+                  value: any
+                }
+          }>
+        }
+    >
+  }
+
 /* Add a message to the assistant */
 export type GeneratorAssistantActionAddMessage = ActionWithParams & {
   __actionName: 'GENERATOR_ASSISTANT_ADD_MESSAGE'
@@ -8081,6 +8292,7 @@ Default property:
           | DataLink
           | {
               generatorId?: string | DataLink
+              generatorKey?: string | DataLink
               name?: string | DataLink
               enabled?: boolean | DataLink
             }

package/utils/event-props.ts

@@ -899,6 +899,23 @@ export const templateEventPropsMap = {
       'GENERATOR_OPENAI_TTS_ERROR', // type: string
     ],
   },
+  GENERATOR_ANTHROPIC_LLM: {
+    onError: [
+      'GENERATOR_ANTHROPIC_LLM_ERROR', // type: string
+    ],
+    onCompletion: [
+      'GENERATOR_ANTHROPIC_LLM_COMPLETION_RESULT', // type: string
+      'GENERATOR_ANTHROPIC_LLM_COMPLETION_DETAILS', // type: object
+    ],
+    onCompletionFinished: [
+      'GENERATOR_ANTHROPIC_LLM_COMPLETION_RESULT', // type: string
+      'GENERATOR_ANTHROPIC_LLM_TOOL_USES', // type: array
+    ],
+    onToolUse: [
+      'GENERATOR_ANTHROPIC_LLM_TOOL_USE_NAME', // type: string
+      'GENERATOR_ANTHROPIC_LLM_TOOL_USE_INPUT', // type: object
+    ],
+  },
   GENERATOR_ASSISTANT: {
     onError: [
       'GENERATOR_ASSISTANT_ERROR', // type: string