@fugood/bricks-project 2.22.0-beta.2 → 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,11 +1,12 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.22.0-beta.2",
+  "version": "2.22.0-beta.4",
   "main": "index.ts",
   "scripts": {
     "build": "node scripts/build.js"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
     "@types/escodegen": "^0.0.10",
     "@types/lodash": "^4.17.12",
     "acorn": "^8.13.0",
@@ -13,5 +14,5 @@
     "lodash": "^4.17.4",
     "uuid": "^8.3.1"
   },
-  "gitHead": "a230efafdd33bc1dd02ed6397cf5741b318e172f"
+  "gitHead": "8a7f2856827423c67c0e26adcefbbc6e3ba6fc5c"
 }

package/tools/mcp-server.ts

@@ -0,0 +1,86 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { z } from 'zod'
+import { $ } from 'bun'
+
+const server = new McpServer({
+  name: 'bricks-project',
+  version: '1.0.0',
+})
+
+const dirname = import.meta.dirname
+const projectDir = String(dirname).split('/node_modules/')[0]
+
+server.tool('compile', {}, async () => {
+  let log
+  try {
+    log = await $`bun compile`.cwd(projectDir).text()
+  } catch (err) {
+    log = err.stdout.toString() + '\n' + err.stderr.toString()
+  }
+  return {
+    content: [{ type: 'text', text: log || 'Compiled successfully' }],
+  }
+})
+
+// NOTE: Cursor (Or VSCode) seems set ELECTRON_RUN_AS_NODE to 1, so we need to unset it
+process.env.ELECTRON_RUN_AS_NODE = ''
+
+server.tool(
+  'take-preview-screenshot',
+  {
+    delay: z
+      .number()
+      .describe('Delay in milliseconds before taking screenshot')
+      .optional()
+      .default(3000),
+    width: z.number().describe('Width of the screenshot').optional().default(600),
+    height: z.number().optional().default(480),
+    responseImage: z
+      .boolean()
+      .describe(
+        'Whether to response image content (base64 encoded jpeg). If false, only saved path will be responded as text.',
+      )
+      .optional()
+      .default(false),
+  } as any,
+  async ({ delay, width, height, responseImage }: any) => {
+    let log = ''
+    let error = false
+    try {
+      const args = [
+        '--take-screenshot',
+        JSON.stringify({
+          delay,
+          width,
+          height,
+          path: `${dirname}/screenshot.jpg`,
+          closeAfter: true,
+          headless: true,
+        }),
+      ]
+      log = await $`bunx --bun electron ${dirname}/preview-main.mjs ${args}`.cwd(projectDir).text()
+    } catch (err) {
+      log = err.stdout.toString() + '\n' + err.stderr.toString()
+      error = true
+    }
+    let screenshotBase64: any = null
+    if (!error && responseImage) {
+      const screenshot = await Bun.file(`${dirname}/screenshot.jpg`).arrayBuffer()
+      screenshotBase64 = Buffer.from(screenshot).toString('base64')
+    }
+    return {
+      content: [
+        { type: 'text', text: log },
+        screenshotBase64 && {
+          type: 'image',
+          data: screenshotBase64,
+          mimeType: 'image/jpeg',
+        },
+      ].filter(Boolean),
+    }
+  },
+)
+
+const transport = new StdioServerTransport()
+await server.connect(transport)

package/tools/postinstall.ts

@@ -1,5 +1,5 @@
 import { $ } from 'bun'
-
+import { stat, readFile, writeFile } from 'fs/promises'
 const cwd = process.cwd()
 
 const libFiles = ['types', 'utils', 'index.ts']
@@ -9,4 +9,56 @@ for (const file of libFiles) {
   await $`cp -r ${__dirname}/../${file} ${cwd}/project`
 }
 
