@vibe-forge/mcp 0.8.0 → 0.9.0

package/AGENTS.md

@@ -34,6 +34,6 @@
 
 ## 相关文档
 
-- [架构说明](/Users/bytedance/projects/vibe-forge.ai/.ai/rules/docs/ARCHITECTURE.md)
-- [使用文档](/Users/bytedance/projects/vibe-forge.ai/.ai/rules/docs/USAGE.md)
+- [架构说明](/Users/bytedance/projects/vibe-forge.ai/.ai/rules/ARCHITECTURE.md)
+- [使用文档](/Users/bytedance/projects/vibe-forge.ai/.ai/rules/USAGE.md)
 - [CLI 维护说明](/Users/bytedance/projects/vibe-forge.ai/apps/cli/src/AGENTS.md)

package/__tests__/tools.spec.ts

@@ -1,11 +1,22 @@
-import { describe, expect, it } from 'vitest'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
-import { createMcpTools } from '#~/tools/index.js'
+import askUser from '#~/tools/interaction/ask-user.js'
 import wait from '#~/tools/general/wait.js'
+import { createMcpTools } from '#~/tools/index.js'
 
 import { createToolTester } from './mcp-test-utils.js'
 
 describe('mcp tools integration', () => {
+  beforeEach(() => {
+    process.env.__VF_PROJECT_AI_SESSION_ID__ = 'sess-1'
+    vi.stubGlobal('fetch', vi.fn())
+  })
+
+  afterEach(() => {
+    delete process.env.__VF_PROJECT_AI_SESSION_ID__
+    vi.unstubAllGlobals()
+  })
+
   it('registers task tools by default', () => {
     expect(createMcpTools()).toHaveProperty('task')
   })
@@ -46,4 +57,39 @@ describe('mcp tools integration', () => {
         .rejects.toThrow()
     })
   })
