@shawnstack/quickforge 1.6.8 → 1.6.10

package/server/routes/project.mjs

@@ -1,6 +1,7 @@
 import { sendJson, readJsonBody, decodeSegment } from '../utils/response.mjs'
 import { logger } from '../utils/logger.mjs'
 import { getActiveProject, setActiveProjectPath, readProjectConfig, getDefaultWorkspaceRoot } from '../project-config.mjs'
+import { resolveRequestedProject, workspaceRootAfterProjectDeletion } from '../project-route-context.mjs'
 import { listProjectCommands, createCommandFile } from '../custom-commands.mjs'
 import { atomicProjectConfigUpdate } from '../storage.mjs'
 import { getWorkspaceRoot, setWorkspaceRoot } from '../utils/workspace.mjs'
@@ -137,13 +138,12 @@ export async function handleProjectApi(req, res, url) {
 
   if (req.method === 'POST' && url.pathname === '/api/project/open-path') {
     const body = await readJsonBody(req)
-    const active = body?.projectId
-      ? config.projects.find((project) => project.id === body.projectId) ?? getActiveProject(config)
-      : getActiveProject(config)
+    const active = resolveRequestedProject(config, body?.projectId, getDefaultWorkspaceRoot())
     const target = String(body?.path || '')
+    const root = active?.path || getWorkspaceRoot() || getDefaultWorkspaceRoot()
     const resolved = target && path.isAbsolute(target)
       ? path.resolve(target)
-      : path.resolve(active?.path || '', target)
+      : path.resolve(root, target)
     await openPathInFileManager(resolved)
     sendJson(res, 200, { ok: true })
     return
@@ -151,9 +151,7 @@ export async function handleProjectApi(req, res, url) {
 
   if (req.method === 'POST' && url.pathname === '/api/project/command') {
     const body = await readJsonBody(req)
-    const active = body?.projectId
-      ? config.projects.find((project) => project.id === body.projectId) ?? getActiveProject(config)
-      : getActiveProject(config)
+    const active = resolveRequestedProject(config, body?.projectId, getDefaultWorkspaceRoot())
     if (!active?.path) {
       const error = new Error('No active project')
       error.statusCode = 400
@@ -178,9 +176,7 @@ export async function handleProjectApi(req, res, url) {
       return cfg
     })
     const active = getActiveProject(updated)
-    if (active?.path) {
-      setWorkspaceRoot(path.resolve(active.path))
-    }
+    setWorkspaceRoot(workspaceRootAfterProjectDeletion(active, getDefaultWorkspaceRoot()))
     sendJson(res, 200, { project: active ?? null, projects: updated.projects, workspaceRoot: getWorkspaceRoot() })
     return
   }

package/server/routes/workspace.mjs

@@ -6,6 +6,7 @@ import { sendJson, readJsonBody } from '../utils/response.mjs'
 import { projectContextFromId } from '../project-config.mjs'
 import { readStore } from '../storage.mjs'
 import { logger } from '../utils/logger.mjs'
+import { openPathInFileManager, openPathInIDEA, openPathInVSCode } from '../utils/platform.mjs'
 import {
   assertSafeWorkspacePath,
   resolveWorkspacePath,
@@ -139,13 +140,17 @@ function parseGitStatus(buffer) {
   return files.sort((left, right) => left.path.localeCompare(right.path, undefined, { sensitivity: 'base' }))
 }
 
-async function currentGitBranch(workspaceRoot) {
+async function currentGitHead(workspaceRoot) {
   const result = await git(['branch', '--show-current'], workspaceRoot, { allowFailure: true })
   const branch = result.stdout.toString('utf8').trim()
-  if (branch) return branch
+  if (branch) return { branch, detached: false }
   const head = await git(['rev-parse', '--short', 'HEAD'], workspaceRoot, { allowFailure: true })
   const commit = head.stdout.toString('utf8').trim()
-  return commit ? `HEAD ${commit}` : undefined
+  return { branch: commit ? `HEAD ${commit}` : undefined, detached: Boolean(commit) }
+}
+
+async function currentGitBranch(workspaceRoot) {
+  return (await currentGitHead(workspaceRoot)).branch
 }
 
 async function assertValidBranchName(workspaceRoot, branch) {
@@ -317,9 +322,11 @@ async function listGitStatus(context) {
       }
     }
   }
+  const head = await currentGitHead(context.workspaceRoot)
   return {
     isGitRepository: true,
-    branch: await currentGitBranch(context.workspaceRoot),
+    branch: head.branch,
+    detached: head.detached,
     counts: countGitStatus(files),
     files,
   }
@@ -347,8 +354,17 @@ async function hasStagedChanges(context) {
   return result.code === 1
 }
 
+async function assertAttachedGitHead(context) {
+  const head = await currentGitHead(context.workspaceRoot)
+  if (!head.detached) return head
+  const error = new Error('Cannot commit or push while HEAD is detached')
+  error.statusCode = 400
+  throw error
+}
+
 async function commitGitChanges(context, message, includeUnstaged) {
   await assertGitRepository(context)
+  await assertAttachedGitHead(context)
   const commitMessage = normalizeCommitMessage(message)
   if (includeUnstaged) await git(['add', '-A'], context.workspaceRoot)
   if (!(await hasStagedChanges(context))) {
@@ -360,8 +376,88 @@ async function commitGitChanges(context, message, includeUnstaged) {
   return listGitStatus(context)
 }
 
+async function normalizeGitOperationPath(context, value) {
+  const relativePath = typeof value === 'string' ? value.trim().replace(/\\/g, '/') : ''
+  if (!relativePath || relativePath === '.') {
+    const error = new Error('path is required')
+    error.statusCode = 400
+    throw error
+  }
+  const file = resolveWorkspacePath(relativePath, context)
+  await assertSafeWorkspacePath(file, context, { allowSensitive: true, ignoreMissing: true })
+  return toWorkspaceRelative(file, context)
+}
+
+async function stageGitPath(context, value) {
+  await assertGitRepository(context)
+  const relativePath = await normalizeGitOperationPath(context, value)
+  await git(['add', '-A', '--', relativePath], context.workspaceRoot)
+  return listGitStatus(context)
+}
+
+async function stageAllGitChanges(context) {
+  await assertGitRepository(context)
+  await git(['add', '-A'], context.workspaceRoot)
+  return listGitStatus(context)
+}
+
+async function unstageGitPath(context, value) {
+  await assertGitRepository(context)
+  const relativePath = await normalizeGitOperationPath(context, value)
+  await git(['restore', '--staged', '--', relativePath], context.workspaceRoot)
+  return listGitStatus(context)
+}
+
+async function unstageAllGitChanges(context) {
+  await assertGitRepository(context)
+  await git(['restore', '--staged', '--', '.'], context.workspaceRoot)
+  return listGitStatus(context)
+}
+
+async function restoreGitPath(context, value) {
+  await assertGitRepository(context)
+  const relativePath = await normalizeGitOperationPath(context, value)
+  const status = await listGitStatus(context)
+  const changedFile = status.files.find((file) => file.path === relativePath || file.oldPath === relativePath)
+  if (!changedFile) return status
+
+  if (changedFile.status === 'untracked') {
+    const file = resolveWorkspacePath(changedFile.path, context)
+    await assertSafeWorkspacePath(file, context, { allowSensitive: true, ignoreMissing: true })
+    await fs.rm(file, { recursive: true, force: true })
+    return listGitStatus(context)
+  }
+
+  const targets = [...new Set([changedFile.path, changedFile.oldPath].filter(Boolean))]
+  if (changedFile.staged) {
+    await git(['restore', '--staged', '--', ...targets], context.workspaceRoot, { allowFailure: true })
+  }
+
+  if (changedFile.status === 'added') {
+    await git(['clean', '-fd', '--', changedFile.path], context.workspaceRoot)
+    return listGitStatus(context)
+  }
+
+  if (changedFile.oldPath) {
+    await git(['restore', '--worktree', '--', changedFile.oldPath], context.workspaceRoot, { allowFailure: true })
+    await git(['clean', '-fd', '--', changedFile.path], context.workspaceRoot, { allowFailure: true })
+  } else {
+    await git(['restore', '--worktree', '--', changedFile.path], context.workspaceRoot)
+  }
+  return listGitStatus(context)
+}
+
+async function restoreAllGitChanges(context) {
+  await assertGitRepository(context)
+  await git(['restore', '--staged', '--', '.'], context.workspaceRoot, { allowFailure: true })
+  await git(['restore', '--worktree', '--', '.'], context.workspaceRoot, { allowFailure: true })
+  await git(['clean', '-fd'], context.workspaceRoot)
+  return listGitStatus(context)
+}
+
 async function pushGitBranch(context) {
   await assertGitRepository(context)
+  await assertAttachedGitHead(context)
   await git(['push'], context.workspaceRoot)
   return listGitStatus(context)
 }
@@ -398,7 +494,7 @@ function normalizeAiCommitMessage(text) {
   return message
 }
 
-async function generateGitCommitMessage(context, model, thinkingLevel = 'off') {
+async function generateGitCommitMessage(context, model, thinkingLevel = 'off', includeUnstaged = false) {
   await assertGitRepository(context)
   if (!model) {
     const error = new Error('Please configure a default model first')
@@ -415,9 +511,19 @@ async function generateGitCommitMessage(context, model, thinkingLevel = 'off') {
 
   const cachedStat = (await git(['diff', '--cached', '--stat'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
   const cachedDiff = (await git(['diff', '--cached'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
-  const worktreeStat = (await git(['diff', '--stat'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
-  const worktreeDiff = (await git(['diff'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
-  const files = status.files.map((file) => `- ${file.status}${file.staged ? ' staged' : ''}${file.unstaged ? ' unstaged' : ''}: ${file.oldPath ? `${file.oldPath} -> ` : ''}${file.path}`).join('\n')
+  const worktreeStat = includeUnstaged
+    ? (await git(['diff', '--stat'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
+    : ''
+  const worktreeDiff = includeUnstaged
+    ? (await git(['diff'], context.workspaceRoot, { allowFailure: true })).stdout.toString('utf8')
+    : ''
+  const selectedFiles = includeUnstaged ? status.files : status.files.filter((file) => file.staged)
+  if (!selectedFiles.length) {
+    const error = new Error('No staged changes to summarize')
+    error.statusCode = 400
+    throw error
+  }
+  const files = selectedFiles.map((file) => `- ${file.status}${file.staged ? ' staged' : ''}${file.unstaged ? ' unstaged' : ''}: ${file.oldPath ? `${file.oldPath} -> ` : ''}${file.path}`).join('\n')
   const systemPrompt = `You generate Git commit messages.
 Return only the commit message, no Markdown, no explanation.
 Use Conventional Commit style when possible, for example: feat: add git tools summary.
@@ -640,6 +746,57 @@ async function handleWorkspaceResolvePath(req, res) {
   })
 }
 
+export async function openWorkspaceExternalPath(context, inputPath, target, openers = {}) {
+  const relativePath = typeof inputPath === 'string' ? inputPath.trim() : ''
+  if (!relativePath) {
+    const error = new Error('path is required')
+    error.statusCode = 400
+    throw error
+  }
+  if (target !== 'explorer' && target !== 'vscode' && target !== 'idea') {
+    const error = new Error('target must be explorer, vscode, or idea')
+    error.statusCode = 400
+    throw error
+  }
+
+  const fullPath = resolveWorkspacePath(relativePath, context)
+  await assertSafeWorkspacePath(fullPath, context, {
+    allowSensitive: true,
+    ignoreMissing: true,
+  })
+  const stat = await fs.stat(fullPath).catch(() => null)
+
+  if (target === 'explorer') {
+    const directory = stat?.isDirectory() ? fullPath : path.dirname(fullPath)
+    await assertSafeWorkspacePath(directory, context, { allowSensitive: true })
+    await (openers.explorer ?? openPathInFileManager)(directory)
+    return { ok: true, opened: 'directory', target }
+  }
+
+  if (!stat?.isFile()) {
+    const error = new Error(`File does not exist: ${toWorkspaceRelative(fullPath, context)}`)
+    error.statusCode = 400
+    throw error
+  }
+  const opener = target === 'vscode'
+    ? (openers.vscode ?? openPathInVSCode)
+    : (openers.idea ?? openPathInIDEA)
+  await opener(fullPath)
+  return { ok: true, opened: 'file', target }
+}
+
+async function handleWorkspaceOpenExternal(req, res) {
+  const body = await readJsonBody(req, 16 * 1024)
+  const projectId = typeof body?.projectId === 'string' ? body.projectId : ''
+  if (!projectId) {
+    const error = new Error('projectId is required')
+    error.statusCode = 400
+    throw error
+  }
+  const context = await projectContextFromId(projectId)
+  sendJson(res, 200, await openWorkspaceExternalPath(context, body?.path, body?.target))
+}
+
 async function handleGitStatus(req, res, url) {
   const context = await projectContextFromUrl(url)
   sendJson(res, 200, await listGitStatus(context))
@@ -752,10 +909,40 @@ async function contextFromGitBody(req) {
 
 async function handleGitGenerateCommitMessage(req, res) {
   const { context, body } = await contextFromGitBody(req)
-  const message = await generateGitCommitMessage(context, body?.model, body?.thinkingLevel)
+  const message = await generateGitCommitMessage(context, body?.model, body?.thinkingLevel, Boolean(body?.includeUnstaged))
   sendJson(res, 200, { message })
 }
 
+async function handleGitStage(req, res) {
+  const { context, body } = await contextFromGitBody(req)
+  sendJson(res, 200, await stageGitPath(context, body?.path))
+}
+
+async function handleGitStageAll(req, res) {
+  const { context } = await contextFromGitBody(req)
+  sendJson(res, 200, await stageAllGitChanges(context))
+}
+
+async function handleGitUnstage(req, res) {
+  const { context, body } = await contextFromGitBody(req)
+  sendJson(res, 200, await unstageGitPath(context, body?.path))
+}
+
+async function handleGitUnstageAll(req, res) {
+  const { context } = await contextFromGitBody(req)
+  sendJson(res, 200, await unstageAllGitChanges(context))
+}
+
+async function handleGitRestore(req, res) {
+  const { context, body } = await contextFromGitBody(req)
+  sendJson(res, 200, await restoreGitPath(context, body?.path))
+}
+
+async function handleGitRestoreAll(req, res) {
+  const { context } = await contextFromGitBody(req)
+  sendJson(res, 200, await restoreAllGitChanges(context))
+}
+
 async function handleGitCommit(req, res) {
   const { context, body } = await contextFromGitBody(req)
   sendJson(res, 200, await commitGitChanges(context, body?.message, Boolean(body?.includeUnstaged)))
@@ -766,10 +953,24 @@ async function handleGitPush(req, res) {
   sendJson(res, 200, await pushGitBranch(context))
 }
 
+export async function commitAndPushGitChanges(context, message, includeUnstaged) {
+  const committedStatus = await commitGitChanges(context, message, includeUnstaged)
+  try {
+    const pushedStatus = await pushGitBranch(context)
+    return { ...pushedStatus, committed: true, pushed: true }
+  } catch (error) {
+    return {
+      ...committedStatus,
+      committed: true,
+      pushed: false,
+      pushError: error?.message || 'Push failed',
+    }
+  }
+}
+
 async function handleGitCommitAndPush(req, res) {
   const { context, body } = await contextFromGitBody(req)
-  await commitGitChanges(context, body?.message, Boolean(body?.includeUnstaged))
-  sendJson(res, 200, await pushGitBranch(context))
+  sendJson(res, 200, await commitAndPushGitChanges(context, body?.message, Boolean(body?.includeUnstaged)))
 }
 
 export async function handleWorkspaceApi(req, res, url) {
@@ -789,6 +990,10 @@ export async function handleWorkspaceApi(req, res, url) {
     await handleWorkspaceResolvePath(req, res)
     return
   }
+  if (req.method === 'POST' && url.pathname === '/api/workspace/open-external') {
+    await handleWorkspaceOpenExternal(req, res)
+    return
+  }
 
   const error = new Error('Not found')
   error.statusCode = 404
@@ -824,6 +1029,30 @@ export async function handleGitApi(req, res, url) {
     await handleGitGenerateCommitMessage(req, res)
     return
   }
+  if (req.method === 'POST' && url.pathname === '/api/git/stage') {
+    await handleGitStage(req, res)
+    return
+  }
+  if (req.method === 'POST' && url.pathname === '/api/git/stage-all') {
+    await handleGitStageAll(req, res)
+    return
+  }
+  if (req.method === 'POST' && url.pathname === '/api/git/unstage') {
+    await handleGitUnstage(req, res)
+    return
+  }
+  if (req.method === 'POST' && url.pathname === '/api/git/unstage-all') {
+    await handleGitUnstageAll(req, res)
+    return
+  }
+  if (req.method === 'POST' && url.pathname === '/api/git/restore') {
+    await handleGitRestore(req, res)
+    return
+  }
+  if (req.method === 'POST' && url.pathname === '/api/git/restore-all') {
+    await handleGitRestoreAll(req, res)
+    return
+  }
   if (req.method === 'POST' && url.pathname === '/api/git/commit') {
     await handleGitCommit(req, res)
     return

package/server/storage.mjs

@@ -54,6 +54,7 @@ export const stores = new Set([
   'sessions-metadata',
   'scheduled-tasks',
   'custom-agents',
+  'agent-profile-overrides',
 ])
 
 // --- In-memory session bucket index ---
@@ -84,6 +85,7 @@ const soloConfigStores = {
   settings: 'settings.json',
   mcp: 'mcp-servers.json',
   plugins: 'plugins.json',
+  'agent-profile-overrides': 'agent-profile-overrides.json',
 }
 
 const sharedConfigGroups = {
@@ -184,6 +186,9 @@ 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')
+export const userAgentsDir = path.join(dataDir, 'agents')
+export const builtinAgentsDir = path.join(userAgentsDir, 'builtin')
+export const tempAgentsDir = path.join(cacheDir, 'global', 'tmp', 'agents')
 
 const quickForgeConfigFile = path.join(configDir, 'config.json')
 const configMigrationMarkerFile = path.join(configDir, '.layout-migrated')
@@ -878,6 +883,31 @@ export async function atomicProjectConfigUpdate(updateFn) {
   })
 }
 
+export async function cleanOldTempAgents(retentionMs = 7 * 24 * 60 * 60 * 1000) {
+  try {
+    await fs.mkdir(tempAgentsDir, { recursive: true })
+    const cutoff = Date.now() - retentionMs
+    const sessionDirs = await fs.readdir(tempAgentsDir, { withFileTypes: true }).catch(() => [])
+    for (const sessionDir of sessionDirs) {
+      if (!sessionDir.isDirectory()) continue
+      const sessionPath = path.join(tempAgentsDir, sessionDir.name)
+      const runDirs = await fs.readdir(sessionPath, { withFileTypes: true }).catch(() => [])
+      await Promise.all(runDirs.map(async (runDir) => {
+        if (!runDir.isDirectory()) return
+        const runPath = path.join(sessionPath, runDir.name)
+        try {
+          const stat = await fs.stat(runPath)
+          if (stat.mtimeMs < cutoff) await fs.rm(runPath, { recursive: true, force: true })
+        } catch { /* ignore cleanup errors */ }
+      }))
+      const remaining = await fs.readdir(sessionPath).catch(() => [])
+      if (remaining.length === 0) await fs.rm(sessionPath, { recursive: true, force: true }).catch(() => {})
+    }
+  } catch {
+    // ignore cleanup errors
+  }
+}
+
 // Cached storage-initialization promise.  ensureStorage() is idempotent (mkdir
 // recursive, one-shot migration gated by a marker file, ensureJsonFile), so once
 // it succeeds we can skip the redundant syscalls (~20 per call) every later call
@@ -894,6 +924,9 @@ export function ensureStorage() {
     await Promise.all([
       fs.mkdir(path.join(cacheDir, 'global', 'llm'), { recursive: true }),
       fs.mkdir(path.join(cacheDir, 'global', 'tmp'), { recursive: true }),
+      fs.mkdir(tempAgentsDir, { recursive: true }),
+      fs.mkdir(userAgentsDir, { recursive: true }),
+      fs.mkdir(builtinAgentsDir, { recursive: true }),
       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 }),
@@ -901,6 +934,7 @@ export function ensureStorage() {
       // they share the same file-tool capabilities as project conversations.
       fs.mkdir(path.join(dataDir, 'workspace'), { recursive: true }),
       cleanOldLogs(),
+      cleanOldTempAgents(),
     ])
 
     await migrateUnifiedConfig()

package/server/subagents.mjs

@@ -1,3 +1,8 @@
+import { createHash } from 'node:crypto'
+import { existsSync, promises as fs } from 'node:fs'
+import path from 'node:path'
+import { builtinAgentsDir, ensureStorage } from './storage.mjs'
+
 const commonSubagentRules = `
 You are a focused QuickForge subagent invoked by a parent coding assistant.
 
@@ -23,6 +28,9 @@ export const subagentDefinitions = [
     mode: 'subagent',
     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'],
+    capabilityPolicy: 'code-edit',
+    model: { mode: 'inherit' },
+    lifecycle: 'builtin',
     allowFileMutations: true,
     maxRuntimeMs: 30 * 60 * 1000,
     maxToolCalls: 300,
@@ -34,6 +42,9 @@ export const subagentDefinitions = [
     mode: 'subagent',
     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'],
+    capabilityPolicy: 'readonly-research',
+    model: { mode: 'inherit' },
+    lifecycle: 'builtin',
     allowFileMutations: false,
     maxRuntimeMs: 30 * 60 * 1000,
     maxToolCalls: 300,
@@ -43,6 +54,59 @@ export const subagentDefinitions = [
 
 const subagentByName = new Map(subagentDefinitions.map((definition) => [definition.name, definition]))
 
+function markdownValue(value) {
+  return String(value ?? '').replace(/\r?\n/g, ' ').replace(/"/g, '\\"')
+}
+
+function builtinSubagentMarkdown(definition) {
+  const body = definition.systemPrompt || ''
+  const hash = createHash('sha256').update(JSON.stringify({
+    name: definition.name,
+    label: definition.label,
+    description: definition.description,
+    allowedTools: definition.allowedTools,
+    capabilityPolicy: definition.capabilityPolicy,
+    body,
+  })).digest('hex')
+  return `---
+name: ${definition.name}
+label: "${markdownValue(definition.label || definition.name)}"
+description: "${markdownValue(definition.description || '')}"
+source: builtin
+lifecycle: builtin
+managed: true
+managedBy: quickforge
+managedHash: ${hash}
+enabled-as-subagent: true
+capabilityPolicy: ${definition.capabilityPolicy || 'review-only'}
+tools: ${definition.allowedTools.join(', ')}
+model:
+  mode: inherit
+max-runtime-ms: ${definition.maxRuntimeMs || 30 * 60 * 1000}
+max-tool-calls: ${definition.maxToolCalls || 300}
+---
+${body}
+`
+}
+
+export async function ensureBuiltinSubagentMarkdownFiles() {
+  await ensureStorage()
+  await fs.mkdir(builtinAgentsDir, { recursive: true })
+  await Promise.all(subagentDefinitions.map(async (definition) => {
+    const file = path.join(builtinAgentsDir, `${definition.name}.md`)
+    const content = builtinSubagentMarkdown(definition)
+    if (existsSync(file)) {
+      const current = await fs.readFile(file, 'utf8').catch(() => '')
+      if (current === content) return
+    }
+    await fs.writeFile(file, content, 'utf8')
+  }))
+}
+
+export function builtinSubagentProfilePath(name) {
+  return path.join(builtinAgentsDir, `${String(name || '').trim().toLowerCase()}.md`)
+}
+
 export function listSubagentSummaries() {
   return subagentDefinitions.map(({ name, label, mode, description, allowedTools }) => ({
     name,

package/server/tools/definitions.mjs

@@ -1,6 +1,19 @@
 import { Type } from 'typebox'
 import { loadSelectedGlobalSkills, loadSelectedProjectSkills, mergeSkills } from '../skills.mjs'
 
+const temporarySubagentSchema = Type.Object({
+  type: Type.Literal('temporary'),
+  name: Type.String({ description: 'Temporary subagent name, lowercase ASCII identifier.' }),
+  label: Type.Optional(Type.String({ description: 'Optional display name.' })),
+  description: Type.Optional(Type.String({ description: 'Short description of the temporary subagent.' })),
+  instructions: Type.String({ description: 'System instructions for the temporary subagent.' }),
+  capabilityPolicy: Type.Optional(Type.String({ description: 'Capability policy, defaults to readonly-research.' })),
+  tools: Type.Optional(Type.Array(Type.String({ description: 'Requested built-in tool names, constrained by capabilityPolicy.' }))),
+  model: Type.Optional(Type.Any({ description: 'Model reference. Omit or use { mode: "inherit" } to inherit the parent model.' })),
+  maxRuntimeMs: Type.Optional(Type.Number({ description: 'Optional max runtime in milliseconds.' })),
+  maxToolCalls: Type.Optional(Type.Number({ description: 'Optional max tool-call budget.' })),
+})
+
 // ---------------------------------------------------------------------------
 // Canonical workspace tool definitions.
 // These are the single source of truth for tool metadata (name, label,
@@ -17,7 +30,10 @@ export const subagentTool = {
   label: 'Run subagent',
   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.' }),
+    subagent: Type.Union([
+      Type.String({ description: 'Agent Profile name to invoke.' }),
+      temporarySubagentSchema,
+    ], { description: 'Agent Profile name or an inline temporary subagent spec to create and run once.' }),
     task: Type.String({ description: 'Concrete, bounded task for the subagent. Do not delegate vague or open-ended work.' }),
     context: Type.Optional(Type.String({ description: 'Relevant context from the parent conversation or current plan. Keep this focused.' })),
     expectedOutput: Type.Optional(Type.String({ description: 'Optional output requirements for the subagent result.' })),

package/server/utils/platform.mjs

@@ -186,8 +186,8 @@ export async function openPathInFileManager(targetPath) {
 export async function openPathInVSCode(targetPath) {
   const resolved = path.resolve(String(targetPath || ''))
   const stat = await fs.stat(resolved).catch(() => null)
-  if (!stat || !stat.isDirectory()) {
-    const error = new Error(`Directory does not exist: ${resolved}`)
+  if (!stat || (!stat.isDirectory() && !stat.isFile())) {
+    const error = new Error(`Path does not exist: ${resolved}`)
     error.statusCode = 400
     throw error
   }
@@ -234,8 +234,8 @@ export async function openPathInVSCode(targetPath) {
 export async function openPathInIDEA(targetPath) {
   const resolved = path.resolve(String(targetPath || ''))
   const stat = await fs.stat(resolved).catch(() => null)
-  if (!stat || !stat.isDirectory()) {
-    const error = new Error(`Directory does not exist: ${resolved}`)
+  if (!stat || (!stat.isDirectory() && !stat.isFile())) {
+    const error = new Error(`Path does not exist: ${resolved}`)
     error.statusCode = 400
     throw error
   }

package/dist/assets/AgentProfilesPage-R7N7eDq5.js

@@ -1 +0,0 @@
-import{i as e}from"./rolldown-runtime-DWdDZTNf.js";import{E as t,Ft as n,Nt as r,Rt as i,a,l as o,lt as s}from"./icons-DHoaB5uq.js";import{n as c}from"./react-vendor-BR9MG2D-.js";import{F as l,G as u,J as d,K as f,Y as p,nt as m,q as h,rt as g,st as _,tt as v}from"./index-CZb_mGGF.js";var y=e(i(),1),b=c();function x(){return{name:``,label:``,description:``,systemPrompt:``,allowedTools:[`read_file`,`grep_files`],maxRuntimeMs:`1800000`,maxToolCalls:`300`,enabledAsSubagent:!0}}function S(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 C(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 w(e){return!!(e.name.trim()&&e.label.trim()&&e.allowedTools.length>0)}async function T(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 E(){let[e,i]=(0,y.useState)([]),[c,E]=(0,y.useState)([]),[D,O]=(0,y.useState)(!1),[k,A]=(0,y.useState)(null),[j,M]=(0,y.useState)(()=>x()),[N,P]=(0,y.useState)(!1),[F,I]=(0,y.useState)(``),[L,R]=(0,y.useState)(!1),[z,B]=(0,y.useState)(),[V,H]=(0,y.useState)(`off`),[U,W]=(0,y.useState)(``),[G,K]=(0,y.useState)(null);async function q(){let[e,t]=await Promise.all([T(`/api/agent-profiles`),T(`/api/agent-profiles/available-tools`)]);i(e.agents),E(t.tools)}(0,y.useEffect)(()=>{let e=!1;async function t(){try{let[t,n]=await Promise.all([T(`/api/agent-profiles`),T(`/api/agent-profiles/available-tools`)]);if(e)return;i(t.agents),E(n.tools)}catch(t){e||W(t instanceof Error?t.message:_(`requestFailed`))}}return t(),()=>{e=!0}},[]),(0,y.useEffect)(()=>{let e=!1;async function t(){try{let t=await h(),n=await f(t),r=await d(t),i=r.model??await p(t)??n[0];if(e)return;B(i),H(r.thinkingLevel??u(i))}catch{}}return t(),()=>{e=!0}},[]),(0,y.useEffect)(()=>{if(!G)return;let e=()=>K(null);return window.addEventListener(`click`,e),window.addEventListener(`blur`,e),()=>{window.removeEventListener(`click`,e),window.removeEventListener(`blur`,e)}},[G]);let J=(0,y.useMemo)(()=>e.find(e=>e.id===k)??null,[e,k]);function Y(e,t){M(n=>({...n,[e]:t}))}function X(e){M(t=>({...t,allowedTools:t.allowedTools.includes(e)?t.allowedTools.filter(t=>t!==e):[...t.allowedTools,e]}))}function Z(){A(null),M(x()),I(``),W(``),O(!0)}function Q(e){A(e.id),M(S(e)),I(``),W(``),O(!0)}function $(){N||L||(O(!1),A(null),M(x()),I(``))}async function ee(){let e=F.trim();if(!e){W(_(`aiFillAgentInputRequired`));return}if(!z){W(_(`aiFillAgentNoModel`));return}R(!0),W(``);try{let t=await T(`/api/agent-profiles/ai-fill`,{method:`POST`,body:JSON.stringify({instruction:e,model:z,thinkingLevel:V})});M(e=>({...e,name:t.agent.name,label:t.agent.label,description:t.agent.description,systemPrompt:t.agent.systemPrompt}))}catch(e){W(e instanceof Error?e.message:_(`aiFillAgentFailed`))}finally{R(!1)}}async function te(){if(w(j)){P(!0),W(``);try{let e=C(j);k?await T(`/api/agent-profiles/${encodeURIComponent(k)}`,{method:`PATCH`,body:JSON.stringify(e)}):await T(`/api/agent-profiles`,{method:`POST`,body:JSON.stringify(e)}),$(),await q()}catch(e){W(e instanceof Error?e.message:_(`requestFailed`))}finally{P(!1)}}}async function ne(e){if(e.builtin||e.readonly)return;let t=!e.enabledAsSubagent,n=e.enabledAsSubagent;i(n=>n.map(n=>n.id===e.id?{...n,enabledAsSubagent:t}:n)),K(null);try{await T(`/api/agent-profiles/${encodeURIComponent(e.id)}`,{method:`PATCH`,body:JSON.stringify({enabledAsSubagent:t})})}catch(t){i(t=>t.map(t=>t.id===e.id?{...t,enabledAsSubagent:n}:t)),W(t instanceof Error?t.message:_(`requestFailed`))}}async function re(e){if(!(e.builtin||e.readonly)&&await l({description:_(`confirmDeleteAgent`),confirmLabel:_(`confirmDelete`),cancelLabel:_(`cancel`),variant:`destructive`})){W(``);try{await T(`/api/agent-profiles/${encodeURIComponent(e.id)}`,{method:`DELETE`}),await q()}catch(e){W(e instanceof Error?e.message:_(`requestFailed`))}}}return D?(0,b.jsxs)(`div`,{className:`quickforge-settings-stack`,children:[(0,b.jsx)(`div`,{className:`quickforge-settings-heading`,children:(0,b.jsxs)(`h3`,{className:`quickforge-settings-title`,children:[_(J?`editAgent`:`createAgent`),(0,b.jsx)(v,{label:J?.readonly?_(`builtinAgentReadonly`):_(`agentsDescription`)})]})}),(0,b.jsxs)(`section`,{className:`quickforge-settings-section`,"aria-label":_(J?`editAgent`:`createAgent`),children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-toolbar`,children:[(0,b.jsxs)(`button`,{className:`quickforge-settings-button quickforge-settings-button-secondary`,type:`button`,onClick:$,disabled:N||L,children:[(0,b.jsx)(n,{className:`mr-2 size-4`}),_(`back`)]}),(0,b.jsxs)(`div`,{className:`quickforge-settings-row-main`,children:[(0,b.jsx)(`div`,{className:`quickforge-settings-row-title`,children:_(J?`editAgent`:`createAgent`)}),J?.readonly?(0,b.jsx)(`div`,{className:`quickforge-settings-row-description`,children:_(`builtinAgentReadonly`)}):null]})]}),(0,b.jsx)(`div`,{className:`px-5 py-4`,children:(0,b.jsxs)(`div`,{className:`space-y-4`,children:[(0,b.jsxs)(`div`,{className:`rounded-2xl border border-border bg-muted/20 p-3`,children:[(0,b.jsxs)(`div`,{className:`mb-2 flex items-center gap-2 text-sm font-medium text-foreground`,children:[(0,b.jsx)(o,{className:`size-4 text-primary`}),_(`aiFillAgent`),(0,b.jsx)(v,{label:_(`aiFillAgentDescription`)})]}),(0,b.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:F,disabled:!!J?.readonly||L,onChange:e=>I(e.target.value),placeholder:_(`aiFillAgentPlaceholder`)}),(0,b.jsx)(`div`,{className:`mt-2 flex justify-end`,children:(0,b.jsxs)(m,{variant:`outline`,size:`sm`,onClick:()=>void ee(),disabled:!!J?.readonly||L||!F.trim(),children:[(0,b.jsx)(o,{className:`mr-1 size-3.5`}),_(L?`aiFillAgentLoading`:`aiFillAgent`)]})})]}),(0,b.jsxs)(`div`,{className:`grid gap-3 sm:grid-cols-2`,children:[(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`agentName`),(0,b.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:j.name,disabled:!!J?.readonly,onChange:e=>Y(`name`,e.target.value),placeholder:`reviewer`})]}),(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`agentLabel`),(0,b.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:j.label,disabled:!!J?.readonly,onChange:e=>Y(`label`,e.target.value),placeholder:_(`agentLabelPlaceholder`)})]})]}),(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`agentDescription`),(0,b.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:j.description,disabled:!!J?.readonly,onChange:e=>Y(`description`,e.target.value)})]}),(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`agentSystemPrompt`),(0,b.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:j.systemPrompt,disabled:!!J?.readonly,onChange:e=>Y(`systemPrompt`,e.target.value)})]}),(0,b.jsxs)(`div`,{children:[(0,b.jsx)(`div`,{className:`mb-2 text-sm font-medium text-foreground`,children:_(`allowedTools`)}),(0,b.jsx)(`div`,{className:`grid gap-2 sm:grid-cols-2`,children:c.map(e=>(0,b.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,b.jsx)(`input`,{type:`checkbox`,className:`mt-1`,disabled:!!J?.readonly,checked:j.allowedTools.includes(e.name),onChange:()=>X(e.name)}),(0,b.jsxs)(`span`,{children:[(0,b.jsx)(`span`,{className:`font-medium text-foreground`,children:e.label}),(0,b.jsx)(`span`,{className:`ml-2 font-mono text-xs text-muted-foreground`,children:e.name}),e.riskLevel===`dangerous`?(0,b.jsx)(`span`,{className:`ml-2 rounded-full bg-amber-500/10 px-2 py-0.5 text-xs text-amber-700`,children:_(`highRiskTool`)}):null,(0,b.jsx)(`span`,{className:`mt-1 block text-xs text-muted-foreground`,children:e.description})]})]},e.name))})]}),(0,b.jsxs)(`div`,{className:`grid gap-3 sm:grid-cols-2`,children:[(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`maxRuntimeMs`),(0,b.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:j.maxRuntimeMs,disabled:!!J?.readonly,onChange:e=>Y(`maxRuntimeMs`,e.target.value)})]}),(0,b.jsxs)(`label`,{className:`block text-sm font-medium text-foreground`,children:[_(`maxToolCalls`),(0,b.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:j.maxToolCalls,disabled:!!J?.readonly,onChange:e=>Y(`maxToolCalls`,e.target.value)})]})]}),(0,b.jsxs)(`label`,{className:`flex items-center gap-2 text-sm text-foreground`,children:[(0,b.jsx)(`input`,{type:`checkbox`,checked:j.enabledAsSubagent,disabled:!!J?.readonly,onChange:e=>Y(`enabledAsSubagent`,e.target.checked)}),_(`enabledAsSubagent`)]}),U?(0,b.jsx)(`div`,{className:`rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive`,children:U}):null]})}),(0,b.jsxs)(`div`,{className:`quickforge-settings-divider flex justify-end gap-2 px-5 py-4`,children:[(0,b.jsx)(m,{variant:`outline`,onClick:$,disabled:N||L,children:_(`cancel`)}),(0,b.jsx)(m,{onClick:te,disabled:N||L||!!J?.readonly||!w(j),children:_(`save`)})]})]})]}):(0,b.jsx)(`div`,{className:`quickforge-settings-stack`,children:(0,b.jsxs)(`section`,{className:`quickforge-settings-section`,"aria-label":_(`agentsTab`),children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-toolbar`,children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-row-main`,children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-row-title`,children:[(0,b.jsx)(r,{className:`size-4 text-primary`}),_(`agentsTab`)]}),(0,b.jsx)(`div`,{className:`quickforge-settings-row-description`,children:_(`agentsDescription`)})]}),(0,b.jsx)(`button`,{className:`quickforge-settings-button quickforge-settings-button-primary`,type:`button`,onClick:Z,children:_(`createAgent`)})]}),U?(0,b.jsx)(`div`,{className:`quickforge-settings-alert quickforge-settings-warning-attached`,children:U}):null,e.length===0?(0,b.jsx)(`div`,{className:`quickforge-settings-empty-row`,children:_(`loading`)}):e.map(e=>(0,b.jsxs)(`div`,{className:`quickforge-settings-list-item`,children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-list-item-main`,children:[(0,b.jsxs)(`div`,{className:`quickforge-settings-row-title`,children:[e.label,e.builtin?(0,b.jsx)(`span`,{className:`quickforge-settings-badge quickforge-settings-badge-info`,children:_(`builtinAgent`)}):null,(0,b.jsx)(`span`,{className:g(`quickforge-settings-badge`,e.enabledAsSubagent?`quickforge-settings-badge-success`:`quickforge-settings-badge-muted`),children:e.enabledAsSubagent?_(`enabled`):_(`disabled`)})]}),(0,b.jsx)(`div`,{className:`quickforge-settings-row-description quickforge-settings-mono`,children:e.name}),e.source&&!e.builtin?(0,b.jsxs)(`div`,{className:`quickforge-settings-row-description`,children:[e.source,e.relativePath?` · ${e.relativePath}`:``]}):null,(0,b.jsx)(`div`,{className:`quickforge-settings-row-description`,children:e.description||_(`noDescription`)}),(0,b.jsx)(`div`,{className:`quickforge-settings-meta`,children:e.allowedTools.map(e=>(0,b.jsx)(`code`,{className:`quickforge-settings-command-name`,children:e},e))}),(0,b.jsxs)(`div`,{className:`quickforge-settings-meta`,children:[(0,b.jsxs)(`span`,{className:`quickforge-settings-badge quickforge-settings-badge-muted`,children:[_(`maxRuntimeMs`),e.maxRuntimeMs??`-`]}),(0,b.jsxs)(`span`,{className:`quickforge-settings-badge quickforge-settings-badge-muted`,children:[_(`maxToolCalls`),e.maxToolCalls??`-`]})]})]}),(0,b.jsxs)(`div`,{className:`quickforge-settings-list-item-actions`,onClick:e=>e.stopPropagation(),children:[(0,b.jsxs)(`label`,{className:`quickforge-settings-switch`,"aria-disabled":e.builtin||e.readonly?`true`:`false`,title:e.enabledAsSubagent?_(`disableAsSubagent`):_(`enableAsSubagent`),children:[(0,b.jsx)(`input`,{type:`checkbox`,checked:e.enabledAsSubagent,disabled:e.builtin||e.readonly,onChange:()=>void ne(e)}),(0,b.jsx)(`span`,{"aria-hidden":`true`})]}),(0,b.jsxs)(`div`,{className:`relative`,children:[(0,b.jsx)(`button`,{className:`quickforge-settings-icon-action`,type:`button`,onClick:()=>K(G===e.id?null:e.id),title:_(`moreActions`),children:(0,b.jsx)(s,{className:`size-4`})}),G===e.id?(0,b.jsxs)(`div`,{className:`absolute right-0 z-20 mt-1 w-36 overflow-hidden rounded-xl border border-border bg-popover py-1 text-sm shadow-quickforge`,children:[(0,b.jsxs)(`button`,{className:`flex w-full items-center gap-2 px-3 py-2 text-left hover:bg-muted disabled:cursor-not-allowed disabled:opacity-50`,disabled:e.builtin||e.readonly,onClick:()=>{K(null),Q(e)},children:[(0,b.jsx)(t,{className:`size-3.5`}),_(`editTask`)]}),(0,b.jsxs)(`button`,{className:`flex w-full items-center gap-2 px-3 py-2 text-left text-destructive hover:bg-muted disabled:cursor-not-allowed disabled:opacity-50`,disabled:e.builtin||e.readonly,onClick:()=>{K(null),re(e)},children:[(0,b.jsx)(a,{className:`size-3.5`}),_(`delete`)]})]}):null]})]})]},e.id))]})})}export{E as AgentProfilesPage};