-console.log('Copied files to project/')
+console.log('Copied files to project/')
+
+async function exists(f: string) {
+  try {
+    await stat(f)
+    return true
+  } catch {
+    return false
+  }
+}
+
+const projectMcpServer = {
+  command: 'bun',
+  args: [`${cwd}/node_modules/@fugood/bricks-project/tools/mcp-server.ts`],
+}
+
+const defaultMcpConfig = {
+  mcpServers: {
+    'bricks-project': projectMcpServer,
+  },
+}
+
+const handleMcpConfigOverride = async (mcpConfigPath: string) => {
+  let mcpConfig: { mcpServers: Record<string, typeof projectMcpServer> } | null = null
+  if (await exists(mcpConfigPath)) {
+    const configStr = await readFile(mcpConfigPath, 'utf-8')
+    try {
+      mcpConfig = JSON.parse(configStr)
+      if (!mcpConfig?.mcpServers) throw new Error('mcpServers is not defined')
+      mcpConfig.mcpServers['bricks-project'] = projectMcpServer
+    } catch (e) {
+      mcpConfig = defaultMcpConfig
+    }
+  } else {
+    mcpConfig = defaultMcpConfig
+  }
+
+  await writeFile(mcpConfigPath, `${JSON.stringify(mcpConfig, null, 2)}\n`)
+
+  console.log(`Updated ${mcpConfigPath}`)
+}
+
+if (await exists(`${cwd}/.cursorrules`)) {
+  await $`mkdir -p ${cwd}/.cursor`
+  const cursorMcpConfigPath = `${cwd}/.cursor/mcp.json`
+  await handleMcpConfigOverride(cursorMcpConfigPath)
+}
+
+if (await exists(`${cwd}/CLAUDE.md`)) {
+  await $`mkdir -p ${cwd}/.cursor`
+  const claudeCodeMcpConfigPath = `${cwd}/.mcp.json`
+  await handleMcpConfigOverride(claudeCodeMcpConfigPath)
+}

package/tools/preview-main.mjs

