@vibe-forge/client 2.0.0 → 3.0.0-alpha.0

package/src/api/skill-hub.ts

@@ -0,0 +1,126 @@
+import { createApiUrl, fetchApiJson } from './base'
+
+export interface SkillHubRegistrySummary {
+  id: string
+  type: 'claude-code' | 'skills-sh'
+  enabled: boolean
+  searchable: boolean
+  source: string
+  pluginCount?: number
+  error?: string
+}
+
+export interface SkillHubItem {
+  id: string
+  registry: string
+  name: string
+  description?: string
+  version?: string
+  skills: string[]
+  commands: string[]
+  agents: string[]
+  mcpServers: string[]
+  hasHooks: boolean
+  installed: boolean
+  installScope?: string
+  installedAt?: string
+  installRef?: string
+  source?: string
+  detailUrl?: string
+  installs?: number
+}
+
+export interface SkillHubSearchResult {
+  hasMore?: boolean
+  registries: SkillHubRegistrySummary[]
+  items: SkillHubItem[]
+}
+
+export interface SkillHubInstallResult {
+  registry: string
+  plugin: string
+  name: string
+  scope?: string
+  installedAt: string
+  installDir: string
+}
+
+export interface SkillsCliSearchResult {
+  source: string
+  items: SkillHubItem[]
+  hasMore?: boolean
+  total?: number
+  error?: string
+}
+
+export interface SkillsCliInstallResult {
+  source: string
+  skill: string
+  name: string
+  installedAt: string
+  installDir: string
+}
+
+export async function searchSkillHub(params: {
+  limit?: number
+  registry?: string
+  query?: string
+} = {}): Promise<SkillHubSearchResult> {
+  const url = createApiUrl('/api/skill-hub/search')
+  if (params.limit != null) {
+    url.searchParams.set('limit', String(params.limit))
+  }
+  if (params.registry != null && params.registry !== '') {
+    url.searchParams.set('registry', params.registry)
+  }
+  if (params.query != null && params.query !== '') {
+    url.searchParams.set('q', params.query)
+  }
+  return fetchApiJson<SkillHubSearchResult>(url)
+}
+
+export async function installSkillHubItem(params: {
+  registry: string
+  plugin: string
+  force?: boolean
+  scope?: string
+}): Promise<SkillHubInstallResult> {
+  return fetchApiJson<SkillHubInstallResult>('/api/skill-hub/install', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(params)
+  })
+}
+
+export async function searchSkillsCli(params: {
+  limit?: number
+  registry?: string
+  source: string
+  query?: string
+}): Promise<SkillsCliSearchResult> {
+  const url = createApiUrl('/api/skill-hub/skills-cli/search')
+  url.searchParams.set('source', params.source)
+  if (params.limit != null) {
+    url.searchParams.set('limit', String(params.limit))
+  }
+  if (params.query != null && params.query !== '') {
+    url.searchParams.set('q', params.query)
+  }
+  if (params.registry != null && params.registry !== '') {
+    url.searchParams.set('registry', params.registry)
+  }
+  return fetchApiJson<SkillsCliSearchResult>(url)
+}
+
+export async function installSkillsCliItem(params: {
+  registry?: string
+  source: string
+  skill: string
+  force?: boolean
+}): Promise<SkillsCliInstallResult> {
+  return fetchApiJson<SkillsCliInstallResult>('/api/skill-hub/skills-cli/install', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(params)
+  })
+}

package/src/api/workspace.ts

@@ -1,11 +1,23 @@
-import { createApiUrl, fetchApiJson } from './base'
+import { createApiUrl, fetchApiJson, jsonHeaders } from './base'
 
 export interface WorkspaceTreeEntry {
+  isExternal?: boolean
+  isSymlink?: boolean
+  linkKind?: 'gitdir' | 'symlink'
+  linkTarget?: string
+  linkType?: 'directory' | 'file' | 'missing' | 'other'
   path: string
   name: string
   type: 'file' | 'directory'
 }
 
