@vibe-forge/core 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/core",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "imports": {
     "#~/*.js": {
       "__vibe-forge__": {
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "zod": "^3.24.1",
-    "@vibe-forge/types": "^0.10.0",
-    "@vibe-forge/utils": "^0.10.0"
+    "@vibe-forge/types": "^0.11.0",
+    "@vibe-forge/utils": "^0.11.0"
   }
 }

package/src/channel.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod'
 
+import type { Config } from '@vibe-forge/types'
+
 export interface ChannelMap {}
 
 export type ChannelType = keyof ChannelMap
@@ -47,6 +49,19 @@ export const channelBaseSchema = z.object({
   language: z
     .enum(['zh', 'en']).optional()
     .describe('频道提示语言，默认 zh'),
+  enableSessionMcp: z
+    .boolean().optional()
+    .describe('是否在通过该频道启动的会话中自动挂载该频道提供的 companion MCP，默认 true'),
+  serverBaseUrl: z
+    .string().optional()
+    .describe(
+      '用户可访问的 server 基础地址，例如 http://192.168.1.10:8787 或 https://example.com/vf；用于生成频道内跳转和 server 动作链接'
+    ),
+  sessionDetailBaseUrl: z
+    .string().optional()
+    .describe(
+      '用户可访问的会话详情页面基础地址，例如 https://example.com/ui；用于生成频道内跳转到 server 会话详情的链接'
+    ),
   // 访问权限控制
   access: channelAccessSchema
     .optional()
@@ -73,8 +88,17 @@ export interface ChannelFollowUp {
   }>
 }
 
+export interface ChannelFileMessage {
+  receiveId: string
+  receiveIdType: string
+  fileName: string
+  content: string | Uint8Array
+}
+
 export interface ChannelConnection<TMessage> {
   sendMessage: (message: TMessage) => Promise<ChannelSendResult | undefined>
+  sendFileMessage?: (message: ChannelFileMessage) => Promise<ChannelSendResult | undefined>
+  updateMessage?: (messageId: string, message: TMessage) => Promise<ChannelSendResult | undefined>
   pushFollowUps?: (input: {
     messageId: string
     followUps: readonly ChannelFollowUp[]
@@ -126,6 +150,26 @@ export interface ChannelEventHandlers {
   [event: string]: ChannelEventHandler | ChannelEventHandler<ChannelInboundEvent> | undefined
 }
 
+export interface ChannelSessionMcpContext {
+  sessionId: string
+  channelKey: string
+  channelType: string
+  channelId: string
+  sessionType: string
+  replyReceiveId?: string
+  replyReceiveIdType?: string
+}
+
+export interface ChannelSessionMcpServer {
+  name: string
+  config: NonNullable<Config['mcpServers']>[string]
+}
+
+export type ResolveChannelSessionMcpServersFn<TConfig = unknown> = (
+  config: TConfig,
+  context: ChannelSessionMcpContext
+) => Promise<readonly ChannelSessionMcpServer[] | undefined> | readonly ChannelSessionMcpServer[] | undefined
+
 export interface ChannelDescriptor<
   TConfigSchema extends z.ZodTypeAny = z.ZodTypeAny,
   TMessageSchema extends z.ZodTypeAny = z.ZodTypeAny,
@@ -153,3 +197,7 @@ export type ChannelCreateFn<TConfig = unknown, TMessage = unknown> = (
 export const defineCreateChannelConnection = <TConfigSchema extends z.ZodTypeAny, TMessageSchema extends z.ZodTypeAny>(
   connect: ChannelCreateFn<z.infer<TConfigSchema>, z.infer<TMessageSchema>>
 ): ChannelCreateFn<z.infer<TConfigSchema>, z.infer<TMessageSchema>> => connect
+
+export const defineResolveChannelSessionMcpServers = <TConfig = unknown>(
+  resolve: ResolveChannelSessionMcpServersFn<TConfig>
+): ResolveChannelSessionMcpServersFn<TConfig> => resolve

package/src/env.ts

@@ -10,6 +10,8 @@ export interface ServerEnv {
   __VF_PROJECT_AI_SERVER_HOST__: string
   __VF_PROJECT_AI_SERVER_PORT__: number
   __VF_PROJECT_AI_SERVER_WS_PATH__: string
+  __VF_PROJECT_AI_PUBLIC_BASE_URL__?: string
+  __VF_PROJECT_AI_SERVER_ACTION_SECRET__?: string
   __VF_PROJECT_AI_SERVER_DATA_DIR__: string
   __VF_PROJECT_AI_SERVER_LOG_DIR__: string
   __VF_PROJECT_AI_SERVER_LOG_LEVEL__: LogLevel
@@ -25,6 +27,8 @@ export function loadEnv(): ServerEnv {
     __VF_PROJECT_AI_SERVER_HOST__ = 'localhost',
     __VF_PROJECT_AI_SERVER_PORT__ = '8787',
     __VF_PROJECT_AI_SERVER_WS_PATH__ = '/ws',
+    __VF_PROJECT_AI_PUBLIC_BASE_URL__,
+    __VF_PROJECT_AI_SERVER_ACTION_SECRET__,
     __VF_PROJECT_AI_SERVER_DATA_DIR__ = '.data',
     __VF_PROJECT_AI_SERVER_LOG_DIR__ = '.logs',
     __VF_PROJECT_AI_SERVER_LOG_LEVEL__ = 'info',
@@ -38,6 +42,8 @@ export function loadEnv(): ServerEnv {
     __VF_PROJECT_AI_SERVER_HOST__,
     __VF_PROJECT_AI_SERVER_PORT__: Number(__VF_PROJECT_AI_SERVER_PORT__),
     __VF_PROJECT_AI_SERVER_WS_PATH__,
+    __VF_PROJECT_AI_PUBLIC_BASE_URL__,
+    __VF_PROJECT_AI_SERVER_ACTION_SECRET__,
     __VF_PROJECT_AI_SERVER_DATA_DIR__,
     __VF_PROJECT_AI_SERVER_LOG_DIR__,
     __VF_PROJECT_AI_SERVER_LOG_LEVEL__: normalizeLogLevel(__VF_PROJECT_AI_SERVER_LOG_LEVEL__) ?? 'info',