@fugood/bricks-project 2.23.2 → 2.23.4

package/tools/mcp-tools/lottie.ts

@@ -0,0 +1,102 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import * as TOON from '@toon-format/toon'
+
+const LOTTIEFILES_API_URL = 'https://lottiefiles.com/api'
+
+export function register(server: McpServer) {
+  server.tool(
+    'lottie_search',
+    {
+      query: z.string().describe('Search keywords for animations'),
+      page: z.number().min(1).optional().default(1),
+      limit: z.number().min(1).max(100).optional().default(10),
+    },
+    async ({ query, page, limit }) => {
+      try {
+        const url = new URL(`${LOTTIEFILES_API_URL}/search/get-animations`)
+        url.searchParams.set('query', query)
+        url.searchParams.set('page', String(page))
+        url.searchParams.set('limit', String(limit))
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+        const animations = data?.data?.data ?? []
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: TOON.encode({ count: animations.length, animations }),
+            },
+          ],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to search animations: ${err.message}` }],
+        }
+      }
+    },
+  )
+
+  server.tool(
+    'lottie_get_details',
+    {
+      id: z.string().describe('Animation file ID'),
+    },
+    async ({ id }) => {
+      try {
+        const url = new URL(`${LOTTIEFILES_API_URL}/animations/get-animation-data`)
+        url.searchParams.set('fileId', id)
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+
+        return {
+          content: [{ type: 'text', text: TOON.encode(data) }],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to get animation: ${err.message}` }],
+        }
+      }
+    },
+  )
+
+  server.tool(
+    'lottie_popular',
+    {
+      page: z.number().min(1).optional().default(1),
+      limit: z.number().min(1).max(100).optional().default(10),
+    },
+    async ({ page, limit }) => {
+      try {
+        const url = new URL(
+          `${LOTTIEFILES_API_URL}/iconscout/popular-animations-weekly?api=%26sort%3Dpopular`,
+        )
+        url.searchParams.set('page', String(page))
+        url.searchParams.set('limit', String(limit))
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+        const animations = data?.popularWeeklyData?.data ?? []
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: TOON.encode({ count: animations.length, animations }),
+            },
+          ],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to get popular animations: ${err.message}` }],
+        }
+      }
+    },
+  )
+}

package/tools/mcp-tools/media.ts

@@ -0,0 +1,110 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import { $ } from 'bun'
+
+const runBricks = async (projectDir: string, ...args: string[]) => {
+  try {
+    return await $`bunx bricks ${args}`.cwd(projectDir).text()
+  } catch (err: any) {
+    throw new Error(err.stderr?.toString() || err.message)
+  }
+}
+
+export function register(server: McpServer, projectDir: string) {
+  server.tool('media_boxes', {}, async () => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'boxes')
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to list media boxes: ${err.message}` }] }
+    }
+  })
+
+  server.tool('media_get_box', { id: z.string().describe('Media box ID') }, async ({ id }) => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'box', id)
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to get media box: ${err.message}` }] }
+    }
+  })
+
+  server.tool(
+    'media_files',
+    {
+      boxId: z.string().describe('Media box ID'),
+      types: z.string().describe('Comma-separated file types to include').optional(),
+      userTag: z.array(z.string()).describe('Filter by user tags').optional(),
+      limit: z.number().describe('Limit results').optional(),
+      offset: z.number().describe('Offset results').optional(),
+    },
+    async ({ boxId, types, userTag, limit, offset }) => {
+      try {
+        const args = ['media', 'files', boxId]
+        if (types) args.push('-t', types)
+        if (userTag) userTag.forEach((tag) => args.push('-u', tag))
+        if (limit != null) args.push('-l', String(limit))
+        if (offset != null) args.push('-o', String(offset))
+        const output = await runBricks(projectDir, ...args)
+        return { content: [{ type: 'text', text: output }] }
+      } catch (err: any) {
+        return { content: [{ type: 'text', text: `Failed to list media files: ${err.message}` }] }
+      }
+    },
+  )
+
+  server.tool('media_file', { id: z.string().describe('Media file ID') }, async ({ id }) => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'file', id)
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to get media file: ${err.message}` }] }
+    }
+  })
+
+  server.tool(
+    'media_upload_files',
+    {
+      boxId: z.string().describe('Target media box ID'),
+      files: z.array(z.string()).min(1).describe('File paths to upload'),
+      description: z.string().describe('File description').optional(),
+      userTags: z.array(z.string()).max(15).describe('User tags (max 15)').optional(),
+      imageVersion: z
+        .array(z.string())
+        .describe('Image resize specs as WxH or WxH:STRATEGY')
+        .optional(),
+      imageVersionType: z.enum(['jpg', 'png']).describe('Image output format').optional(),
+      enableAiAnalysis: z.boolean().describe('Enable AI analysis').optional(),
+      aiInstruction: z.string().describe('Custom AI analysis instruction').optional(),
+      concurrency: z.number().min(1).describe('Max concurrent uploads').optional(),
+    },
+    async ({
+      boxId,
+      files,
+      description,
+      userTags,
+      imageVersion,
+      imageVersionType,
+      enableAiAnalysis,
+      aiInstruction,
+      concurrency,
+    }) => {
+      try {
+        const args = ['media', 'upload', boxId, ...files]
+        if (description) args.push('-d', description)
+        if (userTags) userTags.forEach((tag) => args.push('-t', tag))
+        if (imageVersion) imageVersion.forEach((spec) => args.push('--image-version', spec))
+        if (imageVersionType) args.push('--image-version-type', imageVersionType)
+        if (enableAiAnalysis) args.push('--enable-ai-analysis')
+        if (aiInstruction) args.push('--ai-instruction', aiInstruction)
+        if (concurrency != null) args.push('--concurrency', String(concurrency))
+        const output = await runBricks(projectDir, ...args)
+        return { content: [{ type: 'text', text: output }] }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to upload media files: ${err.message}` }],
+        }
+      }
+    },
+  )
+}

package/tools/postinstall.ts

@@ -30,6 +30,10 @@ const projectMcpServer = {
   args: [`${cwd}/node_modules/@fugood/bricks-project/tools/mcp-server.ts`],
 }
 
+type CodexMcpConfig = {
+  mcp_servers: Record<string, typeof projectMcpServer>
+}
+
 const defaultMcpConfig = {
   mcpServers: {
     'bricks-project': projectMcpServer,
@@ -44,7 +48,7 @@ const handleMcpConfigOverride = async (mcpConfigPath: string) => {
       mcpConfig = JSON.parse(configStr)
       if (!mcpConfig?.mcpServers) throw new Error('mcpServers is not defined')
       mcpConfig.mcpServers['bricks-project'] = projectMcpServer
-    } catch (e) {
+    } catch {
       mcpConfig = defaultMcpConfig
     }
   } else {
@@ -104,21 +108,22 @@ if (hasAgentsMd) {
   }
 
   const handleCodexMcpConfigOverride = async (mcpConfigPath: string) => {
-    let mcpConfig: { mcp_servers: Record<string, typeof projectMcpServer> } | null = null
+    let mcpConfig: CodexMcpConfig | null = null
     if (await exists(mcpConfigPath)) {
       const configStr = await readFile(mcpConfigPath, 'utf-8')
       try {
-        mcpConfig = TOML.parse(configStr)
-        if (!mcpConfig?.mcp_servers) throw new Error('mcp_servers is not defined')
+        const parsed = TOML.parse(configStr) as Partial<CodexMcpConfig>
+        if (!parsed?.mcp_servers) throw new Error('mcp_servers is not defined')
+        mcpConfig = { mcp_servers: parsed.mcp_servers }
         mcpConfig.mcp_servers['bricks-project'] = projectMcpServer
-      } catch (e) {
+      } catch {
         mcpConfig = defaultCodexMcpConfig
       }
     } else {
       mcpConfig = defaultCodexMcpConfig
     }
 
-    await writeFile(mcpConfigPath, `${TOML.stringify(mcpConfig, null, 2)}\n`)
+    await writeFile(mcpConfigPath, `${TOML.stringify(mcpConfig)}\n`)
 
     console.log(`Updated ${mcpConfigPath}`)
   }

package/tools/pull.ts

@@ -2,6 +2,8 @@ import { $ } from 'bun'
 import { format } from 'prettier'
 
 const cwd = process.cwd()
+const args = process.argv.slice(2)
+const force = args.includes('--force') || args.includes('-f')
 
 // Check git status
 const { exitCode } = await $`cd ${cwd} && git status`.nothrow()
@@ -9,8 +11,15 @@ const isGitRepo = exitCode === 0
 
 if (isGitRepo) {
   const unstagedChanges = await $`cd ${cwd} && git diff --name-only --diff-filter=ACMR`.text()
-  if (unstagedChanges)
-    throw new Error('Unstaged changes found, please commit or stash your changes before pulling')
+  if (unstagedChanges) {
+    if (force) {
+      console.log('Force mode: committing unstaged changes before pull...')
+      await $`cd ${cwd} && git add .`
+      await $`cd ${cwd} && git commit -m ${'chore(force-pull): saved unstaged changes before pull'}`
+    } else {
+      throw new Error('Unstaged changes found, please commit or stash your changes before pulling')
+    }
+  }
 } else {
   const confirmContinue = prompt(
     'No git repository found, so it will not be safe to pull, continue? (y/n)',
@@ -25,6 +34,7 @@ const isModule = app.type === 'module'
 const command = isModule ? 'module' : 'app'
 
 // Fetch project files using CLI
+console.log(`Pulling ${command} project (${app.id})...`)
 const result = await $`bricks ${command} project-pull ${app.id} --json`.quiet().nothrow()
 
 if (result.exitCode !== 0) {
@@ -40,7 +50,8 @@ if (result.exitCode !== 0) {
 const { files, lastCommitId } = JSON.parse(result.stdout.toString())
 
 let useMain = false
-if (isGitRepo) {
+if (isGitRepo && !force) {
+  console.log(`Checking commit ${lastCommitId}...`)
   const found = (await $`cd ${cwd} && git rev-list -1 ${lastCommitId}`.nothrow().text())
     .trim()
     .match(/^[\da-f]{40}$/)
@@ -86,13 +97,18 @@ await Promise.all(
 
 if (isGitRepo) {
   await $`cd ${cwd} && git add .`
-  const commitMsg = isModule
-    ? 'chore(project): apply file changes from BRICKS module'
-    : 'chore(project): apply file changes from BRICKS application'
-  await $`cd ${cwd} && git commit -m ${commitMsg}`
-  if (!useMain) {
+  const hasChanges = !!(await $`cd ${cwd} && git diff --cached --name-only`.text()).trim()
+  if (hasChanges) {
+    let commitMsg = 'chore(project): apply file changes from BRICKS application'
+    if (force) commitMsg = `chore(force-pull): apply force pull-${command}`
+    else if (isModule) commitMsg = 'chore(project): apply file changes from BRICKS module'
+    await $`cd ${cwd} && git commit -m ${commitMsg}`
+  }
+  if (!force && !useMain) {
     await $`cd ${cwd} && git merge main`
   }
 }
 
-console.log(`${isModule ? 'Module' : 'App'} project pulled: ${files.length} files`)
+console.log(
+  `${isModule ? 'Module' : 'App'} project pulled: ${files.length} files${force ? ' (force)' : ''}`,
+)

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+  },
+  "exclude": ["node_modules"],
+}

package/types/bricks/Camera.ts

@@ -192,7 +192,7 @@ Default property:
 export type BrickCamera = Brick &
   BrickCameraDef & {
     templateKey: 'BRICK_CAMERA'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickCameraDef & {
           conds?: Array<{

package/types/bricks/Chart.ts

@@ -347,7 +347,7 @@ Default property:
 export type BrickChart = Brick &
   BrickChartDef & {
     templateKey: 'BRICK_CHART'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickChartDef & {
           conds?: Array<{

package/types/bricks/GenerativeMedia.ts

@@ -241,7 +241,7 @@ Default property:
 export type GenerativeMedia = Brick &
   GenerativeMediaDef & {
     templateKey: 'BRICK_GENERATIVE_MEDIA'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GenerativeMediaDef & {
           conds?: Array<{

package/types/bricks/Icon.ts

@@ -75,7 +75,7 @@ Default property:
 export type BrickIcon = Brick &
   BrickIconDef & {
     templateKey: 'BRICK_ICON'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickIconDef & {
           conds?: Array<{

package/types/bricks/Image.ts

@@ -91,7 +91,7 @@ Default property:
 export type BrickImage = Brick &
   BrickImageDef & {
     templateKey: 'BRICK_IMAGE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickImageDef & {
           conds?: Array<{

package/types/bricks/Items.ts

@@ -437,7 +437,7 @@ Default property:
 export type BrickItems = Brick &
   BrickItemsDef & {
     templateKey: 'BRICK_ITEMS'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickItemsDef & {
           conds?: Array<{

package/types/bricks/Lottie.ts

@@ -141,7 +141,7 @@ Default property:
 export type BrickLottie = Brick &
   BrickLottieDef & {
     templateKey: 'BRICK_LOTTIE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickLottieDef & {
           conds?: Array<{

package/types/bricks/Maps.ts

@@ -235,7 +235,7 @@ Default property:
 export type BrickMaps = Brick &
   BrickMapsDef & {
     templateKey: 'BRICK_MAPS'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickMapsDef & {
           conds?: Array<{

package/types/bricks/QrCode.ts

@@ -94,7 +94,7 @@ Default property:
 export type BrickQrcode = Brick &
   BrickQrcodeDef & {
     templateKey: 'BRICK_QRCODE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickQrcodeDef & {
           conds?: Array<{

package/types/bricks/Rect.ts

@@ -92,7 +92,7 @@ Default property:
 export type BrickRect = Brick &
   BrickRectDef & {
     templateKey: 'BRICK_RECT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickRectDef & {
           conds?: Array<{

package/types/bricks/RichText.ts

@@ -105,7 +105,7 @@ Default property:
 export type BrickRichText = Brick &
   BrickRichTextDef & {
     templateKey: 'BRICK_RICH_TEXT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickRichTextDef & {
           conds?: Array<{

package/types/bricks/Rive.ts

@@ -191,7 +191,7 @@ Default property:
 export type BrickRive = Brick &
   BrickRiveDef & {
     templateKey: 'BRICK_RIVE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickRiveDef & {
           conds?: Array<{

package/types/bricks/Slideshow.ts

@@ -172,7 +172,7 @@ Default property:
 export type BrickSlideshow = Brick &
   BrickSlideshowDef & {
     templateKey: 'BRICK_SLIDESHOW'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickSlideshowDef & {
           conds?: Array<{

package/types/bricks/Svg.ts

@@ -76,7 +76,7 @@ Default property:
 export type BrickSvg = Brick &
   BrickSvgDef & {
     templateKey: 'BRICK_SVG'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickSvgDef & {
           conds?: Array<{

package/types/bricks/Text.ts

@@ -125,7 +125,7 @@ Default property:
 export type BrickText = Brick &
   BrickTextDef & {
     templateKey: 'BRICK_TEXT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickTextDef & {
           conds?: Array<{

package/types/bricks/TextInput.ts

@@ -213,7 +213,7 @@ Default property:
 export type BrickTextInput = Brick &
   BrickTextInputDef & {
     templateKey: 'BRICK_TEXT_INPUT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickTextInputDef & {
           conds?: Array<{

package/types/bricks/Video.ts

@@ -152,7 +152,7 @@ Default property:
 export type BrickVideo = Brick &
   BrickVideoDef & {
     templateKey: 'BRICK_VIDEO'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickVideoDef & {
           conds?: Array<{

package/types/bricks/VideoStreaming.ts

@@ -89,7 +89,7 @@ Default property:
 export type BrickVideoStreaming = Brick &
   BrickVideoStreamingDef & {
     templateKey: 'BRICK_VIDEO_STREAMING'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickVideoStreamingDef & {
           conds?: Array<{

package/types/bricks/WebRtcStream.ts

@@ -42,7 +42,7 @@ Default property:
 export type BrickWebRTCStream = Brick &
   BrickWebRTCStreamDef & {
     templateKey: 'BRICK_WEBRTC_STREAM'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickWebRTCStreamDef & {
           conds?: Array<{

package/types/bricks/WebView.ts

@@ -145,7 +145,7 @@ Default property:
 export type BrickWebView = Brick &
   BrickWebViewDef & {
     templateKey: 'BRICK_WEBVIEW'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         BrickWebViewDef & {
           conds?: Array<{

package/types/canvas.ts

@@ -36,9 +36,9 @@ interface CanvasDef {
 export type Canvas = CanvasDef & {
   __typename: 'Canvas'
   id: string
-  title: string
+  title?: string
   description?: string
-  switches: Array<
+  switches?: Array<
     SwitchDef &
       CanvasDef & {
         conds?: Array<{

package/types/common.ts

@@ -7,8 +7,8 @@ export interface Brick {
   __typename: 'Brick'
   id: string
   templateKey: string
-  title: string
-  description: string
+  title?: string
+  description?: string
   property?: {}
   events: {}
   outlets?: {}
@@ -25,8 +25,8 @@ export interface Generator {
   __typename: 'Generator'
   id: string
   templateKey: string
-  title: string
-  description: string
+  title?: string
+  description?: string
   localSyncRunMode?: LocalSyncStrategy
   property?: {}
   events: {}

package/types/generators/AlarmClock.ts

@@ -85,7 +85,7 @@ Default property:
 export type GeneratorAlarmClock = Generator &
   GeneratorAlarmClockDef & {
     templateKey: 'GENERATOR_ALARM_CLOCK'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAlarmClockDef & {
           conds?: Array<{

package/types/generators/Assistant.ts

@@ -544,7 +544,7 @@ Default property:
 export type GeneratorAssistant = Generator &
   GeneratorAssistantDef & {
     templateKey: 'GENERATOR_ASSISTANT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAssistantDef & {
           conds?: Array<{

package/types/generators/BleCentral.ts

@@ -208,7 +208,7 @@ Default property:
 export type GeneratorBleCentral = Generator &
   GeneratorBleCentralDef & {
     templateKey: 'GENERATOR_BLE_CENTRAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBleCentralDef & {
           conds?: Array<{

package/types/generators/BlePeripheral.ts

@@ -185,7 +185,7 @@ Default property:
 export type GeneratorBlePeripheral = Generator &
   GeneratorBlePeripheralDef & {
     templateKey: 'GENERATOR_BLE_PERIPHERAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBlePeripheralDef & {
           conds?: Array<{

package/types/generators/CanvasMap.ts

@@ -51,7 +51,7 @@ Default property:
 export type GeneratorCanvasMap = Generator &
   GeneratorCanvasMapDef & {
     templateKey: 'GENERATOR_CANVAS_MAP'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCanvasMapDef & {
           conds?: Array<{

package/types/generators/CastlesPay.ts

@@ -60,7 +60,7 @@ Default property:
 export type GeneratorCastlesPay = Generator &
   GeneratorCastlesPayDef & {
     templateKey: 'GENERATOR_CASTLES_PAY'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCastlesPayDef & {
           conds?: Array<{

package/types/generators/DataBank.ts

@@ -106,7 +106,7 @@ Default property:
 export type GeneratorDataBank = Generator &
   GeneratorDataBankDef & {
     templateKey: 'GENERATOR_DATA_BANK'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorDataBankDef & {
           conds?: Array<{