@shawnstack/quickforge 1.3.4 → 1.3.6

package/README.md

@@ -1,7 +1,7 @@
 # 速构 QuickForge
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-1.3.4-blue" />
+  <img alt="Version" src="https://img.shields.io/badge/version-1.3.6-blue" />
   <img alt="License" src="https://img.shields.io/badge/license-MIT-green" />
   <img alt="Node" src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" />
   <img alt="React" src="https://img.shields.io/badge/react-19-61DAFB?logo=react" />
@@ -65,7 +65,7 @@ QuickForge 的工具能力很直接，因此也需要谨慎使用：
 #### 从 npm 安装
 
 ```bash
-npm install -g @shawnstack/quickforge@1.3.4
+npm install -g @shawnstack/quickforge@1.3.6
 qf
 
 # CLI 工具
@@ -79,17 +79,17 @@ qf update
 当前版本的离线包：
 
 ```text
-package-offline/shawnstack-quickforge-1.3.4.tgz
+package-offline/shawnstack-quickforge-1.3.6.tgz
 ```
 
 在安装了 Node.js 20+ 和 npm 的机器上执行：
 
 ```bash
-npm install -g ./package-offline/shawnstack-quickforge-1.3.4.tgz
+npm install -g ./package-offline/shawnstack-quickforge-1.3.6.tgz
 qf
 ```
 
-该包由 `v1.3.4` 标签生成，包含离线安装所需的运行时依赖。
+该包由 `v1.3.6` 标签生成，包含离线安装所需的运行时依赖。
 
 ### 本地开发
 
@@ -228,7 +228,7 @@ QuickForge intentionally exposes powerful local capabilities, so the boundaries
 #### npm
 
 ```bash
-npm install -g @shawnstack/quickforge@1.3.4
+npm install -g @shawnstack/quickforge@1.3.6
 qf
 
 # CLI utilities
@@ -239,20 +239,20 @@ qf update
 
 #### Offline tarball
 
-The offline release package for `v1.3.4` is:
+The offline release package for `v1.3.6` is:
 
 ```text
-package-offline/shawnstack-quickforge-1.3.4.tgz
+package-offline/shawnstack-quickforge-1.3.6.tgz
 ```
 
 Install it on a machine with Node.js 20+ and npm:
 
 ```bash
-npm install -g ./package-offline/shawnstack-quickforge-1.3.4.tgz
+npm install -g ./package-offline/shawnstack-quickforge-1.3.6.tgz
 qf
 ```
 