@@ -20,7 +20,7 @@ let takeScreenshotConfig = null
 try {
   if (values['take-screenshot']) {
     takeScreenshotConfig = JSON.parse(values['take-screenshot'])
-    if (!takeScreenshotConfig.path) takeScreenshotConfig.path = `${cwd}/screenshot.png`
+    if (!takeScreenshotConfig.path) takeScreenshotConfig.path = `${cwd}/screenshot.jpg`
     if (!takeScreenshotConfig.width) takeScreenshotConfig.width = 1280
     if (!takeScreenshotConfig.height) takeScreenshotConfig.height = 768
     if (!takeScreenshotConfig.delay) takeScreenshotConfig.delay = 1000
@@ -46,8 +46,13 @@ if (!previewUrl) throw new Error(`Invalid BRICKS_STAGE: ${stage}`)
 
 app.on('ready', () => {
   let show = true
-  if (takeScreenshotConfig?.headless) show = false
-  const mainWindow = new BrowserWindow({ width: 1280, height: 768, show })
+  if (takeScreenshotConfig && !takeScreenshotConfig.noHeadless) show = false
+  const mainWindow = new BrowserWindow({
+    width: takeScreenshotConfig?.width || 1280,
+    height: takeScreenshotConfig?.height || 768,
+    frame: !takeScreenshotConfig,
+    show,
+  })
   mainWindow.setBackgroundColor('#333')
   mainWindow.loadURL(previewUrl)
 
@@ -56,18 +61,19 @@ app.on('ready', () => {
       type: 'config',
       configFile: { _originTitle: 'Test', ...config, title: Math.random().toString() },
       workspace: { billing: { lock: {}, plan: 'free' } },
+      showMenu: false,
     }
     mainWindow.webContents.executeJavaScript(
       `window.postMessage(JSON.stringify(${JSON.stringify(payload)}))`,
     )
     if (takeScreenshotConfig) {
-      const { delay, width, height, path, closeAfter } = takeScreenshotConfig
+      const { delay, width, height, path, keepOpen = false } = takeScreenshotConfig
       setTimeout(() => {
         console.log('Taking screenshot')
-        mainWindow.webContents.capturePage({ width, height }).then((image) => {
+        mainWindow.webContents.capturePage().then((image) => {
           console.log('Writing screenshot to', path)
-          writeFile(path, image.toPNG())
-          if (closeAfter) {
+          writeFile(path, image.resize({ width, height }).toJPEG(75))
+          if (!keepOpen) {
             console.log('Closing app')
             app.quit()
           }

package/tools/preview.ts

@@ -1,5 +1,6 @@
 import { $ } from 'bun'
 import { watch } from 'fs'
+import type { FSWatcher } from 'fs'
 import { parseArgs } from 'util'
 import { debounce } from 'lodash'
 
@@ -8,55 +9,60 @@ const { values } = parseArgs({
   options: {
     'skip-typecheck': { type: 'boolean' },
     'clear-cache': { type: 'boolean' },
-    'screenshot': { type: 'boolean' },
+    screenshot: { type: 'boolean' },
     'screenshot-delay': { type: 'string' },
     'screenshot-width': { type: 'string' },
     'screenshot-height': { type: 'string' },
     'screenshot-path': { type: 'string' },
-    'screenshot-close-after': { type: 'boolean' },
-    'screenshot-headless': { type: 'boolean' },
+    'screenshot-keep-open': { type: 'boolean' },
+    'screenshot-no-headless': { type: 'boolean' },
   },
   strict: true,
   allowPositionals: true,
 })
 
-const useTypecheck = !values['skip-typecheck']
-
-const compile = async () => {
-  if (useTypecheck) await $`bun typecheck`
-  await $`bun compile`
-}
-
-await compile()
-
-const compileDebounced = debounce(compile, 500)
-
 const cwd = process.cwd()
 
-const watcher = watch(`${cwd}/subspaces`, { recursive: true }, async (event, filename) => {
-  console.log(`Detected ${event} in ${filename}`)
-  compileDebounced()
-})
-
 const app = await Bun.file(`${cwd}/application.json`).json()
 
 let args: string[] = []
 if (values['clear-cache']) args.push('--clear-cache')
 
+let needWatcher = true
 if (values['screenshot']) {
   args.push(`--take-screenshot`)
+  const keepOpen = values['screenshot-keep-open'] ?? false
   args.push(
     JSON.stringify({
       delay: Number(values['screenshot-delay']) || 1000,
-      width: Number(values['screenshot-width']) || 1920,
-      height: Number(values['screenshot-height']) || 1080,
-      path: values['screenshot-path'] || `${cwd}/screenshot.png`,
-      closeAfter: values['screenshot-close-after'] ?? true,
-      headless: values['screenshot-headless'] ?? true,
+      width: Number(values['screenshot-width']) || 600,
+      height: Number(values['screenshot-height']) || 480,
+      path: values['screenshot-path'] || `${cwd}/screenshot.jpg`,
+      keepOpen,
+      noHeadless: values['screenshot-no-headless'] ?? false,
     }),
   )
+  needWatcher = keepOpen
+}
+
+const useTypecheck = !values['skip-typecheck']
+
+const compile = async () => {
+  if (useTypecheck) await $`bun typecheck`
+  await $`bun compile`
+}
+
+await compile()
+
+let watcher: FSWatcher | null = null
+if (needWatcher) {
+  const compileDebounced = debounce(compile, 500)
+  watcher = watch(`${cwd}/subspaces`, { recursive: true }, async (event, filename) => {
+    console.log(`Detected ${event} in ${filename}`)
+    compileDebounced()
+  })
 }
 
 await $`BRICKS_STAGE=${app.stage || 'production'} bunx --bun electron ${__dirname}/preview-main.mjs ${args}`
 
-watcher.close()
+if (watcher) watcher.close()

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