+
+  describe('AskUserQuestion tool', () => {
+    it('returns scalar answers as plain text content', async () => {
+      const tester = createToolTester()
+      askUser(tester.mockRegister)
+      vi.mocked(fetch).mockResolvedValue({
+        ok: true,
+        json: async () => ({ success: true, data: { result: '米饭' } })
+      } as Response)
+
+      const result = await tester.callTool('AskUserQuestion', {
+        question: '今晚吃了什么？',
+        options: [{ label: '米饭' }]
+      }) as any
+
+      expect(result.content).toEqual([{ type: 'text', text: '米饭' }])
+    })
+
+    it('returns multiselect answers as newline-separated text', async () => {
+      const tester = createToolTester()
+      askUser(tester.mockRegister)
+      vi.mocked(fetch).mockResolvedValue({
+        ok: true,
+        json: async () => ({ success: true, data: { result: ['米饭', '面条'] } })
+      } as Response)
+
+      const result = await tester.callTool('AskUserQuestion', {
+        question: '今晚吃了什么？',
+        options: [{ label: '米饭' }, { label: '面条' }],
+        multiselect: true
+      }) as any
+
+      expect(result.content).toEqual([{ type: 'text', text: '米饭\n面条' }])
+    })
+  })
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Vibe Forge MCP server",
   "imports": {
     "#~/*.js": {
@@ -33,13 +33,13 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "commander": "^12.1.0",
     "zod": "^3.24.1",
-    "@vibe-forge/cli-helper": "^0.8.0",
-    "@vibe-forge/config": "^0.8.0",
-    "@vibe-forge/register": "^0.8.0",
-    "@vibe-forge/hooks": "^0.8.0",
-    "@vibe-forge/task": "^0.8.0",
-    "@vibe-forge/utils": "^0.8.0",
-    "@vibe-forge/types": "^0.8.0"
+    "@vibe-forge/config": "^0.9.0",
+    "@vibe-forge/hooks": "^0.9.0",
+    "@vibe-forge/task": "^0.9.0",
+    "@vibe-forge/utils": "^0.9.0",
+    "@vibe-forge/types": "^0.9.0",
+    "@vibe-forge/cli-helper": "^0.9.0",
+    "@vibe-forge/register": "^0.9.0"
   },
   "scripts": {
     "test": "pnpm -C ../.. exec vitest run --workspace vitest.workspace.ts --project bundler packages/mcp/__tests__"

package/src/command.ts

@@ -4,9 +4,9 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import type { Command } from 'commander'
 
-import type { McpOptions } from './types'
 import { createMcpTools } from './tools'
 import { createFilteredRegister, shouldEnableCategory } from './tools/proxy'
+import type { McpOptions } from './types'
 
 export const configureMcpCommand = (command: Command, version: string) => (
   command

package/src/tools/index.ts

@@ -1,7 +1,7 @@
 import wait from './general/wait'
 import askUser from './interaction/ask-user'
-import type { Register } from './types'
 import { createTaskRegister } from './task'
+import type { Register } from './types'
 
 export const createMcpTools = (): Record<string, Register> => ({
   general: (server) => {

package/src/tools/interaction/ask-user.ts

@@ -6,9 +6,18 @@ const Schema = z.object({
   question: z.string().describe('The question to ask the user'),
   options: z.array(z.object({
     label: z.string().describe('The label of the option'),
+    value: z.string().optional().describe('Stable value returned when the option is chosen'),
     description: z.string().optional().describe('The description of the option')
   })).optional().describe('The options for the user to select from'),
-  multiselect: z.boolean().optional().describe('Whether the user can select multiple options')
+  multiselect: z.boolean().optional().describe('Whether the user can select multiple options'),
+  kind: z.enum(['question', 'permission']).optional().describe('UI hint for how to present the interaction'),
+  permissionContext: z.object({
+    adapter: z.string().optional(),
+    currentMode: z.enum(['default', 'acceptEdits', 'plan', 'dontAsk', 'bypassPermissions']).optional(),
+    suggestedMode: z.enum(['default', 'acceptEdits', 'plan', 'dontAsk', 'bypassPermissions']).optional(),
+    deniedTools: z.array(z.string()).optional(),
+    reasons: z.array(z.string()).optional()
+  }).optional().describe('Extra context for permission escalation prompts')
 })
 
 export default defineRegister(({ registerTool }) => {
@@ -20,7 +29,7 @@ export default defineRegister(({ registerTool }) => {
       inputSchema: Schema
     },
     async (args) => {
-      const { question, options, multiselect } = args
+      const { question, options, multiselect, kind, permissionContext } = args
       const sessionId = process.env.__VF_PROJECT_AI_SESSION_ID__
 
       if (!sessionId) {
@@ -40,7 +49,9 @@ export default defineRegister(({ registerTool }) => {
           sessionId,
           question,
           options,
-          multiselect
+          multiselect,
+          kind,
+          permissionContext
         })
       })
 
@@ -49,12 +60,35 @@ export default defineRegister(({ registerTool }) => {
         throw new Error(`Failed to ask user question: ${response.statusText} - ${errorText}`)
       }
 
-      const result = await response.json()
+      const result = await response.json() as { data?: unknown; result?: unknown } | unknown
+      const body = (
+        result != null &&
+        typeof result === 'object' &&
+        'data' in result
+          ? (result as { data?: unknown }).data
+          : result
+      )
+      const answer = (
+        body != null &&
+        typeof body === 'object' &&
+        'result' in body
+          ? (body as { result?: unknown }).result
+          : body
+      )
+
+      if (answer == null) {
+        throw new Error('AskUserQuestion returned an empty result')
+      }
+
+      const text = Array.isArray(answer)
+        ? answer.map(item => String(item)).join('\n')
+        : String(answer)
+
       return {
         content: [
           {
             type: 'text',
-            text: JSON.stringify(result.result)
+            text
           }
         ]
       }

package/src/tools/task/manager.ts

@@ -117,6 +117,7 @@ export class TaskManager {
         skills: resolvedConfig.skills,
         mcpServers: resolvedConfig.mcpServers,
         promptAssetIds: resolvedConfig.promptAssetIds,
+        assetBundle: resolvedConfig.assetBundle,
         onEvent: (event: McpTaskOutputEvent) => {
           this.handleEvent(taskId, event)
         }