@shawnstack/quickforge 1.6.12 → 1.7.0

package/server/conversation-compaction.mjs

@@ -6,6 +6,16 @@ import { cacheDir } from './storage.mjs'
 export const DEFAULT_COMPACT_KEEP_TURNS = 0
 const MAX_COMPACT_KEEP_TURNS = 20
 const MIN_SUMMARY_SOURCE_CHARS = 1600
+const COMPACT_SUMMARY_OPEN_TAG = '<compact_summary>'
+const COMPACT_SUMMARY_CLOSE_TAG = '</compact_summary>'
+const COMPACTION_DETAILS_KEY = 'quickforgeCompaction'
+const LEGACY_COMPACT_SUMMARY_INTROS = [
+  'The previous conversation has been compacted.',
+  'The previous conversation has been automatically compacted.',
+  'Existing rolling compact summary from earlier conversation history:',
+]
+const LEGACY_COMPACTION_NOTICE_PREFIX = '已基于当前对话创建压缩后的新对话：'
+const LEGACY_COMPACTION_NOTICE_SUFFIX = '压缩前历史已保存到本地备份。'
 
 export const COMPACT_SYSTEM_PROMPT = `你是 QuickForge 的“历史对话压缩器”。你的任务是把一段较长的 AI 助手对话压缩成后续模型继续工作所需的最小充分上下文。
 
@@ -72,8 +82,60 @@ function normalizeKeepTurns(value) {
   return Math.min(MAX_COMPACT_KEEP_TURNS, Math.max(0, Math.floor(parsed)))
 }
 
+function messageContentText(message) {
+  const content = message?.content
+  if (typeof content === 'string') return content
+  if (!Array.isArray(content)) return ''
+  return content
+    .filter((block) => block?.type === 'text' && typeof block.text === 'string')
+    .map((block) => block.text)
+    .join('\n')
+}
+
+function compactionMessageKind(message) {
+  const kind = message?.details?.[COMPACTION_DETAILS_KEY]?.kind
+  if (kind === 'summary' || kind === 'notice') return kind
+
+  const text = messageContentText(message).trim()
+  if (
+    message?.role === 'user'
+    && LEGACY_COMPACT_SUMMARY_INTROS.some((intro) => text.startsWith(intro))
+    && text.includes(COMPACT_SUMMARY_OPEN_TAG)
+    && text.lastIndexOf(COMPACT_SUMMARY_CLOSE_TAG) > text.indexOf(COMPACT_SUMMARY_OPEN_TAG)
+  ) return 'summary'
+
+  if (
+    message?.role === 'assistant'
+    && text.startsWith(LEGACY_COMPACTION_NOTICE_PREFIX)
+    && text.includes(LEGACY_COMPACTION_NOTICE_SUFFIX)
+  ) return 'notice'
+
+  return null
+}
+
+export function compactionMessageDetails(kind) {
+  return { [COMPACTION_DETAILS_KEY]: { version: 1, kind } }
+}
+
+export function isCompactSummaryMessage(message) {
+  return compactionMessageKind(message) === 'summary'
+}
+
+export function isCompactionNoticeMessage(message) {
+  return compactionMessageKind(message) === 'notice'
+}
+
+export function extractCompactSummaryText(message) {
+  const text = messageContentText(message).trim()
+  const openIndex = text.indexOf(COMPACT_SUMMARY_OPEN_TAG)
+  const closeIndex = text.lastIndexOf(COMPACT_SUMMARY_CLOSE_TAG)
+  if (openIndex < 0 || closeIndex <= openIndex) return text
+  return text.slice(openIndex + COMPACT_SUMMARY_OPEN_TAG.length, closeIndex).trim()
+}
+
 function isUserMessage(message) {
-  return message?.role === 'user' || message?.role === 'user-with-attachments'
+  return (message?.role === 'user' || message?.role === 'user-with-attachments')
+    && !isCompactSummaryMessage(message)
 }
 
 function truncateMiddle(value, maxLength) {
@@ -200,7 +262,7 @@ export function splitMessagesForCompaction(messages, options = {}) {
   if (keepTurns <= 0) {
     return {
       keepTurns,
-      compactRange: sourceMessages.slice(),
+      compactRange: sourceMessages.filter((message) => !isCompactionNoticeMessage(message)),
       recentTail: [],
       tailStart: sourceMessages.length,
     }
@@ -219,9 +281,13 @@ export function splitMessagesForCompaction(messages, options = {}) {
 
   if (seenUserTurns < keepTurns) tailStart = 0
 
+  const compactRange = sourceMessages
+    .slice(0, tailStart)
+    .filter((message) => !isCompactionNoticeMessage(message))
+
   return {
     keepTurns,
-    compactRange: sourceMessages.slice(0, tailStart),
+    compactRange,
     recentTail: sourceMessages.slice(tailStart),
     tailStart,
   }

package/server/custom-commands.mjs

@@ -15,6 +15,12 @@ const commandNamePattern = /^(?!.*--)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/
  * `description` values here.
  */
 const builtinCommandCatalog = [
+  {
+    name: 'init',
+    description: 'Generate or update a concise AGENTS.md contributor guide for the current repository.',
+    argumentHint: '',
+    permissionNote: 'may edit files and run commands',
+  },
   {
     name: 'plan',
     description: 'Create a plan first; this turn cannot edit files or run commands.',
@@ -367,6 +373,8 @@ export function parseInternalCommandInvocation(message) {
   const text = textFromUserMessage(message).trim()
   if (/^\/(?:help|\?)(?:\s+.*)?$/i.test(text)) return { type: 'help' }
   if (/^\/commands(?:\s+.*)?$/i.test(text)) return { type: 'list' }
+  if (/^\/init\s*$/i.test(text)) return { type: 'init' }
+  if (/^\/init(?:\s+[\s\S]+)$/i.test(text)) return { type: 'invalid-init-args' }
   if (/^\/clear\s*$/i.test(text)) return { type: 'clear' }
   if (/^\/clear(?:\s+[\s\S]+)$/i.test(text)) return { type: 'invalid-clear-args' }
 
@@ -407,6 +415,15 @@ export async function handleInternalCommand(invocation, workspaceRoot, commandDi
     return { plan: true, args: invocation.args }
   }
 
+  if (invocation.type === 'init') {
+    if (!workspaceRoot) return 'Initialization requires an active project chat.'
+    return { init: true }
+  }
+
+  if (invocation.type === 'invalid-init-args') {
+    return 'Usage: /init'
+  }
+
   if (invocation.type === 'review') {
     if (!workspaceRoot) return 'Review requires an active project chat.'
     return { review: true, args: invocation.args || '' }

package/server/image-generation.mjs

@@ -0,0 +1,130 @@
+import { builtinImagesModels } from '@earendil-works/pi-ai/providers/all'
+import { resolveOpenRouterConfig } from './provider-config.mjs'
+import { deleteSessionAsset, writeSessionAsset } from './session-assets.mjs'
+
+export const DEFAULT_IMAGE_MODEL = 'google/gemini-2.5-flash-image'
+export const MAX_GENERATED_IMAGES = 4
+export const MAX_GENERATED_IMAGE_BYTES = 50 * 1024 * 1024
+
+function requestError(message, statusCode = 400) {
+  const error = new Error(message)
+  error.statusCode = statusCode
+  return error
+}
+
+function normalizeBucket(value) {
+  if (value?.scope === 'project') return { scope: 'project', projectId: value.projectId }
+  return { scope: 'global' }
+}
+
+function resolveImagesModels(runtime) {
+  const candidate = runtime.imagesModels
+  if (candidate && typeof candidate.getModel === 'function') return candidate
+  if (typeof candidate === 'function') return candidate()
+  return builtinImagesModels()
+}
+
+function imageByteLength(data) {
+  const normalized = typeof data === 'string' ? data.replace(/\s+/g, '') : ''
+  if (!normalized || normalized.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(normalized)) {
+    throw requestError('Image provider returned invalid base64 data')
+  }
+  const buffer = Buffer.from(normalized, 'base64')
+  if (buffer.toString('base64') !== normalized) {
+    throw requestError('Image provider returned invalid base64 data')
+  }
+  return buffer.byteLength
+}
+
+function resultText(output) {
+  return output
+    .filter((item) => item?.type === 'text' && typeof item.text === 'string' && item.text.trim())
+    .map((item) => item.text.trim())
+    .join('\n\n')
+}
+
+function contentSummary(count, text) {
+  const generated = `Generated ${count} image${count === 1 ? '' : 's'}.`
+  return text ? `${generated}\n\n${text}` : generated
+}
+
+export async function generateSessionImages(params, context = {}, runtime = {}) {
+  const prompt = typeof params?.prompt === 'string' ? params.prompt.trim() : ''
+  if (!prompt) throw requestError('prompt is required')
+
+  const sessionId = typeof context.sessionId === 'string' ? context.sessionId : params?.sessionId
+  if (!sessionId) throw requestError('sessionId is required')
+  const bucket = normalizeBucket(context.bucket || context.sessionBucket || params?.bucket || {
+    scope: context.scope,
+    projectId: context.projectId,
+  })
+  const requestedModel = typeof params?.model === 'string' && params.model.trim()
+    ? params.model.trim()
+    : DEFAULT_IMAGE_MODEL
+
+  const imagesModels = resolveImagesModels(runtime)
+  const model = imagesModels.getModel('openrouter', requestedModel)
+  if (!model || model.api !== 'openrouter-images') {
+    throw requestError(`Unsupported image model: ${requestedModel}`)
+  }
+
+  const resolveConfig = runtime.resolveOpenRouterConfig || resolveOpenRouterConfig
+  const config = await resolveConfig(runtime)
+  const requestModel = config.baseUrl ? { ...model, baseUrl: config.baseUrl } : model
+  const response = await imagesModels.generateImages(
+    requestModel,
+    { input: [{ type: 'text', text: prompt }] },
+    {
+      apiKey: config.apiKey,
+      ...(config.headers ? { headers: config.headers } : {}),
+      ...(runtime.signal || context.signal ? { signal: runtime.signal || context.signal } : {}),
+    },
+  )
+
+  if (response?.stopReason !== 'stop') {
+    throw new Error(response?.errorMessage || `Image generation stopped: ${response?.stopReason || 'unknown'}`)
+  }
+
+  const output = Array.isArray(response.output) ? response.output : []
+  const images = output.filter((item) => item?.type === 'image')
+  if (!images.length) throw new Error('Image generation returned no images')
+  if (images.length > MAX_GENERATED_IMAGES) {
+    throw requestError(`Image generation returned more than ${MAX_GENERATED_IMAGES} images`, 413)
+  }
+
+  let totalBytes = 0
+  for (const image of images) {
+    totalBytes += imageByteLength(image.data)
+    if (totalBytes > MAX_GENERATED_IMAGE_BYTES) {
+      throw requestError(`Generated images exceed the ${MAX_GENERATED_IMAGE_BYTES} byte limit`, 413)
+    }
+  }
+
+  const writeAsset = runtime.writeSessionAsset || writeSessionAsset
+  const deleteAsset = runtime.deleteSessionAsset || deleteSessionAsset
+  const assets = []
+  try {
+    for (const image of images) {
+      assets.push(await writeAsset(bucket, sessionId, image))
+    }
+  } catch (error) {
+    await Promise.allSettled(assets.map((asset) => deleteAsset(bucket, sessionId, asset.assetId)))
+    throw error
+  }
+
+  const text = resultText(output)
+  return {
+    content: contentSummary(assets.length, text),
+    details: {
+      type: 'generated_image_result',
+      sessionId,
+      prompt,
+      model: requestedModel,
+      assets,
+      text,
+      usage: response.usage,
+    },
+  }
+}
+
+export const generateImages = generateSessionImages

package/server/index.mjs

@@ -19,10 +19,12 @@ import { handleSkillsApi } from './routes/skills.mjs'
 import { handleAgentApi } from './routes/agent.mjs'
 import { handleAgentProfilesApi } from './routes/agent-profiles.mjs'
 import { handleScheduledTasksApi, startScheduledTaskRunner, stopScheduledTaskRunner } from './routes/scheduled-tasks.mjs'
+import { startAutoArchiveRunner, stopAutoArchiveRunner } from './auto-archive.mjs'
 import { handleBackupApi } from './routes/backup.mjs'
 import { handleSystemApi } from './routes/system.mjs'
 import { handleSharesApi } from './routes/shares.mjs'
 import { handleSharedConversationApi } from './routes/shared-conversation.mjs'
+import { handleSessionAssetsApi } from './routes/session-assets.mjs'
 import { handleLanAccessApi, renderLanUnlockPage } from './routes/lan-access.mjs'
 import { handleMcpApi } from './routes/mcp.mjs'
 import { handlePluginsApi } from './routes/plugins.mjs'
@@ -146,6 +148,7 @@ async function performRestart() {
   logger.info(`Restart supervisor started (PID ${supervisorPid}).`)
 
   stopScheduledTaskRunner()
+  stopAutoArchiveRunner()
   stopVite()
   await shutdownAgentManager()
   await shutdownMcpConnections()
@@ -220,6 +223,7 @@ function spawnUpdateSupervisor(update) {
 async function shutdownForUpdate() {
   logger.info('Shutting down QuickForge for external updater.')
   stopScheduledTaskRunner()
+  stopAutoArchiveRunner()
   stopVite()
   await shutdownAgentManager()
   await shutdownMcpConnections()
@@ -288,6 +292,11 @@ async function handleApi(req, res, url) {
     return
   }
 
+  if (pathname.startsWith('/api/session-assets/')) {
+    await handleSessionAssetsApi(req, res, url)
+    return
+  }
+
   if (pathname === '/api/lan-access/status' || pathname === '/api/lan-access/settings' || pathname === '/api/lan-access/unlock' || pathname === '/api/lan-access/logout' || pathname === '/api/lan-access/revoke-all') {
     await handleLanAccessApi(req, res, url, {
       port,
@@ -364,7 +373,7 @@ async function handleApi(req, res, url) {
   }
 
   // Project workspace inspector routes
-  if (pathname === '/api/workspace/tree' || pathname === '/api/workspace/file' || pathname === '/api/workspace/resolve-path' || pathname.startsWith('/api/workspace/preview/')) {
+  if (pathname === '/api/workspace/tree' || pathname === '/api/workspace/file' || pathname === '/api/workspace/resolve-path' || pathname === '/api/workspace/open-external' || pathname.startsWith('/api/workspace/preview/')) {
     await handleWorkspaceApi(req, res, url)
     return
   }
@@ -665,6 +674,7 @@ await resetStaleTaskStatuses()
 await initializeActiveProject()
 setActiveWorkspaceRootForFilesystem(getWorkspaceRoot())
 startScheduledTaskRunner()
+startAutoArchiveRunner()
 
 server.on('error', (error) => {
   // Handle listen errors (most commonly EADDRINUSE). Without this, Node would
@@ -703,6 +713,7 @@ server.listen(port, host, () => {
 async function gracefulShutdown(signal) {
   logger.info(`Received ${signal}, shutting down gracefully...`)
   stopScheduledTaskRunner()
+  stopAutoArchiveRunner()
   stopVite()
   await shutdownAgentManager()
   await shutdownMcpConnections()

package/server/provider-config.mjs

@@ -0,0 +1,78 @@
+import { readStore } from './storage.mjs'
+
+const DEFAULT_OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1'
+
+function requestError(message, statusCode = 400) {
+  const error = new Error(message)
+  error.statusCode = statusCode
+  return error
+}
+
+function providersFromStore(store) {
+  return Array.isArray(store)
+    ? store
+    : Object.entries(store || {}).map(([id, provider]) => (
+        provider && typeof provider === 'object' ? { id, ...provider } : provider
+      ))
+}
+
+function isOpenRouterProvider(provider) {
+  if (!provider || typeof provider !== 'object') return false
+  const id = String(provider.id || '').trim().toLowerCase()
+  const name = String(provider.name || '').trim().toLowerCase()
+  if (id === 'openrouter' || name === 'openrouter') return true
+
+  try {
+    return new URL(String(provider.baseUrl || '')).hostname.toLowerCase() === 'openrouter.ai'
+  } catch {
+    return false
+  }
+}
+
+function normalizeHeaders(provider) {
+  const source = provider?.headers || provider?.models?.find((model) => model?.headers)?.headers
+  if (!source || typeof source !== 'object' || Array.isArray(source)) return undefined
+  const headers = {}
+  for (const [key, value] of Object.entries(source)) {
+    if (typeof value === 'string' && key.trim()) headers[key.trim()] = value
+  }
+  return Object.keys(headers).length ? headers : undefined
+}
+
+function findProviderKey(keys, providerName) {
+  if (!keys || typeof keys !== 'object' || Array.isArray(keys)) return undefined
+  if (typeof keys[providerName] === 'string' && keys[providerName].trim()) return keys[providerName].trim()
+
+  const wanted = String(providerName || '').trim().toLowerCase()
+  for (const [key, value] of Object.entries(keys)) {
+    const normalized = key.trim().toLowerCase()
+    if ((normalized === wanted || normalized === 'openrouter') && typeof value === 'string' && value.trim()) {
+      return value.trim()
+    }
+  }
+  return undefined
+}
+
+export async function resolveOpenRouterConfig(runtime = {}) {
+  const read = runtime.readStore || readStore
+  const [providerStore, providerKeys] = await Promise.all([
+    read('custom-providers'),
+    read('provider-keys'),
+  ])
+  const provider = providersFromStore(providerStore).find(isOpenRouterProvider)
+  if (!provider) throw requestError('OpenRouter provider is not configured')
+
+  const providerName = String(provider.name || provider.id || 'openrouter').trim()
+  const apiKey = findProviderKey(providerKeys, providerName)
+  if (!apiKey) throw requestError('OpenRouter API key is not configured')
+
+  const baseUrl = typeof provider.baseUrl === 'string' && provider.baseUrl.trim()
+    ? provider.baseUrl.trim().replace(/\/$/, '')
+    : DEFAULT_OPENROUTER_BASE_URL
+
+  return {
+    apiKey,
+    baseUrl,
+    headers: normalizeHeaders(provider),
+  }
+}

package/server/routes/agent.mjs

@@ -16,6 +16,7 @@ import {
   touchSession,
   listSessions,
   updateSessionAccessMode,
+  updateSessionTitle,
   updateSessionYoloMode,
   updateSessionModel,
   updateSessionThinkingLevel,
@@ -153,6 +154,14 @@ export async function handleAgentApi(req, res, url) {
     return
   }
 
+  // POST /api/agents/:sessionId/title — update the authoritative session title
+  if (req.method === 'POST' && subPath === 'title') {
+    const body = await readJsonBody(req)
+    const result = await updateSessionTitle(sessionId, body?.title)
+    sendJson(res, 200, result)
+    return
+  }
+
   // POST /api/agents/:sessionId/access-mode — update session Agent access mode
   if (req.method === 'POST' && subPath === 'access-mode') {
     const body = await readJsonBody(req)

package/server/routes/session-assets.mjs

@@ -0,0 +1,49 @@
+import { findSessionBucket } from '../storage.mjs'
+import { readSessionAsset } from '../session-assets.mjs'
+import { decodeSegment } from '../utils/response.mjs'
+
+function notFound(message = 'Image asset not found') {
+  const error = new Error(message)
+  error.statusCode = 404
+  return error
+}
+
+export async function sendSessionAsset(res, bucket, sessionId, assetId) {
+  let asset
+  try {
+    asset = await readSessionAsset(bucket, sessionId, assetId)
+  } catch (error) {
+    if (error?.code === 'ENOENT') throw notFound()
+    throw error
+  }
+
+  res.writeHead(200, {
+    'content-type': asset.mimeType,
+    'content-length': String(asset.size),
+    'cache-control': 'private, max-age=31536000, immutable',
+    'content-disposition': 'inline',
+    'x-content-type-options': 'nosniff',
+  })
+  res.end(asset.data)
+}
+
+export async function handleSessionAssetsApi(req, res, url) {
+  if (req.method !== 'GET') {
+    const error = new Error('Session asset endpoints require GET')
+    error.statusCode = 405
+    throw error
+  }
+
+  const parts = url.pathname.split('/').filter(Boolean)
+  const sessionId = decodeSegment(parts[2])
+  const assetId = decodeSegment(parts[3])
+  if (!sessionId || !assetId || parts.length !== 4) {
+    const error = new Error('Missing session image asset path')
+    error.statusCode = 400
+    throw error
+  }
+
+  const bucket = await findSessionBucket(sessionId)
+  if (!bucket) throw notFound('Session not found')
+  await sendSessionAsset(res, bucket, sessionId, assetId)
+}

package/server/routes/shared-conversation.mjs

@@ -1,5 +1,6 @@
 import { sendJson, readJsonBody, decodeSegment } from '../utils/response.mjs'
 import { readSessionValue, readStore } from '../storage.mjs'
+import { sendSessionAsset } from './session-assets.mjs'
 import { abortRun, restoreAgent, runPrompt, getSessionState, getSessionEventBus, updateSessionModel, updateSessionThinkingLevel } from '../agent-manager.mjs'
 import {
   assertShareActive,
@@ -307,6 +308,7 @@ export async function handleSharedConversationApi(req, res, url) {
   const parts = url.pathname.split('/').filter(Boolean)
   const shareId = decodeSegment(parts[2])
   const action = parts[3]
+  const actionId = parts[4]
 
   if (!shareId) {
     const error = new Error('Missing share id')
@@ -343,6 +345,14 @@ export async function handleSharedConversationApi(req, res, url) {
     const record = await requireShareAuth(req, shareId)
     if (record.permission === 'operate' && !record.passwordHash) throw passwordRequiredError()
 
+    if (req.method === 'GET' && action === 'assets' && actionId) {
+      const bucket = record.scope === 'project'
+        ? { scope: 'project', projectId: record.projectId }
+        : { scope: 'global' }
+      await sendSessionAsset(res, bucket, record.sessionId, decodeSegment(actionId))
+      return
+    }
+
     if (req.method === 'GET' && action === 'session') {
     sendJson(res, 200, await sharedSessionPayload(record))
     return

package/server/routes/storage.mjs

@@ -1,5 +1,6 @@
 import { sendJson, readJsonBody, decodeSegment } from '../utils/response.mjs'
 import { readStore, writeStore, atomicUpdate, getComparable, getStoreRevision, readSessionStoreScoped, readSessionValue, writeSessionValue, deleteSessionValue, ensureStorage, dataDir, configDir, storageDir, cacheDir, logsDir } from '../storage.mjs'
+import { AUTO_ARCHIVE_SETTINGS_KEY, archiveInactiveSessions, normalizeAutoArchiveSettings } from '../auto-archive.mjs'
 import { directorySize } from '../utils/workspace.mjs'
 
 const metadataIndexCache = new Map()
@@ -194,6 +195,9 @@ export async function handleStorageApi(req, res, url) {
         data[key] = body?.value
         return data
       })
+      if (store === 'settings' && key === AUTO_ARCHIVE_SETTINGS_KEY && normalizeAutoArchiveSettings(body?.value).enabled) {
+        await archiveInactiveSessions()
+      }
       sendJson(res, 200, { ok: true })
       return
     }

package/server/routes/tools.mjs

@@ -8,7 +8,7 @@ import { callPluginTool, createPluginToolDefinitions, isPluginToolName } from '.
 import { safeReadTools } from '../approval-store.mjs'
 import { projectContextFromId, readProjectConfig } from '../project-config.mjs'
 
-const directRouteDisabledTools = new Set(['run_subagent', 'manage_global_memory'])
+const directRouteDisabledTools = new Set(['run_subagent', 'manage_global_memory', 'generate_image'])
 
 /**
  * GET /api/tools — returns canonical tool definitions (no project context needed).

package/server/routes/workspace.mjs

@@ -304,9 +304,12 @@ async function countWorkspaceLines(context, relativePath) {
   }
 }
 
-async function listGitStatus(context) {
+export async function listGitStatus(context) {
   if (!(await isGitRepository(context.workspaceRoot))) return { isGitRepository: false, files: [] }
-  const result = await git(['status', '--porcelain=v1', '-z'], context.workspaceRoot)
+  const result = await git(
+    ['status', '--porcelain=v1', '-z', '--untracked-files=all'],
+    context.workspaceRoot,
+  )
   const files = parseGitStatus(result.stdout)
   const numstat = await collectNumstat(context)
   for (const file of files) {