-The package was generated from tag `v1.3.4` and includes bundled runtime dependencies for offline installation.
+The package was generated from tag `v1.3.6` and includes bundled runtime dependencies for offline installation.
 
 ### Local development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shawnstack/quickforge",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "AI chat application with YOLO-mode local workspace tools. React + Vite + Tailwind CSS frontend, local Node.js storage server.",
   "keywords": [
     "ai",

package/server/agent-manager.mjs

@@ -1,7 +1,7 @@
 import { EventEmitter } from 'node:events'
 import { randomUUID } from 'node:crypto'
 import { Agent } from '@mariozechner/pi-agent-core'
-import { streamSimple } from '@mariozechner/pi-ai'
+import { streamSimpleWithAiHttpLogging } from './ai-http-logger.mjs'
 import { toolHandlers, loadSkillToolContext } from './tools/index.mjs'
 import { createSkillTools, workspaceTools } from './tools/definitions.mjs'
 import { callMcpTool, createMcpToolDefinitions, isMcpToolName } from './mcp/registry.mjs'
@@ -699,7 +699,7 @@ export async function createAgent(sessionId, config = {}) {
       messages,
       tools,
     },
-    streamFn: streamSimple,
+    streamFn: streamSimpleWithAiHttpLogging,
     getApiKey,
     sessionId,
     convertToLlm: serverConvertToLlm,

package/server/ai-http-logger.mjs

@@ -0,0 +1,208 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { randomUUID } from 'node:crypto'
+import { streamSimple } from '@mariozechner/pi-ai'
+import { logsDir } from './storage.mjs'
+
+const PATCH_MARKER = Symbol.for('quickforge.aiHttpLogger.fetchPatched')
+const ORIGINAL_FETCH = Symbol.for('quickforge.aiHttpLogger.originalFetch')
+const enabledValues = new Set(['1', 'true', 'yes', 'on', 'full', 'raw'])
+const aiHttpLogEnabled = enabledValues.has(String(process.env.QUICKFORGE_AI_HTTP_LOG || '').toLowerCase())
+const aiHttpContext = new AsyncLocalStorage()
+
+function currentLogFile() {
+  const date = new Date().toISOString().slice(0, 10)
+  return path.join(logsDir, `ai-http-${date}.jsonl`)
+}
+
+function writeAiHttpRecord(record) {
+  if (!aiHttpLogEnabled) return
+  try {
+    fs.mkdirSync(logsDir, { recursive: true })
+    fs.appendFile(currentLogFile(), `${JSON.stringify({ ts: new Date().toISOString(), ...record })}\n`, () => {})
+  } catch {
+    // Keep AI calls working even when diagnostic logging fails.
+  }
+}
+
+function headersToRecord(headers) {
+  const result = {}
+  if (!headers) return result
+
+  try {
+    const iterable = typeof headers.entries === 'function' ? headers.entries() : Object.entries(headers)
+    for (const [key, value] of iterable) {
+      result[String(key)] = Array.isArray(value) ? value.join(', ') : String(value)
+    }
+  } catch {
+    // ignore malformed headers
+  }
+
+  return result
+}
+
+function isRequest(value) {
+  return typeof Request !== 'undefined' && value instanceof Request
+}
+
+function requestUrl(input) {
+  if (isRequest(input)) return input.url
+  if (input instanceof URL) return input.href
+  return String(input)
+}
+
+function requestMethod(input, init) {
+  return String(init?.method || (isRequest(input) ? input.method : 'GET')).toUpperCase()
+}
+
+function requestHeaders(input, init) {
+  return {
+    ...(isRequest(input) ? headersToRecord(input.headers) : {}),
+    ...headersToRecord(init?.headers),
+  }
+}
+
+async function bodyToText(body) {
+  if (body === undefined || body === null) return null
+  if (typeof body === 'string') return body
+  if (body instanceof URLSearchParams) return body.toString()
+  if (typeof Blob !== 'undefined' && body instanceof Blob) return body.text()
+  if (body instanceof ArrayBuffer) return Buffer.from(body).toString('utf8')
+  if (ArrayBuffer.isView(body)) return Buffer.from(body.buffer, body.byteOffset, body.byteLength).toString('utf8')
+  if (typeof FormData !== 'undefined' && body instanceof FormData) {
+    const entries = []
+    for (const [key, value] of body.entries()) {
+      entries.push([
+        key,
+        typeof value === 'string'
+          ? value
+          : { name: value.name, type: value.type, size: value.size },
+      ])
+    }
+    return JSON.stringify(entries)
+  }
+  if (typeof ReadableStream !== 'undefined' && body instanceof ReadableStream) {
+    return '[ReadableStream body not captured to avoid consuming the request stream]'
+  }
+  if (typeof body === 'object') {
+    try {
+      return JSON.stringify(body)
+    } catch {
+      return String(body)
+    }
+  }
+  return String(body)
+}
+
+async function readRequestBody(input, init) {
+  if (init && Object.hasOwn(init, 'body')) return bodyToText(init.body)
+  if (!isRequest(input)) return null
+
+  try {
+    return await input.clone().text()
+  } catch (error) {
+    return `[request body capture failed: ${error instanceof Error ? error.message : String(error)}]`
+  }
+}
+
+async function logResponseBody(response, baseRecord) {
+  try {
+    const body = await response.clone().text()
+    writeAiHttpRecord({
+      ...baseRecord,
+      type: 'ai_http_response',
+      response: {
+        status: response.status,
+        statusText: response.statusText,
+        headers: headersToRecord(response.headers),
+        body,
+      },
+    })
+  } catch (error) {
+    writeAiHttpRecord({
+      ...baseRecord,
+      type: 'ai_http_response_capture_error',
+      response: {
+        status: response.status,
+        statusText: response.statusText,
+        headers: headersToRecord(response.headers),
+      },
+      error: error instanceof Error ? error.message : String(error),
+    })
+  }
+}
+
+async function loggedFetch(originalFetch, input, init) {
+  const context = aiHttpContext.getStore()
+  if (!context) return originalFetch(input, init)
+
+  const httpRequestId = randomUUID()
+  const startedAt = Date.now()
+  const method = requestMethod(input, init)
+  const url = requestUrl(input)
+  const baseRecord = {
+    traceId: context.traceId,
+    httpRequestId,
+    sessionId: context.sessionId,
+    purpose: context.purpose,
+    provider: context.provider,
+    api: context.api,
+    model: context.model,
+    method,
+    url,
+  }
+
+  writeAiHttpRecord({
+    ...baseRecord,
+    type: 'ai_http_request',
+    request: {
+      method,
+      url,
+      headers: requestHeaders(input, init),
+      body: await readRequestBody(input, init),
+    },
+  })
+
+  try {
+    const response = await originalFetch(input, init)
+    const durationMs = Date.now() - startedAt
+    void logResponseBody(response, { ...baseRecord, durationMs })
+    return response
+  } catch (error) {
+    writeAiHttpRecord({
+      ...baseRecord,
+      type: 'ai_http_error',
+      durationMs: Date.now() - startedAt,
+      error: error instanceof Error ? error.stack || error.message : String(error),
+    })
+    throw error
+  }
+}
+
+export function installAiHttpLogger() {
+  if (!aiHttpLogEnabled || typeof globalThis.fetch !== 'function') return
+  if (globalThis[PATCH_MARKER]) return
+
+  const originalFetch = globalThis.fetch.bind(globalThis)
+  globalThis[ORIGINAL_FETCH] = originalFetch
+  globalThis.fetch = (input, init) => loggedFetch(originalFetch, input, init)
+  globalThis[PATCH_MARKER] = true
+}
+
+export function streamSimpleWithAiHttpLogging(model, context, options = {}) {
+  if (!aiHttpLogEnabled) return streamSimple(model, context, options)
+
+  const traceContext = {
+    traceId: randomUUID(),
+    sessionId: options?.sessionId,
+    purpose: options?.metadata?.quickforgePurpose || 'chat',
+    provider: model?.provider,
+    api: model?.api,
+    model: model?.id,
+  }
+
+  return aiHttpContext.run(traceContext, () => streamSimple(model, context, options))
+}
+
+installAiHttpLogger()

package/server/conversation-compaction.mjs

@@ -1,6 +1,6 @@
 import { promises as fs } from 'node:fs'
 import path from 'node:path'
-import { streamSimple } from '@mariozechner/pi-ai'
+import { streamSimpleWithAiHttpLogging } from './ai-http-logger.mjs'
 import { cacheDir } from './storage.mjs'
 
 export const DEFAULT_COMPACT_KEEP_TURNS = 0
@@ -253,7 +253,7 @@ export async function compactConversation({ messages, model, thinkingLevel, getA
   const modelMaxTokens = Number(model.maxTokens) || 4096
   const maxTokens = Math.max(512, Math.min(modelMaxTokens, 4096))
   const apiKey = getApiKey ? await getApiKey(model.provider) : undefined
-  const stream = streamSimple(
+  const stream = streamSimpleWithAiHttpLogging(
     model,
     {
       systemPrompt: COMPACT_SYSTEM_PROMPT,
@@ -266,6 +266,7 @@ export async function compactConversation({ messages, model, thinkingLevel, getA
       temperature: 0.2,
       reasoning: thinkingLevel === 'off' ? undefined : 'low',
       maxRetryDelayMs: 60000,
+      metadata: { quickforgePurpose: 'compact' },
     },
   )
 

package/server/index.mjs

@@ -25,6 +25,7 @@ import { handleLanAccessApi, renderLanUnlockPage } from './routes/lan-access.mjs
 import { handleMcpApi } from './routes/mcp.mjs'
 import { serveStatic } from './routes/static.mjs'
 import { logger, flushLogger } from './utils/logger.mjs'
+import { installAiHttpLogger } from './ai-http-logger.mjs'
 import { isLoopbackAddress, getLanUrls } from './utils/network.mjs'
 import { parseCookies } from './share-store.mjs'
 import { lanAccessCookieName, verifyLanAccessToken } from './lan-access-store.mjs'
@@ -50,6 +51,7 @@ const vitePort = Number(process.env.QUICKFORGE_VITE_PORT || 5176)
 let restartInProgress = false
 
 setDefaultWorkspaceRoot(process.env.QUICKFORGE_WORKSPACE_DIR || projectRoot)
+installAiHttpLogger()
 
 function getRestartSupport() {
   return { supported: true, reason: null }