@vibe-forge/core 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "imports": {
     "#~/*.js": {
       "__vibe-forge__": {

package/src/adapter/type.ts

@@ -20,6 +20,7 @@ export type SessionInfo =
 export interface SessionInitInfo {
   uuid: string
   model: string
+  adapter?: string
   version: string
   tools: string[]
   slashCommands: string[]

package/src/channel.ts

@@ -40,6 +40,13 @@ export const channelBaseSchema = z.object({
   systemPrompt: z
     .string().optional()
     .describe('在此频道启动会话时注入的系统提示词'),
+  // 指令
+  commandPrefix: z
+    .string().optional()
+    .describe('频道指令前缀，默认 /'),
+  language: z
+    .enum(['zh', 'en']).optional()
+    .describe('频道提示语言，默认 zh'),
   // 访问权限控制
   access: channelAccessSchema
     .optional()
@@ -54,8 +61,24 @@ export type ChannelConfig = {
   [K in ChannelType]: ChannelConfigByType<K>
 }[ChannelType]
 
+export interface ChannelSendResult {
+  messageId?: string
+}
+
+export interface ChannelFollowUp {
+  content: string
+  i18nContents?: Array<{
+    content: string
+    language: string
+  }>
+}
+
 export interface ChannelConnection<TMessage> {
-  sendMessage: (message: TMessage) => Promise<void>
+  sendMessage: (message: TMessage) => Promise<ChannelSendResult | undefined>
+  pushFollowUps?: (input: {
+    messageId: string
+    followUps: readonly ChannelFollowUp[]
+  }) => Promise<void>
   startReceiving?: (options: {
     handlers: ChannelEventHandlers
   }) => Promise<void>

package/src/controllers/task/run.ts

@@ -129,6 +129,17 @@ export const run = async (
 
   const originalOnEvent = adapterOptions.onEvent
   const wrappedOnEvent = (event: AdapterOutputEvent) => {
+    if (event.type === 'init') {
+      originalOnEvent({
+        ...event,
+        data: {
+          ...event.data,
+          adapter: adapterType
+        }
+      })
+      return
+    }
+
     if (event.type === 'exit') {
       const { data } = event
 

package/src/types.ts

@@ -9,6 +9,8 @@ export interface Project {
 
 export type SessionStatus = 'running' | 'completed' | 'failed' | 'terminated' | 'waiting_input'
 
+export type SessionPermissionMode = 'default' | 'acceptEdits' | 'plan' | 'dontAsk' | 'bypassPermissions'
+
 export interface Session {
   id: string
   parentSessionId?: string
@@ -21,6 +23,9 @@ export interface Session {
   isArchived?: boolean
   tags?: string[]
   status?: SessionStatus
+  model?: string
+  adapter?: string
+  permissionMode?: SessionPermissionMode
 }
 
 export type ChatMessageContent =

package/src/utils/cache.ts

@@ -46,6 +46,13 @@ export const getCache = async <K extends keyof Cache>(
   key: K
 ): Promise<Cache[K] | undefined> => {
   const cachePath = getCachePath(cwd, taskId, sessionId, key)
-  await fs.access(cachePath)
+  try {
+    await fs.access(cachePath)
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+      return undefined
+    }
+    throw error
+  }
   return JSON.parse(await fs.readFile(cachePath, 'utf-8'))
 }

package/src/utils/definition-loader.ts

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { basename, dirname, join, relative, resolve } from 'node:path'
+import { basename, dirname, relative, resolve } from 'node:path'
 import process from 'node:process'
 
 import { glob } from 'fast-glob'
@@ -79,6 +79,50 @@ export const loadLocalDocuments = async <Attrs extends object>(
   return Promise.all(promises)
 }
 
+const normalizePath = (path: string) => path.split('\\').join('/')
+
+const stripExtension = (fileName: string) => fileName.replace(/\.[^/.]+$/, '')
+
+const getFirstNonEmptyLine = (text: string) =>
+  text
+    .split('\n')
+    .map(line => line.trim())
+    .find(Boolean)
+
+const toPromptPath = (cwd: string, path: string) => {
+  const relPath = normalizePath(relative(cwd, path))
+  return relPath.startsWith('..') ? normalizePath(path) : relPath
+}
+
+const resolveDocumentName = (
+  path: string,
+  explicitName?: string,
+  indexFileNames: string[] = []
+) => {
+  const trimmedName = explicitName?.trim()
+  if (trimmedName) return trimmedName
+
+  const fileName = basename(path).toLowerCase()
+  if (indexFileNames.includes(fileName)) {
+    return basename(dirname(path))
+  }
+
+  return stripExtension(basename(path))
+}
+
+const resolveDocumentDescription = (
+  body: string,
+  explicitDescription?: string,
+  fallbackName?: string
+) => {
+  const trimmedDescription = explicitDescription?.trim()
+  return trimmedDescription || getFirstNonEmptyLine(body) || fallbackName || ''
+}
+
+const resolveSpecIdentifier = (path: string, explicitName?: string) => {
+  return resolveDocumentName(path, explicitName, ['index.md'])
+}
+
 export class DefinitionLoader {
   private readonly cwd: string
 
@@ -113,13 +157,12 @@ export class DefinitionLoader {
     const rulesPrompt = rules
       .map((rule) => {
         const { path, body, attributes } = rule
-        const name = attributes.name ?? basename(path)
-        const desc = attributes.description ?? name
-        return (
-          `  - ${name}：${desc}\n` +
-          `${attributes.always ? body : ''}\n` +
-          '--------------------\n'
-        )
+        const name = resolveDocumentName(path, attributes.name)
+        const desc = resolveDocumentDescription(body, attributes.description, name)
+        const content = attributes.always && body.trim()
+          ? `<rule-content>\n${body.trim()}\n</rule-content>\n`
+          : ''
+        return `  - ${name}：${desc}\n${content}--------------------\n`
       })
       .filter(Boolean)
       .join('\n')
@@ -150,9 +193,7 @@ export class DefinitionLoader {
     // Filter by directory name (skill name)
     if (skills) {
       paths = paths.filter(path => {
-        const parts = path.split('/')
-        // .../skills/{name}/SKILL.md
-        return skills.includes(parts[parts.length - 2])
+        return skills.includes(basename(dirname(path)))
       })
     }
 
@@ -164,13 +205,17 @@ export class DefinitionLoader {
   generateSkillsPrompt(skills: Definition<Skill>[]): string {
     return skills
       .map((skill) => {
-        const { path, body } = skill
+        const { path, body, attributes } = skill
+        const name = resolveDocumentName(path, attributes.name, ['skill.md'])
+        const desc = resolveDocumentDescription(body, attributes.description, name)
         return (
           '技能相关信息如下，通过阅读以下内容了解技能的详细信息：\n' +
-          `- 技能文件资源路径：${dirname(path)}\n` +
+          `- 技能名称：${name}\n` +
+          `- 技能介绍：${desc}\n` +
+          `- 技能文件资源路径：${toPromptPath(this.cwd, dirname(path))}\n` +
           '- 资源内容：\n' +
           '<skill-content>\n' +
-          `${body}\n` +
+          `${body.trim()}\n` +
           '</skill-content>\n' +
           '资源内容中的文件路径相对「技能文件资源路径」路径，通过读取相关工具按照实际需要进行阅读。\n'
         )
@@ -185,7 +230,11 @@ export class DefinitionLoader {
         skills
           .filter(({ attributes: { always } }) => always !== false)
           .map(
-            ({ attributes: { name, description } }) => `  - ${name}：${description}\n`
+            ({ path, body, attributes }) => {
+              const name = resolveDocumentName(path, attributes.name, ['skill.md'])
+              const desc = resolveDocumentDescription(body, attributes.description, name)
+              return `  - ${name}：${desc}\n`
+            }
           )
           .join('')
       }\n` +
@@ -197,7 +246,8 @@ export class DefinitionLoader {
     const patterns = [
       `.ai/specs/${name}.md`,
       `.ai/specs/${name}/index.md`,
-      `.ai/plugins/*/specs/${name}.md`
+      `.ai/plugins/*/specs/${name}.md`,
+      `.ai/plugins/*/specs/${name}/index.md`
     ]
     const paths = await this.scan(patterns)
     if (paths.length === 0) return undefined
@@ -221,34 +271,23 @@ export class DefinitionLoader {
   generateSpecRoutePrompt(specsDocuments: Definition<Spec>[]): string {
     const specsRouteStr = specsDocuments
       .filter(({ attributes }) => attributes.always !== false)
-      .map(({ path, attributes }) => {
-        const name = attributes.name ?? basename(dirname(path))
-        const desc = attributes.description ?? name
+      .map(({ path, body, attributes }) => {
+        const name = resolveDocumentName(path, attributes.name, ['index.md'])
+        const desc = resolveDocumentDescription(body, attributes.description, name)
+        const identifier = resolveSpecIdentifier(path, attributes.name)
         const params = attributes.params ?? []
-        // Calculate relative path for display/ID
-        // User code used relative('.ai/specs', path), but here path is absolute.
-        // We can try to make it relative to cwd/.ai/specs if possible, or just relative to cwd.
-        // The user code seems to assume specs are in .ai/specs.
-        // Let's use relative(join(this.cwd, '.ai/specs'), path) if it's in there, otherwise...
-        // Actually, just providing a relative path from project root is probably fine or the name.
-        // User code: relative('.ai/specs', path)
-
-        let relPath = relative(join(this.cwd, '.ai/specs'), path)
-        if (relPath.startsWith('..')) {
-          // Maybe in a plugin?
-          relPath = relative(this.cwd, path)
-        }
+        const paramsPrompt = params.length > 0
+          ? params
+            .map(({ name, description }) => `    - ${name}：${description ?? '无'}\n`)
+            .join('')
+          : '    - 无\n'
 
         return (
           `- 流程名称：${name}\n` +
           `  - 介绍：${desc}\n` +
-          `  - 标识：${relPath}\n` +
+          `  - 标识：${identifier}\n` +
           '  - 参数：\n' +
-          `${
-            params
-              .map(({ name, description }) => `    - ${name}：${description}\n`)
-              .join('')
-          }\n`
+          `${paramsPrompt}`
         )
       })
       .join('\n')
@@ -285,7 +324,9 @@ export class DefinitionLoader {
 
     // 2. Fallback to Markdown file
     const patterns = [
+      `.ai/entities/${name}.md`,
       `.ai/entities/${name}/README.md`,
+      `.ai/plugins/*/entities/${name}.md`,
       `.ai/plugins/*/entities/${name}/README.md`
     ]
     const paths = await this.scan(patterns)
@@ -327,7 +368,9 @@ export class DefinitionLoader {
     // List both .md and index.json entities
     const mdPatterns = [
       '.ai/entities/*.md',
-      '.ai/plugins/*/entities/*.md'
+      '.ai/entities/*/README.md',
+      '.ai/plugins/*/entities/*.md',
+      '.ai/plugins/*/entities/*/README.md'
     ]
     const jsonPatterns = [
       '.ai/entities/*/index.json',
@@ -350,7 +393,12 @@ export class DefinitionLoader {
       '项目存在如下实体：\n' +
       `${
         entities
-          .map(({ attributes: { name, prompt: _p }, body }) => `  - ${name}：${body}\n`)
+          .filter(({ attributes }) => attributes.always !== false)
+          .map(({ path, attributes, body }) => {
+            const name = resolveDocumentName(path, attributes.name, ['readme.md', 'index.json'])
+            const desc = resolveDocumentDescription(body, attributes.description, name)
+            return `  - ${name}：${desc}\n`
+          })
           .join('')
       }\n` +
       '解决用户问题时，需根据用户需求可以通过 run-tasks 工具指定为实体后，自行调度多个不同类型的实体来完成工作。\n' +