+export interface WorkspaceFileContent {
+  content: string
+  encoding: 'utf-8'
+  path: string
+  size: number
+}
+
 export async function listWorkspaceTree(path?: string) {
   const url = createApiUrl('/api/workspace/tree')
   if (path != null && path.trim() !== '') {
@@ -17,3 +29,23 @@ export async function listWorkspaceTree(path?: string) {
     entries: WorkspaceTreeEntry[]
   }>(url)
 }
+
+export async function readWorkspaceFile(path: string): Promise<WorkspaceFileContent> {
+  const url = createApiUrl('/api/workspace/file')
+  url.searchParams.set('path', path)
+  return fetchApiJson<WorkspaceFileContent>(url)
+}
+
+export function getWorkspaceResourceUrl(path: string) {
+  const url = createApiUrl('/api/workspace/resource')
+  url.searchParams.set('path', path)
+  return url.toString()
+}
+
+export async function updateWorkspaceFile(path: string, content: string): Promise<WorkspaceFileContent> {
+  return fetchApiJson<WorkspaceFileContent>('/api/workspace/file', {
+    method: 'PUT',
+    headers: jsonHeaders,
+    body: JSON.stringify({ path, content })
+  })
+}

package/src/api/worktree-environments.ts

@@ -0,0 +1,53 @@
+import type {
+  WorktreeEnvironmentDetail,
+  WorktreeEnvironmentListResult,
+  WorktreeEnvironmentMutationResult,
+  WorktreeEnvironmentSavePayload,
+  WorktreeEnvironmentSource
+} from '@vibe-forge/types'
+
+import { fetchApiJson, jsonHeaders } from './base'
+
+export async function listWorktreeEnvironments(): Promise<WorktreeEnvironmentListResult> {
+  return fetchApiJson<WorktreeEnvironmentListResult>('/api/worktree-environments')
+}
+
+const getSourceQuery = (source?: WorktreeEnvironmentSource) => (
+  source == null ? '' : `?source=${encodeURIComponent(source)}`
+)
+
+export async function getWorktreeEnvironment(
+  id: string,
+  source?: WorktreeEnvironmentSource
+): Promise<{ environment: WorktreeEnvironmentDetail }> {
+  return fetchApiJson<{ environment: WorktreeEnvironmentDetail }>(
+    `/api/worktree-environments/${encodeURIComponent(id)}${getSourceQuery(source)}`
+  )
+}
+
+export async function saveWorktreeEnvironment(
+  id: string,
+  payload: WorktreeEnvironmentSavePayload,
+  source?: WorktreeEnvironmentSource
+): Promise<WorktreeEnvironmentMutationResult> {
+  return fetchApiJson<WorktreeEnvironmentMutationResult>(
+    `/api/worktree-environments/${encodeURIComponent(id)}${getSourceQuery(source)}`,
+    {
+      method: 'PUT',
+      headers: jsonHeaders,
+      body: JSON.stringify(payload)
+    }
+  )
+}
+
+export async function deleteWorktreeEnvironment(
+  id: string,
+  source?: WorktreeEnvironmentSource
+): Promise<{ ok: true; removed: boolean }> {
+  return fetchApiJson<{ ok: true; removed: boolean }>(
+    `/api/worktree-environments/${encodeURIComponent(id)}${getSourceQuery(source)}`,
+    {
+      method: 'DELETE'
+    }
+  )
+}

package/src/api.ts

@@ -1,5 +1,7 @@
+export { getAdapterAccountDetail, getAdapterAccounts, manageAdapterAccount } from './api/adapters'
 // 自动化规则与执行记录 API
 export type { AutomationRule, AutomationRun, AutomationTask, AutomationTrigger } from './api/automation'
+
 export {
   createAutomationRule,
   deleteAutomationRule,
@@ -8,7 +10,6 @@ export {
   runAutomationRule,
   updateAutomationRule
 } from './api/automation'
-
 export { ApiError, getApiErrorMessage } from './api/base'
 export {
   getBenchmarkCase,
@@ -20,7 +21,7 @@ export {
 } from './api/benchmark'
 
 // 配置读取与更新 API
-export { getConfig, updateConfig } from './api/config'
+export { getConfig, getConfigSchema, updateConfig } from './api/config'
 export {
   checkoutSessionGitBranch,
   commitSessionGitChanges,
@@ -36,8 +37,30 @@ export {
 } from './api/git'
 
 // 知识库与规则说明 API
-export type { EntityDetail, EntitySummary, RuleDetail, RuleSummary, SpecDetail, SpecSummary } from './api/knowledge'
-export { getEntityDetail, getRuleDetail, getSpecDetail, listEntities, listRules, listSpecs } from './api/knowledge'
+export type {
+  EntityDetail,
+  EntitySummary,
+  RuleDetail,
+  RuleSummary,
+  SkillDetail,
+  SkillSummary,
+  SpecDetail,
+  SpecSummary,
+  WorkspaceSummary
+} from './api/knowledge'
+export {
+  createSkill,
+  getEntityDetail,
+  getRuleDetail,
+  getSkillDetail,
+  getSpecDetail,
+  importSkillArchive,
+  listEntities,
+  listRules,
+  listSkills,
+  listSpecs,
+  listWorkspaces
+} from './api/knowledge'
 
 // 项目与工程 API
 export { createProject, listProjects } from './api/projects'
@@ -53,21 +76,41 @@ export {
   forkSession,
   getSessionMessages,
   getSessionWorkspace,
+  getSessionWorkspaceResourceUrl,
   listSessionWorkspaceTree,
   listSessions,
   moveQueuedMessage,
+  readSessionWorkspaceFile,
   reorderQueuedMessages,
   respondSessionInteraction,
   transferSessionWorkspaceToLocal,
   updateQueuedMessage,
   updateSession,
-  updateSessionTitle
+  updateSessionTitle,
+  updateSessionWorkspaceFile
 } from './api/sessions'
+export type {
+  SkillHubInstallResult,
+  SkillHubItem,
+  SkillHubRegistrySummary,
+  SkillHubSearchResult,
+  SkillsCliInstallResult,
+  SkillsCliSearchResult
+} from './api/skill-hub'
+export { installSkillHubItem, installSkillsCliItem, searchSkillHub, searchSkillsCli } from './api/skill-hub'
 
 // 基础响应类型与会话交互类型
 export type { ApiOkResponse, ApiRemoveResponse, SessionInteraction, SessionMessagesResponse } from './api/types'
-export type { WorkspaceTreeEntry } from './api/workspace'
-export { listWorkspaceTree } from './api/workspace'
+export type { WorkspaceFileContent, WorkspaceTreeEntry } from './api/workspace'
+export { getWorkspaceResourceUrl, listWorkspaceTree, readWorkspaceFile, updateWorkspaceFile } from './api/workspace'
+
+// Worktree 环境脚本 API
+export {
+  deleteWorktreeEnvironment,
+  getWorktreeEnvironment,
+  listWorktreeEnvironments,
+  saveWorktreeEnvironment
+} from './api/worktree-environments'
 
 export type {
   GitAvailabilityReason,
@@ -75,6 +118,7 @@ export type {
   GitBranchListResult,
   GitBranchSummary,
   GitChangeSummary,
+  GitChangedFile,
   GitCommitPayload,
   GitHeadCommitSummary,
   GitMutationResult,
@@ -85,3 +129,14 @@ export type {
 } from '@vibe-forge/types'
 export type { BenchmarkCase, BenchmarkCategory, BenchmarkResult, BenchmarkRunSummary } from '@vibe-forge/types'
 export type { SessionWorkspace } from '@vibe-forge/types'
+export type {
+  WorktreeEnvironmentDetail,
+  WorktreeEnvironmentListResult,
+  WorktreeEnvironmentMutationResult,
+  WorktreeEnvironmentOperation,
+  WorktreeEnvironmentPlatform,
+  WorktreeEnvironmentSavePayload,
+  WorktreeEnvironmentScript,
+  WorktreeEnvironmentScriptKey,
+  WorktreeEnvironmentSummary
+} from '@vibe-forge/types'

package/src/client-build-info.ts

@@ -0,0 +1,19 @@
+import { getRuntimeEnv } from '#~/runtime-config'
+
+const pickNonEmptyValue = (...values: Array<string | undefined>) => (
+  values.find((value) => typeof value === 'string' && value.trim() !== '')
+)
+
+export const getClientVersion = () => (
+  pickNonEmptyValue(
+    getRuntimeEnv().__VF_PROJECT_AI_CLIENT_VERSION__,
+    import.meta.env.__VF_PROJECT_AI_CLIENT_VERSION__
+  ) ?? '0.0.0'
+)
+
+export const getClientCommitHash = () => (
+  pickNonEmptyValue(
+    getRuntimeEnv().__VF_PROJECT_AI_CLIENT_COMMIT_HASH__,
+    import.meta.env.__VF_PROJECT_AI_CLIENT_COMMIT_HASH__
+  )
+)