@fugood/bricks-project 2.22.0-beta.26 → 2.22.0-beta.28

package/types/generators/MCP.ts

@@ -0,0 +1,294 @@
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
+import type { Data, DataLink } from '../data'
+import type {
+  Generator,
+  EventAction,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from '../common'
+
+/* 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
+      }
+  >
+}
+
+/* List prompts */
+export type GeneratorMCPActionListPrompts = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_LIST_PROMPTS'
+  params?: Array<{
+    input: 'requestId'
+    value?: string | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Request prompt */
+export type GeneratorMCPActionGetPrompt = ActionWithParams & {
+  __actionName: 'GENERATOR_MCP_GET_PROMPT'
+  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": "streamable-http",
+  "url": "",
+  "autoReconnect": true,
+  "maxReconnectAttempts": 10,
+  "reconnectInterval": 1000,
+  "generatorId": "",
+  "generatorKey": "",
+  "name": "bricks-foundation-mcp-client-default",
+  "version": "1.0.0",
+  "ignoreResourceInList": [],
+  "ignoreToolInList": [],
+  "ignorePromptInList": [],
+  "requestTimeout": 60000
+}
+  */
+  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) */
+    type?: 'streamable-http' | 'sse' | 'direct-link' | DataLink
+    /* URL of the MCP server, e.g. http://localhost:19853/sse */
+    url?: string | DataLink
+    /* Whether to automatically reconnect to the MCP server */
+    autoReconnect?: boolean | DataLink
+    /* Maximum number of reconnection attempts */
+    maxReconnectAttempts?: number | DataLink
+    /* Reconnection interval in milliseconds */
+    reconnectInterval?: number | DataLink
+    /* SSE connection headers */
+    sseHeaders?: {} | DataLink
+    /* Send request headers */
+    sendHeaders?: {} | DataLink
+    /* Bearer token for authentication */
+    bearerToken?: string | DataLink
+    /* Generator MCP Server ID for direct link */
+    generatorId?: string | DataLink
+    /* Application-scoped key of Generator MCP Server for direct link (If ID is not provided) */
+    generatorKey?: string | DataLink
+    /* Name of the MCP client */
+    name?: string | DataLink
+    /* Version of the MCP client */
+    version?: string | DataLink
+    /* Ignore resources in list response */
+    ignoreResourceInList?: Array<string | DataLink> | DataLink
+    /* Ignore tools in list response */
+    ignoreToolInList?: Array<string | DataLink> | DataLink
+    /* Ignore prompts in list response */
+    ignorePromptInList?: Array<string | DataLink> | DataLink
+    /* Request timeout in milliseconds */
+    requestTimeout?: number | 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>
+    /* On list prompts */
+    onListPrompts?: Array<EventAction>
+    /* On list prompts error */
+    onListPromptsError?: Array<EventAction>
+    /* On get prompt */
+    onGetPrompt?: Array<EventAction>
+    /* On get prompt error */
+    onGetPromptError?: 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
+    /* List prompts response */
+    listPromptsResponse?: () => Data
+    /* List prompts error */
+    listPromptsError?: () => Data
+    /* Get prompt response */
+    getPromptResponse?: () => Data
+    /* Request prompt error */
+    getPromptError?: () => 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'
+                    | 'listPromptsResponse'
+                    | 'listPromptsError'
+                    | 'getPromptResponse'
+                    | 'getPromptError'
+                    | 'lastError'
+                  value: any
+                }
+          }>
+        }
+    >
+  }

package/types/generators/MCPServer.ts

