@fugood/bricks-project 2.22.0-beta.3 → 2.22.0-beta.4

package/compile/action-name-map.ts

@@ -512,6 +512,28 @@ export const templateActionNameMap = {
       paramsString: 'GENERATOR_SQLITE_PARAMS_STRING',
     },
   },
+
+  GENERATOR_MCP: {
+    GENERATOR_MCP_LIST_RESOURCES: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_LIST_RESOURCE_TEMPLATES: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_READ_RESOURCE: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+      uri: 'GENERATOR_MCP_URI',
+      variables: 'GENERATOR_MCP_VARIABLES',
+    },
+    GENERATOR_MCP_LIST_TOOLS: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_CALL_TOOL: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+      name: 'GENERATOR_MCP_NAME',
+      variables: 'GENERATOR_MCP_VARIABLES',
+    },
+  },
   GENERATOR_TTS: {
     GENERATOR_TTS_GENERATE: {
       text: 'GENERATOR_TTS_TEXT',
@@ -630,6 +652,11 @@ export const templateActionNameMap = {
       responseFormat: 'GENERATOR_OPENAI_LLM_RESPONSE_FORMAT',
     },
   },
+  GENERATOR_OPENAI_TTS: {
+    GENERATOR_OPENAI_TTS_GENERATE: {
+      text: 'GENERATOR_OPENAI_TTS_TEXT',
+    },
+  },
   GENERATOR_ASSISTANT: {
     GENERATOR_ASSISTANT_ADD_MESSAGE: {
       role: 'GENERATOR_ASSISTANT_ROLE',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.22.0-beta.3",
+  "version": "2.22.0-beta.4",
   "main": "index.ts",
   "scripts": {
     "build": "node scripts/build.js"
@@ -14,5 +14,5 @@
     "lodash": "^4.17.4",
     "uuid": "^8.3.1"
   },
-  "gitHead": "cbb283b7ce73520369f855f7fbe86e8e07b831eb"
+  "gitHead": "8a7f2856827423c67c0e26adcefbbc6e3ba6fc5c"
 }

package/types/generators.ts

@@ -4307,6 +4307,379 @@ export type GeneratorSqlite = Generator &
     >
   }
 
+/* Refresh tools and resources, used for case if tools or resources are changed */
+export type GeneratorMCPServerActionRefreshResources = Action & {
+  __actionName: 'GENERATOR_MCP_SERVER_REFRESH_RESOURCES'
+}
+
+/* End stream */
+export type GeneratorMCPServerActionEndStream = Action & {
+  __actionName: 'GENERATOR_MCP_SERVER_END_STREAM'
+}
+
+interface GeneratorMCPServerDef {
+  /*
+Default property:
+{
+  "enabled": true,
+  "listening": true,
+  "authType": "none",
+  "name": "bricks-foundation-mcp-server-default",
+  "version": "1.0.0",
+  "resources": [],
+  "tools": []
+}
+  */
+  property?: {
+    /* Enable MCP server. If enabled and Listening is false, the generator can still provide application-scoped resources. */
+    enabled?: boolean | DataLink
+    /* Start MCP server */
+    listening?: boolean | DataLink
+    /* HTTP server port */
+    port?: number | DataLink
+    /* Authorization type of HTTP request */
+    authType?: 'none' | 'bearer' | DataLink
+    /* Token of bearer auth */
+    bearerToken?: string | DataLink
+    /* Name of the MCP server */
+    name?: string | DataLink
+    /* Version of the MCP server */
+    version?: string | DataLink
+    /* Resources
+  Type:  
+  `static`: Return static data  
+  `detect-data-change`: Watch data target change to return data, 
+    please update data with ({ id: string, content: string | object }), 
+    and ensure the id is same with request id 
+  `script`: Not implemented yet */
+    resources?:
+      | Array<
+          | DataLink
+          | {
+              enabled?: boolean | DataLink
+              name?: string | DataLink
+              description?: string | DataLink
+              uriOrTemplate?: string | DataLink
+              type?: 'static' | 'detect-data-change' | 'script' | DataLink
+              staticData?: any
+              dataChangeConfig?:
+                | DataLink
+                | {
+                    target?: string | DataLink
+                    timeout?: number | DataLink
+                    payload?: any
+                  }
+              scriptConfig?:
+                | DataLink
+                | {
+                    code?: string | DataLink
+                    timeout?: number | DataLink
+                    members?:
+                      | Array<
+                          | DataLink
+                          | {
+                              handler?: string | DataLink
+                              varName?: string | DataLink
+                            }
+                        >
+                      | DataLink
+                    payload?: any
+                  }
+            }
+        >
+      | DataLink
+    /* Tools */
+    tools?:
+      | Array<
+          | DataLink
+          | {
+              enabled?: boolean | DataLink
+              name?: string | DataLink
+              description?: string | DataLink
+              params?: {} | DataLink
+              type?: 'detect-data-change' | 'script' | DataLink
+              dataChangeConfig?:
+                | DataLink
+                | {
+                    target?: string | DataLink
+                    timeout?: number | DataLink
+                    payload?: any
+                  }
+              scriptConfig?:
+                | DataLink
+                | {
+                    code?: string | DataLink
+                    timeout?: number | DataLink
+                    members?:
+                      | Array<
+                          | DataLink
+                          | {
+                              handler?: string | DataLink
+                              varName?: string | DataLink
+                            }
+                        >
+                      | DataLink
+                    payload?: any
+                  }
+            }
+        >
+      | DataLink
+  }
+  events?: {
+    /* Listening of HTTP server */
+    onListening?: Array<EventAction>
+    /* Error of HTTP server */
+    onError?: Array<EventAction>
+    /* Client error of HTTP server */
+    onClientError?: Array<EventAction>
+    /* Client close of HTTP server */
+    onClientClose?: Array<EventAction>
+    /* On request resource (Request: { name: string, uri: string, params: object }) */
+    onRequestResource?: Array<EventAction>
+    /* On call tool (Request: { name: string, params: object }) */
+    onCallTool?: Array<EventAction>
+  }
+  outlets?: {
+    /* Whether the HTTP server is listening */
+    isListening?: () => Data
+    /* Last error of HTTP server */
+    lastError?: () => Data
+    /* Connected remotes (Session ID) */
+    connectedRemotes?: () => Data
+    /* Last resource request ({ name: string, uri: string, params: object }) */
+    lastResourceRequest?: () => Data
+    /* Last tool call ({ name: string, params: object }) */
+    lastToolCall?: () => Data
+  }
+}
+
+/* Model Context Protocol (MCP) Server (https://docs.anthropic.com/en/docs/agents-and-tools/mcp) */
+export type GeneratorMCPServer = Generator &
+  GeneratorMCPServerDef & {
+    templateKey: 'GENERATOR_MCP_SERVER'
+    switches: Array<
+      SwitchDef &
+        GeneratorMCPServerDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet:
+                    | 'isListening'
+                    | 'lastError'
+                    | 'connectedRemotes'
+                    | 'lastResourceRequest'
+                    | 'lastToolCall'
+                  value: any
+                }
+          }>
+        }
+    >
+  }
+
+/* Connect to MCP server */
+export type GeneratorMCPActionConnect = Action & {
+  __actionName: 'GENERATOR_MCP_CONNECT'
+}
+
+/* Disconnect from MCP server */
+export type GeneratorMCPActionDisconnect = Action & {
+  __actionName: 'GENERATOR_MCP_DISCONNECT'
+}
+
+/* List resources */
+export type GeneratorMCPActionListResources = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_LIST_RESOURCES'
+  params?: Array<{
+    input: 'requestId'
+    value?: string | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* List resource templates */
+export type GeneratorMCPActionListResourceTemplates = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_LIST_RESOURCE_TEMPLATES'
+  params?: Array<{
+    input: 'requestId'
+    value?: string | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Read resource */
+export type GeneratorMCPActionReadResource = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_READ_RESOURCE'
+  params?: Array<
+    | {
+        input: 'requestId'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'uri'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'variables'
+        value?: {} | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+/* List tools */
+export type GeneratorMCPActionListTools = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_LIST_TOOLS'
+  params?: Array<{
+    input: 'requestId'
+    value?: string | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Call tool */
+export type GeneratorMCPActionCallTool = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_CALL_TOOL'
+  params?: Array<
+    | {
+        input: 'requestId'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'name'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'variables'
+        value?: {} | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+interface GeneratorMCPDef {
+  /*
+Default property:
+{
+  "init": false,
+  "type": "sse",
+  "url": "",
+  "generatorId": ""
+}
+  */
+  property?: {
+    /* Initialize the MCP client on start */
+    init?: boolean | DataLink
+    /* Type of the MCP connection, e.g. sse or direct-link (generator) */
+    type?: 'sse' | 'direct-link' | DataLink
+    /* URL of the MCP server, e.g. http://localhost:19853/sse */
+    url?: string | DataLink
+    /* SSE connection headers */
+    sseHeaders?: {} | DataLink
+    /* Send request headers */
+    sendHeaders?: {} | DataLink
+    /* Bearer token for authentication */
+    bearerToken?: string | DataLink
+    /* Generator MCPServer ID for direct link */
+    generatorId?: string | DataLink
+  }
+  events?: {
+    /* On connected */
+    onConnected?: Array<EventAction>
+    /* On connection error */
+    onConnectionError?: Array<EventAction>
+    /* On disconnected */
+    onDisconnected?: Array<EventAction>
+    /* On list resources */
+    onListResources?: Array<EventAction>
+    /* On list resources error */
+    onListResourcesError?: Array<EventAction>
+    /* On list resource templates */
+    onListResourceTemplates?: Array<EventAction>
+    /* On list resource templates error */
+    onListResourceTemplatesError?: Array<EventAction>
+    /* On read resource */
+    onReadResource?: Array<EventAction>
+    /* On read resource error */
+    onReadResourceError?: Array<EventAction>
+    /* On list tools */
+    onListTools?: Array<EventAction>
+    /* On list tools error */
+    onListToolsError?: Array<EventAction>
+    /* On call tool */
+    onCallTool?: Array<EventAction>
+    /* On call tool error */
+    onCallToolError?: Array<EventAction>
+  }
+  outlets?: {
+    /* Connection state */
+    connectionState?: () => Data
+    /* List resources response */
+    listResourcesResponse?: () => Data
+    /* List resources error */
+    listResourcesError?: () => Data
+    /* List resource templates response */
+    listResourceTemplatesResponse?: () => Data
+    /* List resource templates error */
+    listResourceTemplatesError?: () => Data
+    /* Read resource response */
+    readResourceResponse?: () => Data
+    /* Read resource error */
+    readResourceError?: () => Data
+    /* List tools response */
+    listToolsResponse?: () => Data
+    /* List tools error */
+    listToolsError?: () => Data
+    /* Call tool response */
+    callToolResponse?: () => Data
+    /* Call tool error */
+    callToolError?: () => Data
+    /* Last error */
+    lastError?: () => Data
+  }
+}
+
+/* Model Context Protocol (MCP) Client, support SSE and Generator MCPServer direct link */
+export type GeneratorMCP = Generator &
+  GeneratorMCPDef & {
+    templateKey: 'GENERATOR_MCP'
+    switches: Array<
+      SwitchDef &
+        GeneratorMCPDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet:
+                    | 'connectionState'
+                    | 'listResourcesResponse'
+                    | 'listResourcesError'
+                    | 'listResourceTemplatesResponse'
+                    | 'listResourceTemplatesError'
+                    | 'readResourceResponse'
+                    | 'readResourceError'
+                    | 'listToolsResponse'
+                    | 'listToolsError'
+                    | 'callToolResponse'
+                    | 'callToolError'
+                    | 'lastError'
+                  value: any
+                }
+          }>
+        }
+    >
+  }
+
 /* Load the model */
 export type GeneratorTTSActionLoadModel = Action & {
   __actionName: 'GENERATOR_TTS_LOAD_MODEL'
@@ -6106,6 +6479,104 @@ export type GeneratorOpenAILLM = Generator &
     >
   }
 
+/* Generate audio */
+export type GeneratorOpenAiTTSActionGenerate = ActionWithParams & {
+  __actionName: 'GENERATOR_OPENAI_TTS_GENERATE'
+  params?: Array<{
+    input: 'text'
+    value?: string | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Clean cache */
+export type GeneratorOpenAiTTSActionCleanCache = Action & {
+  __actionName: 'GENERATOR_OPENAI_TTS_CLEAN_CACHE'
+}
+
+interface GeneratorOpenAiTTSDef {
+  /*
+Default property:
+{
+  "apiEndpoint": "https://api.openai.com/v1",
+  "model": "tts-1",
+  "voice": "alloy",
+  "speed": 1,
+  "outputType": "play",
+  "playbackVolume": 100,
+  "cacheGenerated": true,
+  "autoInferEnable": false,
+  "softBreakRegex": "^[^\\r\\n\\t\\f\\v]*([\\r\\n]+|[。！？!?.]\\B)",
+  "hardBreakTime": 500
+}
+  */
+  property?: {
+    /* API endpoint URL */
+    apiEndpoint?: string | DataLink
+    /* OpenAI API Key */
+    apiKey?: string | DataLink
+    /* OpenAI TTS model */
+    model?: string | DataLink
+    /* Voice to use  
+ Select voice from https://openai.fm , default alloy */
+    voice?: string | DataLink
+    /* Additional instructions for the speech generation */
+    instructions?: string | DataLink
+    /* Speed of the generated audio */
+    speed?: number | DataLink
+    /* Output mode */
+    outputType?: 'play' | 'file' | DataLink
+    /* Playback volume (0 - 100) */
+    playbackVolume?: number | DataLink
+    /* Enable cache for generated audio */
+    cacheGenerated?: boolean | DataLink
+    /* Text to generate */
+    prompt?: string | DataLink
+    /* Auto inference when prompt changes */
+    autoInferEnable?: boolean | DataLink
+    /* Segmentation rule for auto inference */
+    softBreakRegex?: string | DataLink
+    /* Time to force inference when softBreakRegex is not satisfied */
+    hardBreakTime?: number | DataLink
+  }
+  events?: {
+    /* Event triggered when state change */
+    onContextStateChange?: Array<EventAction>
+    /* Event triggered when error occurs */
+    onError?: Array<EventAction>
+  }
+  outlets?: {
+    /* Context state */
+    contextState?: () => Data
+    /* Generated audio file */
+    generatedAudio?: () => Data
+    /* Generated audio file is playing */
+    generatedAudioPlaying?: () => Data
+  }
+}
+
+/* Generate speech from text using OpenAI's Text-to-Speech API */
+export type GeneratorOpenAiTTS = Generator &
+  GeneratorOpenAiTTSDef & {
+    templateKey: 'GENERATOR_OPENAI_TTS'
+    switches: Array<
+      SwitchDef &
+        GeneratorOpenAiTTSDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet: 'contextState' | 'generatedAudio' | 'generatedAudioPlaying'
+                  value: any
+                }
+          }>
+        }
+    >
+  }
+
 /* Add a message to the assistant */
 export type GeneratorAssistantActionAddMessage = ActionWithParams & {
   __actionName: 'GENERATOR_ASSISTANT_ADD_MESSAGE'

package/utils/event-props.ts

@@ -615,6 +615,71 @@ export const templateEventPropsMap = {
       'GENERATOR_SQLITE_QUERY_RESULT', // type: array
     ],
   },
+  GENERATOR_MCP_SERVER: {
+    onError: [
+      'GENERATOR_MCP_SERVER_ERROR_MESSAGE', // type: string
+    ],
+    onClientError: [
+      'GENERATOR_MCP_SERVER_CLIENT_ADDRESS', // type: string
+      'GENERATOR_MCP_SERVER_SESSION_ID', // type: string
+      'GENERATOR_MCP_SERVER_ERROR_MESSAGE', // type: string
+    ],
+    onClientClose: [
+      'GENERATOR_MCP_SERVER_CLIENT_ADDRESS', // type: string
+      'GENERATOR_MCP_SERVER_SESSION_ID', // type: string
+    ],
+    onRequestResource: [
+      'GENERATOR_MCP_SERVER_REQUEST', // type: object
+    ],
+    onCallTool: [
+      'GENERATOR_MCP_SERVER_REQUEST', // type: object
+    ],
+  },
+  GENERATOR_MCP: {
+    onConnectionError: [
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+    onListResources: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_RESPONSE', // type: object
+    ],
+    onListResourcesError: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+    onListResourceTemplates: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_RESPONSE', // type: object
+    ],
+    onListResourceTemplatesError: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+    onReadResource: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_RESPONSE', // type: object
+    ],
+    onReadResourceError: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+    onListTools: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_RESPONSE', // type: object
+    ],
+    onListToolsError: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+    onCallTool: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_RESPONSE', // type: object
+    ],
+    onCallToolError: [
+      'GENERATOR_MCP_REQUEST_ID', // type: string
+      'GENERATOR_MCP_ERROR_MESSAGE', // type: string
+    ],
+  },
   GENERATOR_TTS: {
     onContextStateChange: [
       'GENERATOR_TTS_CONTEXT_STATE', // type: string
@@ -699,6 +764,14 @@ export const templateEventPropsMap = {
       'GENERATOR_OPENAI_LLM_COMPLETION_FUNCTION_ARGUMENTS', // type: string
     ],
   },
+  GENERATOR_OPENAI_TTS: {
+    onContextStateChange: [
+      'GENERATOR_OPENAI_TTS_CONTEXT_STATE', // type: string
+    ],
+    onError: [
+      'GENERATOR_OPENAI_TTS_ERROR', // type: string
+    ],
+  },
   GENERATOR_ASSISTANT: {
     onError: [
       'GENERATOR_ASSISTANT_ERROR', // type: string