@shawnstack/quickforge 1.4.0 → 1.5.0

package/server/routes/workspace.mjs

@@ -12,6 +12,8 @@ import {
 } from '../utils/workspace.mjs'
 
 const MAX_PREVIEW_BYTES = 1024 * 1024
+const MAX_STATIC_PREVIEW_BYTES = 10 * 1024 * 1024
+const PREVIEW_ALLOWED_EXTENSIONS = new Set(['.html', '.htm', '.css', '.js', '.mjs', '.json', '.svg', '.png', '.jpg', '.jpeg', '.webp', '.gif', '.ico', '.txt', '.md'])
 const MAX_TREE_NODES = 5000
 const SKIP_DIRS = new Set(['.git', 'node_modules', 'dist', 'dist-ssr', 'package-dist', 'package-offline', '.vite', 'coverage'])
 
@@ -34,6 +36,28 @@ function languageFromPath(filePath) {
   return extensionLanguageMap.get(extension) || 'plaintext'
 }
 
+function previewContentType(filePath) {
+  const ext = path.extname(filePath).toLowerCase()
+  const map = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+  }
+  return map[ext] || 'application/octet-stream'
+}
+
 function isBinaryBuffer(buffer) {
   const length = Math.min(buffer.length, 8000)
   for (let index = 0; index < length; index += 1) {
@@ -144,10 +168,71 @@ function countGitStatus(files) {
   }, { staged: 0, unstaged: 0, untracked: 0, conflicts: 0, total: 0 })
 }
 
+function countTextLines(text) {
+  if (text.length === 0) return 0
+  return text.split('\n').length - (text.endsWith('\n') ? 1 : 0)
+}
+
+// numstat 的路径列对 rename 用 "prefix/{old => new}" 或 "old => new" 形式，取新路径
+function numstatNewPath(rawPath) {
+  const arrow = rawPath.indexOf(' => ')
+  if (arrow < 0) return rawPath
+  const head = rawPath.slice(0, arrow)
+  const tail = rawPath.slice(arrow + 4)
+  const brace = head.lastIndexOf('{')
+  if (brace < 0) return tail
+  return `${head.slice(0, brace)}${tail.replace(/\}$/, '')}`
+}
+
+// 工作区 vs HEAD 的每个文件增删行数（口径与 git diff --numstat 一致）
+async function collectNumstat(context) {
+  const map = new Map()
+  const result = await git(['diff', 'HEAD', '--numstat', '-z'], context.workspaceRoot, { allowFailure: true })
+  if (result.code !== 0) return map
+  const records = result.stdout.toString('utf8').split('\0').filter(Boolean)
+  for (const record of records) {
+    const fields = record.split('\t')
+    if (fields.length < 3) continue
+    const added = fields[0]
+    const removed = fields[1]
+    const rawPath = fields.slice(2).join('\t')
+    if (added === '-' || removed === '-') continue // 二进制文件
+    const additions = Number(added)
+    const deletions = Number(removed)
+    if (!Number.isFinite(additions) || !Number.isFinite(deletions)) continue
+    map.set(numstatNewPath(rawPath), { additions, deletions })
+  }
+  return map
+}
+
+// 未跟踪文件不在 numstat 中，按工作区文件行数估算新增行
+async function countWorkspaceLines(context, relativePath) {
+  try {
+    const { content } = await readWorkspaceTextFile(context, relativePath)
+    return countTextLines(content)
+  } catch {
+    return undefined
+  }
+}
+
 async function listGitStatus(context) {
   if (!(await isGitRepository(context.workspaceRoot))) return { isGitRepository: false, files: [] }
   const result = await git(['status', '--porcelain=v1', '-z'], context.workspaceRoot)
   const files = parseGitStatus(result.stdout)
+  const numstat = await collectNumstat(context)
+  for (const file of files) {
+    const entry = numstat.get(file.path)
+    if (entry) {
+      file.additions = entry.additions
+      file.deletions = entry.deletions
+    } else if (file.status === 'untracked' || file.status === 'added') {
+      const count = await countWorkspaceLines(context, file.path)
+      if (typeof count === 'number') {
+        file.additions = count
+        file.deletions = 0
+      }
+    }
+  }
   return {
     isGitRepository: true,
     branch: await currentGitBranch(context.workspaceRoot),
@@ -246,6 +331,55 @@ async function handleWorkspaceFile(req, res, url) {
   })
 }
 