@@ -0,0 +1,245 @@
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
+import type { Data, DataLink } from '../data'
+import type {
+  Generator,
+  EventAction,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from '../common'
+
+/* Refresh tools and resources, used for case if tools or resources are changed. Note that the current connections will be closed. */
+export type GeneratorMCPServerActionRefreshResources = Action & {
+  __actionName: 'GENERATOR_MCP_SERVER_REFRESH_RESOURCES'
+}
+
+interface GeneratorMCPServerDef {
+  /*
+Default property:
+{
+  "enabled": true,
+  "listening": true,
+  "authType": "none",
+  "name": "bricks-foundation-mcp-server-default",
+  "version": "1.0.0",
+  "resources": [],
+  "tools": [],
+  "prompts": []
+}
+  */
+  property?: {
+    /* Enable MCP server. If enabled and Listening is false, the generator can still provide application-scoped resources. */
+    enabled?: boolean | DataLink
+    /* Application-scoped generator key, key cannot be the same with other application-scoped generators */
+    globalGeneratorKey?: string | 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`: Run a JavaScript code to return data  
+      - Script can define members to call generator functions  
+      - Script support async/await */
+    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
+                    additionalParams?: {} | DataLink
+                  }
+              scriptConfig?:
+                | DataLink
+                | {
+                    code?: string | DataLink
+                    timeout?: number | DataLink
+                    members?:
+                      | Array<
+                          | DataLink
+                          | {
+                              handler?: string | DataLink
+                              varName?: string | DataLink
+                            }
+                        >
+                      | DataLink
+                    additionalParams?: {} | DataLink
+                  }
+            }
+        >
+      | DataLink
+    /* Tools  
+    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`: Run a JavaScript code to return data  
+      - Script can define members to call generator functions  
+      - Script support async/await */
+    tools?:
+      | Array<
+          | DataLink
+          | {
+              enabled?: boolean | DataLink
+              name?: string | DataLink
+              description?: string | DataLink
+              params?: {} | DataLink
+              type?: 'static' | 'detect-data-change' | 'script' | DataLink
+              staticData?: any
+              dataChangeConfig?:
+                | DataLink
+                | {
+                    target?: string | DataLink
+                    timeout?: number | DataLink
+                    additionalParams?: {} | DataLink
+                  }
+              scriptConfig?:
+                | DataLink
+                | {
+                    code?: string | DataLink
+                    timeout?: number | DataLink
+                    members?:
+                      | Array<
+                          | DataLink
+                          | {
+                              handler?: string | DataLink
+                              varName?: string | DataLink
+                            }
+                        >
+                      | DataLink
+                    additionalParams?: {} | DataLink
+                  }
+            }
+        >
+      | DataLink
+    /* Prompts  
+    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`: Run a JavaScript code to return data  
+      - Script can define members to call generator functions  
+      - Script support async/await */
+    prompts?:
+      | Array<
+          | DataLink
+          | {
+              enabled?: boolean | DataLink
+              name?: string | DataLink
+              description?: string | DataLink
+              arguments?: {} | DataLink
+              type?: 'static' | 'detect-data-change' | 'script' | DataLink
+              staticData?: any
+              dataChangeConfig?:
+                | DataLink
+                | {
+                    target?: string | DataLink
+                    timeout?: number | DataLink
+                    additionalParams?: {} | DataLink
+                  }
+              scriptConfig?:
+                | DataLink
+                | {
+                    code?: string | DataLink
+                    timeout?: number | DataLink
+                    members?:
+                      | Array<
+                          | DataLink
+                          | {
+                              handler?: string | DataLink
+                              varName?: string | DataLink
+                            }
+                        >
+                      | DataLink
+                    additionalParams?: {} | DataLink
+                  }
+            }
+        >
+      | 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>
+    /* On get prompt (Request: { name: string, arguments: object }) */
+    onGetPrompt?: Array<EventAction>
+  }
+  outlets?: {
+    /* Whether the HTTP server is listening */
+    isListening?: () => Data
+    /* Last error of HTTP server */
+    lastError?: () => Data
+    /* MCP server endpoint URL */
+    endpoint?: () => 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
+    /* Last prompt get ({ name: string, arguments: object }) */
+    lastPromptGet?: () => 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'
+                    | 'endpoint'
+                    | 'connectedRemotes'
+                    | 'lastResourceRequest'
+                    | 'lastToolCall'
+                    | 'lastPromptGet'
+                  value: any
+                }
+          }>
+        }
+    >
+  }

package/types/generators/MQTTBroker.ts

@@ -0,0 +1,121 @@
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
+import type { Data, DataLink } from '../data'
+import type {
+  Generator,
+  EventAction,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from '../common'
+
+/* Start MQTT broker server */
+export type GeneratorMQTTBrokerActionStart = Action & {
+  __actionName: 'GENERATOR_MQTT_BROKER_START'
+}
+
+/* Publish message to topic */
+export type GeneratorMQTTBrokerActionPublish = ActionWithParams & {
+  __actionName: 'GENERATOR_MQTT_BROKER_PUBLISH'
+  params?: Array<
+    | {
+        input: 'topic'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'payload'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'messageId'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+/* Stop MQTT broker server */
+export type GeneratorMQTTBrokerActionStop = Action & {
+  __actionName: 'GENERATOR_MQTT_BROKER_STOP'
+}
+
+interface GeneratorMQTTBrokerDef {
+  /*
+Default property:
+{
+  "init": false,
+  "port": 1883,
+  "retryInterval": 5,
+  "keepalive": 60,
+  "authenticate": false
+}
+  */
+  property?: {
+    /* Start MQTT broker on generator initialized */
+    init?: boolean | DataLink
+    /* Bind port of MQTT server */
+    port?: number | DataLink
+    /* Retry interval when publish failed */
+    retryInterval?: number | DataLink
+    /* Keep-alive interval */
+    keepalive?: number | DataLink
+    /* Enable authentication */
+    authenticate?: boolean | DataLink
+    /* Authentication table */
+    authTable?:
+      | Array<
+          | DataLink
+          | {
+              username?: string | DataLink
+              password?: string | DataLink
+            }
+        >
+      | DataLink
+  }
+  events?: {
+    /* Event of MQTT server is ready */
+    onReady?: Array<EventAction>
+    /* Event of server or connection error */
+    onError?: Array<EventAction>
+    /* Event of client connected */
+    onClientConnected?: Array<EventAction>
+    /* Event of client disconnected */
+    onClientDisconnected?: Array<EventAction>
+    /* Event of message received */
+    onMessageReceived?: Array<EventAction>
+    /* Event of message published */
+    onMessagePublished?: Array<EventAction>
+  }
+  outlets?: {
+    /* Is server started */
+    started?: () => Data
+    /* Last received message */
+    lastMessage?: () => Data
+    /* Error message */
+    errorMessage?: () => Data
+  }
+}
+
+/* MQTT Broker server */
+export type GeneratorMQTTBroker = Generator &
+  GeneratorMQTTBrokerDef & {
+    templateKey: 'GENERATOR_MQTT_BROKER'
+    switches: Array<
+      SwitchDef &
+        GeneratorMQTTBrokerDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet: 'started' | 'lastMessage' | 'errorMessage'
+                  value: any
+                }
+          }>
+        }
+    >
+  }