+async function handleWorkspacePreview(req, res, url) {
+  const prefix = '/api/workspace/preview/'
+  const tail = url.pathname.startsWith(prefix) ? url.pathname.slice(prefix.length) : ''
+  const slashIndex = tail.indexOf('/')
+  if (slashIndex <= 0) {
+    const error = new Error('projectId and path are required')
+    error.statusCode = 400
+    throw error
+  }
+
+  const projectId = decodeURIComponent(tail.slice(0, slashIndex))
+  const relativePath = decodeURIComponent(tail.slice(slashIndex + 1))
+  if (!projectId || !relativePath) {
+    const error = new Error('projectId and path are required')
+    error.statusCode = 400
+    throw error
+  }
+
+  const context = await projectContextFromId(projectId)
+  const file = resolveWorkspacePath(relativePath, context)
+  await assertSafeWorkspacePath(file, context)
+  const extension = path.extname(file).toLowerCase()
+  if (!PREVIEW_ALLOWED_EXTENSIONS.has(extension)) {
+    const error = new Error('Unsupported preview file type')
+    error.statusCode = 415
+    throw error
+  }
+  const stat = await fs.stat(file)
+  if (!stat.isFile()) {
+    const error = new Error('Path is not a file')
+    error.statusCode = 400
+    throw error
+  }
+  if (stat.size > MAX_STATIC_PREVIEW_BYTES) {
+    const error = new Error('File is too large to preview')
+    error.statusCode = 413
+    throw error
+  }
+
+  const contentType = previewContentType(file)
+  res.writeHead(200, {
+    'content-type': contentType,
+    'cache-control': 'no-store',
+    'x-content-type-options': 'nosniff',
+  })
+  const buffer = await fs.readFile(file)
+  res.end(buffer)
+}
+
 async function handleWorkspaceResolvePath(req, res) {
   const body = await readJsonBody(req, 16 * 1024)
   const projectId = typeof body?.projectId === 'string' ? body.projectId : ''
@@ -344,6 +478,10 @@ export async function handleWorkspaceApi(req, res, url) {
     await handleWorkspaceFile(req, res, url)
     return
   }
+  if (req.method === 'GET' && url.pathname.startsWith('/api/workspace/preview/')) {
+    await handleWorkspacePreview(req, res, url)
+    return
+  }
   if (req.method === 'POST' && url.pathname === '/api/workspace/resolve-path') {
     await handleWorkspaceResolvePath(req, res)
     return

package/server/session-utils.mjs

@@ -1,5 +1,5 @@
 import { streamSimple } from '@earendil-works/pi-ai'
-import { buildInstructionsPayload } from './project-config.mjs'
+import { buildInstructionsPayload, projectContextFromId } from './project-config.mjs'
 import { composeSystemPrompt } from './system-prompt.mjs'
 import { listSubagentProfiles } from './agent-profiles.mjs'
 
@@ -9,9 +9,17 @@ import { listSubagentProfiles } from './agent-profiles.mjs'
 
 export async function buildSystemPrompt(projectId) {
   const instructions = await buildInstructionsPayload(projectId)
+  let workspaceRoot = instructions.workspace?.root || null
+  if (projectId && !workspaceRoot) {
+    try {
+      workspaceRoot = (await projectContextFromId(projectId))?.workspaceRoot || null
+    } catch {
+      // project may have been removed; fall back to global agent profile discovery
+    }
+  }
   return composeSystemPrompt({
     ...instructions,
-    subagents: await listSubagentProfiles(),
+    subagents: await listSubagentProfiles({ projectId, workspaceRoot }),
   })
 }
 

package/server/storage.mjs

@@ -94,6 +94,7 @@ export const configDir = path.join(dataDir, 'config')
 export const storageDir = path.join(dataDir, 'storage')
 export const cacheDir = path.join(dataDir, 'cache')
 export const logsDir = path.join(dataDir, 'logs')
+export const userCommandsDir = path.join(dataDir, 'commands')
 
 const quickForgeConfigFile = path.join(configDir, 'config.json')
 const configMigrationMarkerFile = path.join(configDir, '.layout-migrated')
@@ -467,6 +468,26 @@ async function rebuildBucketIndex() {
   bucketIndexBuilt = true
 }
 
+async function findSessionBucketByDataFile(sessionId) {
+  assertSafePathSegment(sessionId)
+  const buckets = [
+    { scope: 'global' },
+    ...(await listProjectIds()).map((projectId) => ({ scope: 'project', projectId })),
+  ]
+
+  for (const bucket of buckets) {
+    const file = sessionDataFile(sessionId, bucket)
+    try {
+      const stat = await fs.stat(file)
+      if (stat.isFile()) return bucket
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error
+    }
+  }
+
+  return null
+}
+
 export async function findSessionBucket(sessionId) {
   if (!bucketIndexBuilt) {
     await ensureStorage()
@@ -477,8 +498,12 @@ export async function findSessionBucket(sessionId) {
 
 export async function readSessionValue(sessionId) {
   const bucket = await findSessionBucket(sessionId)
-  if (!bucket) return null
-  return readJsonFile(sessionDataFile(sessionId, bucket), null)
+  if (bucket) return readJsonFile(sessionDataFile(sessionId, bucket), null)
+
+  const recoveredBucket = await findSessionBucketByDataFile(sessionId)
+  if (!recoveredBucket) return null
+  sessionBucketIndex.set(sessionId, recoveredBucket)
+  return readJsonFile(sessionDataFile(sessionId, recoveredBucket), null)
 }
 
 export async function writeSessionValue(sessionId, value) {
@@ -724,6 +749,9 @@ export function ensureStorage() {
       fs.mkdir(path.join(cacheDir, 'projects'), { recursive: true }),
       fs.mkdir(path.join(storageDir, 'conversations', 'global', 'sessions'), { recursive: true }),
       fs.mkdir(path.join(storageDir, 'conversations', 'projects'), { recursive: true }),
+      // Default workspace directory for global (non-project) conversations, so
+      // they share the same file-tool capabilities as project conversations.
+      fs.mkdir(path.join(dataDir, 'workspace'), { recursive: true }),
       cleanOldLogs(),
     ])
 

package/server/subagents.mjs

@@ -21,23 +21,23 @@ export const subagentDefinitions = [
     name: 'general',
     label: 'General',
     mode: 'subagent',
-    description: 'A general-purpose agent for researching complex problems and executing multi-step tasks. It has full built-in workspace tool access, excluding MCP tools and Agent Skills, so it can modify files when needed. Use it for substantial independent work units, including parallelizable work.',
+    description: 'A general-purpose agent for bounded complex multi-step implementation or broader independent work. It has full built-in workspace tool access, excluding MCP tools and Agent Skills, so it can modify files when needed. Prefer Explore for focused read-only repository discovery, source search, call-chain lookup, tests/docs discovery, and impact analysis.',
     allowedTools: ['read_file', 'grep_files', 'write_file', 'edit_file', 'run_command'],
     allowFileMutations: true,
     maxRuntimeMs: 30 * 60 * 1000,
     maxToolCalls: 300,
-    systemPrompt: `You are General, a general-purpose subagent for complex research and multi-step implementation tasks. You may inspect, edit, write files, and run commands using the built-in workspace tools when needed. You do not have MCP tools or Agent Skills. Make focused, minimal changes that satisfy the delegated task, and verify your changes when appropriate.`,
+    systemPrompt: `You are General, a general-purpose subagent for bounded complex multi-step implementation tasks and broader independent work. You may inspect, edit, write files, and run commands using the built-in workspace tools when needed. You do not have MCP tools or Agent Skills. Prefer Explore for focused read-only repository discovery, source search, call-chain lookup, tests/docs discovery, and impact analysis. Make focused, minimal changes that satisfy the delegated task, and verify your changes when appropriate.`,
   },
   {
     name: 'explore',
     label: 'Explore',
     mode: 'subagent',
-    description: 'A fast read-only agent for targeted exploration and focused questions. It cannot modify files. Use it to quickly find relevant files, search keywords, identify patterns, or summarize findings.',
-    allowedTools: ['read_file', 'grep_files'],
+    description: 'The preferred subagent for focused read-only repository exploration, file discovery, source search, call-chain lookup, related tests/docs/wiki discovery, safe inspection commands, pattern lookup, and impact analysis before non-trivial implementation. It cannot modify files.',
+    allowedTools: ['read_file', 'grep_files', 'run_command'],
     allowFileMutations: false,
     maxRuntimeMs: 30 * 60 * 1000,
     maxToolCalls: 300,
-    systemPrompt: `You are Explore, a fast read-only exploration subagent. Use read_file and grep_files to locate relevant files, search keywords, identify patterns, and answer focused questions. You cannot modify files or run commands.`,
+    systemPrompt: `You are Explore, the preferred read-only repository exploration subagent. Use read_file, grep_files, and safe read-only run_command calls to locate files, inspect project structure, search source, trace call chains, find related tests/docs/wiki pages, run diagnostics, identify patterns, assess impact, and answer focused questions before non-trivial implementation. You cannot modify files.`,
   },
 ]
 
@@ -80,7 +80,9 @@ export function composeSubagentSystemPrompt({ definition, parentSystemPrompt, pr
     '- run_subagent is not available to subagents.',
     definition.allowFileMutations
       ? '- File modification tools are available when needed, subject to the parent session approval/YOLO policy.'
-      : '- This subagent is read-only. Do not modify files or run commands.',
+      : definition.allowedTools.includes('run_command')
+        ? '- This subagent is read-only. Do not modify files. Use run_command only for safe inspection or diagnostic commands.'
+        : '- This subagent is read-only. Do not modify files or run commands.',
     workspaceLines.length ? `\nWorkspace context:\n${workspaceLines.join('\n')}` : '',
     '</subagent_instructions>',
   ].filter(Boolean).join('\n')

package/server/system-prompt.mjs

@@ -5,10 +5,11 @@ For project tasks:
 - Prefer the simplest solution that satisfies the request.
 - Make surgical changes only. Do not refactor unrelated code.
 - Match existing style.
+- When content has room for visual explanation, first consider whether an SVG diagram can improve understanding.
 - For multi-step work, use a brief plan.
 - Before changing files, gather sufficient context: relevant files, entry points or call chains, existing patterns, tests or validation commands, and docs/wiki impact.
 - Before taking action, confirm with the user.
-- Unless the change is trivial and localized to an already-known file, use Explore first for read-only repository research; prefer Explore for broad searches, pattern lookup, impact analysis, and locating related tests, docs, or build scripts.
+- Unless the change is trivial and localized to an already-known file, use Explore first for read-only repository research before implementation decisions; prefer Explore for file discovery, source location, broad searches, call-chain lookup, pattern lookup, impact analysis, and locating related tests, docs, wiki pages, or build scripts.
 - For complex multi-step work, use General only for bounded assistance; the parent assistant remains responsible for final decisions, minimal edits, and verification.
 - Make minimal, focused changes.
 - Prefer dedicated workspace tools for reading, editing, and searching files.
@@ -63,7 +64,7 @@ function appendSubagentCatalog(parts, subagents) {
   const subagentParts = subagents.map(formatSubagentCatalogItem)
   parts.push(`
 <available_subagents>
-The run_subagent tool can delegate work to an enabled temporary Agent Profile. Built-in profiles include Explore for fast read-only codebase search and General for complex multi-step implementation work; custom profiles may also be available when enabled.
+The run_subagent tool can delegate work to an enabled temporary Agent Profile. Prefer Explore for focused read-only repository discovery before implementation decisions, including locating files, searching source, tracing call chains, finding related tests/docs/wiki pages, and impact analysis. Use General for bounded complex multi-step implementation or broader independent work; custom profiles may also be available when enabled.
 
 Choose the most appropriate subagent by name, keep delegation concrete, and include relevant context. Treat subagent output as advisory; you remain responsible for the final answer.
 

package/server/tools/definitions.mjs

@@ -15,7 +15,7 @@ import { loadSelectedGlobalSkills, loadSelectedProjectSkills, mergeSkills } from
 export const subagentTool = {
   name: 'run_subagent',
   label: 'Run subagent',
-  description: 'Delegate a bounded task to an enabled temporary Agent Profile. Built-in profiles include general for complex multi-step work and explore for fast read-only lookup. Custom profiles can also be enabled as subagents. Subagents are short-lived and do not receive MCP or Agent Skill tools.',
+  description: 'Delegate a bounded task to an enabled temporary Agent Profile. Prefer explore for focused read-only repository discovery before implementation decisions, including locating files, searching source, tracing call chains, finding related tests/docs/wiki pages, and impact analysis. Use general for bounded complex multi-step implementation or broader independent work. Custom profiles can also be enabled as subagents. Subagents are short-lived and do not receive MCP or Agent Skill tools.',
   parameters: Type.Object({
     subagent: Type.String({ description: 'Agent Profile name to invoke.' }),
     task: Type.String({ description: 'Concrete, bounded task for the subagent. Do not delegate vague or open-ended work.' }),
@@ -86,6 +86,24 @@ export const workspaceTools = [
     }),
     executionMode: 'sequential',
   },
+  {
+    name: 'present_files',
+    label: 'Present files',
+    description: 'Show one or more AI-produced artifact files to the user. Use this after creating or editing user-facing files such as HTML pages, SVG/images, Markdown documents, or other deliverables. HTML files will be previewed directly in the artifact preview panel.',
+    parameters: Type.Object({
+      files: Type.Array(Type.Union([
+        Type.String({ description: 'File path relative to the workspace root.' }),
+        Type.Object({
+          path: Type.String({ description: 'File path relative to the workspace root.' }),
+          title: Type.Optional(Type.String({ description: 'Optional display title.' })),
+          description: Type.Optional(Type.String({ description: 'Optional short description shown in artifact lists.' })),
+          kind: Type.Optional(Type.String({ description: 'Optional file kind hint, such as html, image, markdown, or code.' })),
+          preview: Type.Optional(Type.Boolean({ description: 'Whether this file should be opened as the default preview.' })),
+        }),
+      ]), { description: 'Artifact files to present.' }),
+      defaultPreview: Type.Optional(Type.String({ description: 'File path to open as the default preview when multiple files are presented.' })),
+    }),
+  },
 ]
 
 function activeSkillSchema(skills) {

package/server/tools/index.mjs

@@ -619,6 +619,88 @@ export async function toolReadSkillResource(params, context) {
   }
 }
 
+// --- present_files ---
+function inferPresentedFileKind(relativePath) {
+  const lower = String(relativePath || '').toLowerCase()
+  if (lower.endsWith('.html') || lower.endsWith('.htm')) return 'html'
+  if (/\.(svg|png|jpe?g|webp|gif|bmp|ico)$/.test(lower)) return 'image'
+  if (lower.endsWith('.md') || lower.endsWith('.mdx')) return 'markdown'
+  if (/\.(ts|tsx|js|jsx|mjs|cjs|css|scss|less|json|jsonc|txt|xml|yml|yaml|toml|ini|py|rb|go|rs|java|c|h|cpp|hpp|cs|php|sh|bash|zsh|ps1)$/.test(lower)) return 'code'
+  return 'unknown'
+}
+
+function normalizePresentFileEntry(entry) {
+  if (typeof entry === 'string') return { path: entry }
+  if (entry && typeof entry === 'object' && typeof entry.path === 'string') {
+    return {
+      path: entry.path,
+      title: typeof entry.title === 'string' ? entry.title : undefined,
+      description: typeof entry.description === 'string' ? entry.description : undefined,
+      kind: typeof entry.kind === 'string' ? entry.kind : undefined,
+      preview: typeof entry.preview === 'boolean' ? entry.preview : undefined,
+    }
+  }
+  return undefined
+}
+
+export async function toolPresentFiles(params, context) {
+  const rawFiles = Array.isArray(params?.files) ? params.files : []
+  const defaultPreviewInput = typeof params?.defaultPreview === 'string' ? params.defaultPreview : undefined
+  if (rawFiles.length === 0) {
+    const error = new Error('files must contain at least one path')
+    error.statusCode = 400
+    throw error
+  }
+
+  const files = []
+  const seen = new Set()
+  for (const raw of rawFiles) {
+    const entry = normalizePresentFileEntry(raw)
+    if (!entry?.path?.trim()) continue
+    const file = resolveWorkspacePath(entry.path, context)
+    await assertSafeWorkspacePath(file, context)
+    const stat = await fs.stat(file)
+    if (!stat.isFile()) {
+      const error = new Error(`Path is not a file: ${entry.path}`)
+      error.statusCode = 400
+      throw error
+    }
+    const relativePath = toWorkspaceRelative(file, context)
+    const key = relativePath.toLowerCase()
+    if (seen.has(key)) continue
+    seen.add(key)
+    const kind = entry.kind || inferPresentedFileKind(relativePath)
+    const isDefaultPreview = defaultPreviewInput ? relativePath === defaultPreviewInput.replace(/\\/g, '/') : false
+    files.push({
+      path: relativePath,
+      title: entry.title,
+      description: entry.description,
+      kind,
+      preview: entry.preview ?? (isDefaultPreview || kind === 'html'),
+      defaultPreview: isDefaultPreview,
+      bytes: stat.size,
+    })
+  }
+
+  if (files.length === 0) {
+    const error = new Error('No valid files to present')
+    error.statusCode = 400
+    throw error
+  }
+
+  const previewed = files.filter((file) => file.preview || file.kind === 'html').map((file) => file.path)
+  return {
+    content: `Presented ${files.length} file(s)${previewed.length ? ` and opened ${previewed.length} preview(s)` : ''}: ${files.map((file) => file.path).join(', ')}`,
+    details: {
+      type: 'present_files_result',
+      files,
+      defaultPreview: files.find((file) => file.defaultPreview)?.path,
+      previewed,
+      project: context?.project,
+    },
+  }
+}
+
 // --- run_command ---
 const DEFAULT_RUN_COMMAND_TIMEOUT_MS = 30 * 60 * 1000
 const MIN_RUN_COMMAND_TIMEOUT_MS = 1000
@@ -1009,6 +1091,7 @@ export const toolHandlers = {
   write_file: toolWriteFile,
   edit_file: toolEditFile,
   run_command: toolRunCommand,
+  present_files: toolPresentFiles,
   activate_skill: toolActivateSkill,
   read_skill_resource: toolReadSkillResource,
 }

package/server/utils/package-update.mjs

@@ -0,0 +1,156 @@
+import { spawn } from 'node:child_process'
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+function normalizeRepositoryUrl(value) {
+  if (!value || typeof value !== 'string') return ''
+  return value
+    .replace(/^git\+/i, '')
+    .replace(/^git@github\.com:/i, 'https://github.com/')
+    .replace(/\.git$/i, '')
+}
+
+export async function getPackageInfo(projectRoot) {
+  const packageJsonPath = path.join(projectRoot, 'package.json')
+  try {
+    const text = await fs.readFile(packageJsonPath, 'utf8')
+    const pkg = JSON.parse(text)
+    const repositoryUrl = normalizeRepositoryUrl(
+      typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url,
+    )
+
+    return {
+      name: pkg.name || 'quickforge',
+      version: pkg.version || '0.0.0',
+      repositoryUrl,
+      homepage: pkg.homepage || repositoryUrl,
+      bugsUrl: typeof pkg.bugs === 'string' ? pkg.bugs : pkg.bugs?.url || '',
+    }
+  } catch (error) {
+    throw new Error(`Unable to read package metadata: ${error.message}`)
+  }
+}
+
+function normalizeVersion(version) {
+  return String(version || '').trim().replace(/^v/i, '')
+}
+
+function parseVersion(version) {
+  const [main, prerelease = ''] = normalizeVersion(version).split('-', 2)
+  const numbers = main.split('.').slice(0, 3).map((part) => {
+    const value = Number(part)
+    return Number.isFinite(value) ? value : 0
+  })
+
+  while (numbers.length < 3) numbers.push(0)
+  return { numbers, prerelease }
+}
+
+function comparePrerelease(left, right) {
+  if (left === right) return 0
+  if (!left) return 1
+  if (!right) return -1
+
+  const leftParts = left.split('.')
+  const rightParts = right.split('.')
+  const maxLength = Math.max(leftParts.length, rightParts.length)
+
+  for (let i = 0; i < maxLength; i += 1) {
+    const leftPart = leftParts[i]
+    const rightPart = rightParts[i]
+    if (leftPart === rightPart) continue
+    if (leftPart === undefined) return -1
+    if (rightPart === undefined) return 1
+
+    const leftNumber = /^\d+$/.test(leftPart) ? Number(leftPart) : null
+    const rightNumber = /^\d+$/.test(rightPart) ? Number(rightPart) : null
+
+    if (leftNumber !== null && rightNumber !== null) return leftNumber > rightNumber ? 1 : -1
+    if (leftNumber !== null) return -1
+    if (rightNumber !== null) return 1
+
+    return leftPart > rightPart ? 1 : -1
+  }
+
+  return 0
+}
+
+export function compareVersions(left, right) {
+  const parsedLeft = parseVersion(left)
+  const parsedRight = parseVersion(right)
+
+  for (let i = 0; i < 3; i += 1) {
+    if (parsedLeft.numbers[i] > parsedRight.numbers[i]) return 1
+    if (parsedLeft.numbers[i] < parsedRight.numbers[i]) return -1
+  }
+
+  return comparePrerelease(parsedLeft.prerelease, parsedRight.prerelease)
+}
+
+function getRegistryPackageUrl(packageName) {
+  const registry = (process.env.npm_config_registry || 'https://registry.npmjs.org/').replace(/\/+$/, '')
+  return `${registry}/${encodeURIComponent(packageName)}`
+}
+
+export async function fetchLatestVersion(packageName) {
+  const controller = new AbortController()
+  const timeout = setTimeout(() => controller.abort(), 5000)
+
+  try {
+    const response = await fetch(getRegistryPackageUrl(packageName), {
+      headers: { accept: 'application/json' },
+      signal: controller.signal,
+    })
+
+    if (!response.ok) throw new Error(`registry returned HTTP ${response.status}`)
+
+    const metadata = await response.json()
+    const latest = metadata?.['dist-tags']?.latest
+    if (!latest || typeof latest !== 'string') throw new Error('latest version not found in registry response')
+    return latest
+  } catch (error) {
+    if (error.name === 'AbortError') throw new Error('request timeout')
+    throw error
+  } finally {
+    clearTimeout(timeout)
+  }
+}
+
+export async function checkForUpdates(projectRoot) {
+  const pkg = await getPackageInfo(projectRoot)
+  const latestVersion = await fetchLatestVersion(pkg.name)
+  const comparison = compareVersions(pkg.version, latestVersion)
+  return {
+    ...pkg,
+    currentVersion: pkg.version,
+    latestVersion,
+    updateAvailable: comparison < 0,
+    localVersionIsNewer: comparison > 0,
+    installCommand: `npm install -g ${pkg.name}@latest`,
+  }
+}
+
+function getNpmCommand() {
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+}
+
+export async function installLatestVersion(packageName, options = {}) {
+  const target = `${packageName}@latest`
+  const child = spawn(getNpmCommand(), ['install', '-g', target], {
+    cwd: options.cwd,
+    stdio: 'ignore',
+    shell: process.platform === 'win32',
+    windowsHide: true,
+  })
+
+  return new Promise((resolve, reject) => {
+    child.on('error', reject)
+    child.on('exit', (code) => {
+      if (code === 0) {
+        resolve()
+        return
+      }
+      reject(new Error(`npm install exited with code ${code}`))
+    })
+  })
+}

package/dist/assets/AgentProfilesPage-C79teCgh.js

@@ -1 +0,0 @@
-import{i as e}from"./rolldown-runtime-DWdDZTNf.js";import{it as t,nt as n,s as r}from"./icons-Dsc5yL3l.js";import{n as i}from"./react-vendor-CiCXOLb5.js";import{E as a,O as o,S as s,T as c,b as l,v as u,x as d,y as f}from"./index-YTL26wyJ.js";var p=e(t(),1),m=i();function h(){return{name:``,label:``,description:``,systemPrompt:``,allowedTools:[`read_file`,`grep_files`],maxRuntimeMs:`1800000`,maxToolCalls:`300`,enabledAsSubagent:!0}}function g(e){return{name:e.name,label:e.label,description:e.description??``,systemPrompt:e.systemPrompt??``,allowedTools:e.allowedTools??[],maxRuntimeMs:String(e.maxRuntimeMs??18e5),maxToolCalls:String(e.maxToolCalls??300),enabledAsSubagent:e.enabledAsSubagent}}function _(e){return{name:e.name.trim().toLowerCase(),label:e.label.trim(),description:e.description.trim(),systemPrompt:e.systemPrompt.trim(),allowedTools:e.allowedTools,maxRuntimeMs:Number(e.maxRuntimeMs||18e5),maxToolCalls:Number(e.maxToolCalls||300),enabledAsSubagent:e.enabledAsSubagent}}function v(e){return!!(e.name.trim()&&e.label.trim()&&e.allowedTools.length>0)}async function y(e,t){let n=await fetch(e,{...t,headers:{"content-type":`application/json`,...t?.headers}}),r=await n.json().catch(()=>null);if(!n.ok)throw Error(r?.error||`请求失败`);return r}function b(){let[e,t]=(0,p.useState)([]),[i,b]=(0,p.useState)([]),[x,S]=(0,p.useState)(!1),[C,w]=(0,p.useState)(null),[T,E]=(0,p.useState)(()=>h()),[D,O]=(0,p.useState)(!1),[k,A]=(0,p.useState)(``),[j,M]=(0,p.useState)(!1),[N,P]=(0,p.useState)(),[F,I]=(0,p.useState)(`off`),[L,R]=(0,p.useState)(``);async function z(){let[e,n]=await Promise.all([y(`/api/agent-profiles`),y(`/api/agent-profiles/available-tools`)]);t(e.agents),b(n.tools)}(0,p.useEffect)(()=>{let e=!1;async function n(){try{let[n,r]=await Promise.all([y(`/api/agent-profiles`),y(`/api/agent-profiles/available-tools`)]);if(e)return;t(n.agents),b(r.tools)}catch(t){e||R(t instanceof Error?t.message:o(`requestFailed`))}}return n(),()=>{e=!0}},[]),(0,p.useEffect)(()=>{let e=!1;async function t(){try{let t=await l(),n=await f(t),r=await d(t),i=r.model??await s(t)??n[0];if(e)return;P(i),I(r.thinkingLevel??u(i))}catch{}}return t(),()=>{e=!0}},[]);let B=(0,p.useMemo)(()=>e.find(e=>e.id===C)??null,[e,C]);function V(e,t){E(n=>({...n,[e]:t}))}function H(e){E(t=>({...t,allowedTools:t.allowedTools.includes(e)?t.allowedTools.filter(t=>t!==e):[...t.allowedTools,e]}))}function U(){w(null),E(h()),A(``),R(``),S(!0)}function W(e){w(e.id),E(g(e)),A(``),R(``),S(!0)}function G(){D||j||(S(!1),w(null),E(h()),A(``))}async function K(){let e=k.trim();if(!e){R(o(`aiFillAgentInputRequired`));return}if(!N){R(o(`aiFillAgentNoModel`));return}M(!0),R(``);try{let t=await y(`/api/agent-profiles/ai-fill`,{method:`POST`,body:JSON.stringify({instruction:e,model:N,thinkingLevel:F})});E(e=>({...e,name:t.agent.name,label:t.agent.label,description:t.agent.description,systemPrompt:t.agent.systemPrompt}))}catch(e){R(e instanceof Error?e.message:o(`aiFillAgentFailed`))}finally{M(!1)}}async function q(){if(v(T)){O(!0),R(``);try{let e=_(T);C?await y(`/api/agent-profiles/${encodeURIComponent(C)}`,{method:`PATCH`,body:JSON.stringify(e)}):await y(`/api/agent-profiles`,{method:`POST`,body:JSON.stringify(e)}),G(),await z()}catch(e){R(e instanceof Error?e.message:o(`requestFailed`))}finally{O(!1)}}}async function J(e){if(!e.builtin&&await c({description:o(`confirmDeleteAgent`),confirmLabel:o(`confirmDelete`),cancelLabel:o(`cancel`),variant:`destructive`})){R(``);try{await y(`/api/agent-profiles/${encodeURIComponent(e.id)}`,{method:`DELETE`}),await z()}catch(e){R(e instanceof Error?e.message:o(`requestFailed`))}}}return(0,m.jsxs)(`div`,{className:`flex min-h-0 flex-1 flex-col overflow-hidden bg-background`,children:[(0,m.jsx)(`div`,{className:`border-b border-border px-6 py-5`,children:(0,m.jsxs)(`div`,{className:`flex flex-wrap items-center justify-between gap-3`,children:[(0,m.jsxs)(`div`,{className:`flex items-center gap-3`,children:[(0,m.jsx)(`div`,{className:`flex size-10 items-center justify-center rounded-2xl bg-primary/10 text-primary`,children:(0,m.jsx)(n,{className:`size-5`})}),(0,m.jsxs)(`div`,{children:[(0,m.jsx)(`h1`,{className:`text-lg font-semibold text-foreground`,children:o(`agentsTab`)}),(0,m.jsx)(`p`,{className:`text-sm text-muted-foreground`,children:o(`agentsDescription`)})]})]}),(0,m.jsx)(a,{onClick:U,children:o(`createAgent`)})]})}),(0,m.jsx)(`div`,{className:`min-h-0 flex-1 overflow-y-auto p-6`,children:(0,m.jsxs)(`div`,{className:`mx-auto max-w-5xl space-y-5`,children:[L&&!x?(0,m.jsx)(`div`,{className:`rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive`,children:L}):null,(0,m.jsx)(`div`,{className:`grid gap-4 md:grid-cols-2`,children:e.map(e=>(0,m.jsxs)(`div`,{className:`rounded-2xl border border-border bg-card p-4 shadow-sm`,children:[(0,m.jsxs)(`div`,{className:`flex items-start justify-between gap-3`,children:[(0,m.jsxs)(`div`,{className:`min-w-0`,children:[(0,m.jsxs)(`div`,{className:`flex flex-wrap items-center gap-2`,children:[(0,m.jsx)(`h3`,{className:`truncate text-base font-semibold text-foreground`,children:e.label}),e.builtin?(0,m.jsx)(`span`,{className:`rounded-full bg-primary/10 px-2 py-0.5 text-xs text-primary`,children:o(`builtinAgent`)}):null,e.enabledAsSubagent?(0,m.jsx)(`span`,{className:`rounded-full bg-emerald-500/10 px-2 py-0.5 text-xs text-emerald-700`,children:o(`enabledAsSubagent`)}):null]}),(0,m.jsx)(`p`,{className:`mt-1 font-mono text-xs text-muted-foreground`,children:e.name}),(0,m.jsx)(`p`,{className:`mt-2 text-sm text-muted-foreground`,children:e.description||o(`noDescription`)})]}),(0,m.jsxs)(`div`,{className:`flex shrink-0 gap-1`,children:[(0,m.jsx)(a,{variant:`outline`,size:`sm`,disabled:e.builtin,onClick:()=>W(e),children:o(`editTask`)}),(0,m.jsx)(a,{variant:`destructive`,size:`sm`,disabled:e.builtin,onClick:()=>void J(e),children:o(`delete`)})]})]}),(0,m.jsx)(`div`,{className:`mt-3 flex flex-wrap gap-1`,children:e.allowedTools.map(e=>(0,m.jsx)(`span`,{className:`rounded-full bg-muted px-2 py-0.5 font-mono text-xs text-muted-foreground`,children:e},e))}),(0,m.jsxs)(`div`,{className:`mt-3 grid gap-2 border-t border-border pt-3 text-xs text-muted-foreground sm:grid-cols-2`,children:[(0,m.jsxs)(`span`,{children:[o(`maxRuntimeMs`),e.maxRuntimeMs??`-`]}),(0,m.jsxs)(`span`,{children:[o(`maxToolCalls`),e.maxToolCalls??`-`]})]})]},e.id))})]})}),x?(0,m.jsx)(`div`,{className:`fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4`,onMouseDown:e=>{e.target===e.currentTarget&&G()},children:(0,m.jsxs)(`div`,{className:`flex max-h-[90vh] w-full max-w-3xl flex-col overflow-hidden rounded-2xl border border-border bg-background shadow-2xl`,onMouseDown:e=>e.stopPropagation(),children:[(0,m.jsxs)(`div`,{className:`shrink-0 border-b border-border px-5 py-4`,children:[(0,m.jsx)(`h2`,{className:`text-base font-semibold text-foreground`,children:o(B?`editAgent`:`createAgent`)}),B?.builtin?(0,m.jsx)(`p`,{className:`mt-1 text-sm text-muted-foreground`,children:o(`builtinAgentReadonly`)}):null]}),(0,m.jsx)(`div`,{className:`min-h-0 flex-1 overflow-y-auto px-5 py-4`,children:(0,m.jsxs)(`div`,{className:`space-y-4`,children:[(0,m.jsxs)(`div`,{className:`rounded-2xl border border-border bg-muted/20 p-3`,children:[(0,m.jsxs)(`div`,{className:`mb-2 flex items-center gap-2 text-sm font-medium text-foreground`,children:[(0,m.jsx)(r,{className:`size-4 text-primary`}),o(`aiFillAgent`)]}),(0,m.jsx)(`p`,{className:`mb-2 text-xs text-muted-foreground`,children:o(`aiFillAgentDescription`)}),(0,m.jsx)(`textarea`,{className:`min-h-20 w-full resize-y rounded-xl border border-input bg-background px-3 py-2 text-sm outline-none transition-colors placeholder:text-muted-foreground/65 focus:border-ring disabled:opacity-60`,value:k,disabled:!!B?.builtin||j,onChange:e=>A(e.target.value),placeholder:o(`aiFillAgentPlaceholder`)}),(0,m.jsx)(`div`,{className:`mt-2 flex justify-end`,children:(0,m.jsxs)(a,{variant:`outline`,size:`sm`,onClick:()=>void K(),disabled:!!B?.builtin||j||!k.trim(),children:[(0,m.jsx)(r,{className:`mr-1 size-3.5`}),o(j?`aiFillAgentLoading`:`aiFillAgent`)]})})]}),(0,m.jsxs)(`div`,{className:`grid gap-3 sm:grid-cols-2`,children:[(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`agentName`),(0,m.jsx)(`input`,{className:`mt-1 h-10 w-full rounded-md border border-input bg-background px-3 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.name,disabled:!!B?.builtin,onChange:e=>V(`name`,e.target.value),placeholder:`reviewer`})]}),(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`agentLabel`),(0,m.jsx)(`input`,{className:`mt-1 h-10 w-full rounded-md border border-input bg-background px-3 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.label,disabled:!!B?.builtin,onChange:e=>V(`label`,e.target.value),placeholder:o(`agentLabelPlaceholder`)})]})]}),(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`agentDescription`),(0,m.jsx)(`input`,{className:`mt-1 h-10 w-full rounded-md border border-input bg-background px-3 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.description,disabled:!!B?.builtin,onChange:e=>V(`description`,e.target.value)})]}),(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`agentSystemPrompt`),(0,m.jsx)(`textarea`,{className:`mt-1 min-h-36 w-full resize-y rounded-xl border border-input bg-background px-3 py-2 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.systemPrompt,disabled:!!B?.builtin,onChange:e=>V(`systemPrompt`,e.target.value)})]}),(0,m.jsxs)(`div`,{children:[(0,m.jsx)(`div`,{className:`mb-2 text-sm font-medium text-foreground`,children:o(`allowedTools`)}),(0,m.jsx)(`div`,{className:`grid gap-2 sm:grid-cols-2`,children:i.map(e=>(0,m.jsxs)(`label`,{className:`flex items-start gap-2 rounded-xl border border-border bg-muted/20 p-3 text-sm disabled:opacity-60`,children:[(0,m.jsx)(`input`,{type:`checkbox`,className:`mt-1`,disabled:!!B?.builtin,checked:T.allowedTools.includes(e.name),onChange:()=>H(e.name)}),(0,m.jsxs)(`span`,{children:[(0,m.jsx)(`span`,{className:`font-medium text-foreground`,children:e.label}),(0,m.jsx)(`span`,{className:`ml-2 font-mono text-xs text-muted-foreground`,children:e.name}),e.riskLevel===`dangerous`?(0,m.jsx)(`span`,{className:`ml-2 rounded-full bg-amber-500/10 px-2 py-0.5 text-xs text-amber-700`,children:o(`highRiskTool`)}):null,(0,m.jsx)(`span`,{className:`mt-1 block text-xs text-muted-foreground`,children:e.description})]})]},e.name))})]}),(0,m.jsxs)(`div`,{className:`grid gap-3 sm:grid-cols-2`,children:[(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`maxRuntimeMs`),(0,m.jsx)(`input`,{type:`number`,className:`mt-1 h-10 w-full rounded-md border border-input bg-background px-3 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.maxRuntimeMs,disabled:!!B?.builtin,onChange:e=>V(`maxRuntimeMs`,e.target.value)})]}),(0,m.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[o(`maxToolCalls`),(0,m.jsx)(`input`,{type:`number`,className:`mt-1 h-10 w-full rounded-md border border-input bg-background px-3 text-sm outline-none focus:border-ring disabled:opacity-60`,value:T.maxToolCalls,disabled:!!B?.builtin,onChange:e=>V(`maxToolCalls`,e.target.value)})]})]}),(0,m.jsxs)(`label`,{className:`flex items-center gap-2 text-sm text-foreground`,children:[(0,m.jsx)(`input`,{type:`checkbox`,checked:T.enabledAsSubagent,disabled:!!B?.builtin,onChange:e=>V(`enabledAsSubagent`,e.target.checked)}),o(`enabledAsSubagent`)]}),L?(0,m.jsx)(`div`,{className:`rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive`,children:L}):null]})}),(0,m.jsx)(`div`,{className:`shrink-0 border-t border-border px-5 py-4`,children:(0,m.jsxs)(`div`,{className:`flex justify-end gap-2`,children:[(0,m.jsx)(a,{variant:`outline`,onClick:G,disabled:D||j,children:o(`cancel`)}),(0,m.jsx)(a,{onClick:q,disabled:D||j||!!B?.builtin||!v(T),children:o(`save`)})]})})]})}):null]})}export{b as AgentProfilesPage};