gitdone-agent 0.7.5 → 0.7.6

package/index.js

@@ -27,7 +27,7 @@ import { randomUUID, createHash } from 'node:crypto'
 // Reported to the server on every sync so the web UI can flag outdated agents.
 // Keep in lockstep with packages/agent/package.json "version" AND
 // src/lib/agentVersion.ts LATEST_AGENT_VERSION.
-const AGENT_VERSION = '0.7.5'
+const AGENT_VERSION = '0.7.6'
 
 const AGENT_DIR = join(homedir(), '.gitdone-agent')
 const CONFIG_PATH = join(AGENT_DIR, 'config.json')
@@ -909,7 +909,7 @@ async function reportCommandResult(cfg, id, status, result) {
 // how many tokens the run cost. `streamingText` / `activityText` (gd-419) carry
 // the live "being typed" preview and the latest thinking snippet — explicit ''
 // clears them; `undefined` leaves them untouched.
-async function postRunEvents(cfg, runId, events, status, result, usage, streamingText, activityText) {
+async function postRunEvents(cfg, runId, events, status, result, usage, streamingText, activityText, extra) {
   await api(cfg, '/api/v1/agent/ai-run/events', {
     runId,
     events,
@@ -918,9 +918,32 @@ async function postRunEvents(cfg, runId, events, status, result, usage, streamin
     ...(usage ? { usage } : {}),
     ...(streamingText !== undefined ? { streamingText } : {}),
     ...(activityText !== undefined ? { activityText } : {}),
+    // gd-466: claude's own session id (for --resume) + precise stop cause.
+    ...(extra?.claudeSessionId ? { claudeSessionId: extra.claudeSessionId } : {}),
+    ...(extra?.stopReason ? { stopReason: extra.stopReason } : {}),
+    ...(typeof extra?.resetAt === 'number' ? { resetAt: extra.resetAt } : {}),
   }).catch((e) => log(`✗ ai-run events post failed: ${e.message}`))
 }
 
+// gd-466: parse a hard usage-limit stop out of claude's headless output. On the
+// limit, the CLI surfaces "Claude AI usage limit reached|<epoch_seconds>" (in
+// the result text and/or stderr); the epoch is the window reset. Returns the
+// reset in ms when found, else { limited } with a null resetAt (telemetry is
+// then the backstop), else not limited.
+function detectUsageLimit(text) {
+  const hay = String(text || '')
+  const withEpoch = hay.match(/usage limit reached\s*\|\s*(\d{9,13})/i)
+  if (withEpoch) {
+    let n = Number(withEpoch[1])
+    if (n < 1e12) n *= 1000 // seconds → ms
+    return { limited: true, resetAt: n }
+  }
+  if (/usage limit reached|reached your usage limit|rate limit(?:ed)?|exceeded your.*\blimit\b/i.test(hay)) {
+    return { limited: true, resetAt: null }
+  }
+  return { limited: false, resetAt: null }
+}
+
 // Post transcript lines (and optional turn status / Claude session id) for an
 // interactive AiSession chat turn.
 async function postSessionEvents(cfg, sessionId, events, status, claudeSessionId, streamingText, activityText) {
@@ -991,6 +1014,11 @@ function parseStreamLine(line, push, onInit, onDelta, onMeta, onTurnEnd) {
   }
   if (ev.type === 'result') {
     if (ev.subtype && ev.subtype !== 'success') push('SYSTEM', `Резултат: ${ev.subtype}`)
+    // gd-466: surface the final result text + subtype so the caller can detect a
+    // hard usage-limit stop (the "usage limit reached|<epoch>" lands here).
+    if (typeof onMeta === 'function' && (ev.subtype || typeof ev.result === 'string')) {
+      onMeta({ subtype: ev.subtype, resultText: typeof ev.result === 'string' ? ev.result : undefined })
+    }
     // claude's final result carries cumulative token usage + its own cost.
     // Prefer `modelUsage` (summed over every model/subagent turn) which is the
     // true cumulative; top-level `usage` is often just the last turn. Fall back
@@ -1176,6 +1204,8 @@ function runAiCommand(cfg, cmd, repoPath) {
   const prompt = cmd.payload?.prompt ?? ''
   const allowCommit = cmd.payload?.allowCommit === true
   const model = aiModelArg(cmd.payload?.model)
+  // gd-466: a token-reset resume asks us to continue claude's own conversation.
+  const resumeId = cmd.payload?.resume || null
   if (!runId || !prompt) {
     reportCommandResult(cfg, cmd.id, 'error', 'invalid ai_run payload')
     return
@@ -1208,6 +1238,10 @@ function runAiCommand(cfg, cmd, repoPath) {
     // Stream text token-by-token + thinking deltas so the terminal shows the
     // reply being written live, ред по ред, not in whole-block batches (gd-419).
     '--include-partial-messages',
+    // gd-466: resume claude's own prior conversation for this task when we're
+    // continuing after a token reset — it keeps its context/todo. A stale/missing
+    // session errors out fast; the watchdog then re-dispatches fresh (no resume).
+    ...(resumeId ? ['--resume', resumeId] : []),
     // Model chosen in gitDone (project default / task); omitted → machine default (gd-354).
     ...(model ? ['--model', model] : []),
     '--permission-mode', 'acceptEdits',
@@ -1240,7 +1274,11 @@ function runAiCommand(cfg, cmd, repoPath) {
     const activityText = activityChanged ? liveActivity : undefined
     sentLive = liveText
     sentActivity = liveActivity
-    await postRunEvents(cfg, runId, batch, undefined, undefined, undefined, streamingText, activityText)
+    // gd-466: persist claude's session id as soon as we have it (once), so a
+    // resume survives even if the agent dies before the clean close handler.
+    const extra = (!sentSession && capturedSession) ? { claudeSessionId: capturedSession } : undefined
+    if (extra) sentSession = true
+    await postRunEvents(cfg, runId, batch, undefined, undefined, undefined, streamingText, activityText, extra)
     flushing = false
   }
   const push = (kind, text) => {
@@ -1260,14 +1298,25 @@ function runAiCommand(cfg, cmd, repoPath) {
   const timer = setInterval(flush, 500)
 
   // Accumulate model + token usage across the stream (model from init, usage
-  // from the final result event) to report once on exit (gd-334).
-  const meta = { model: undefined, usage: undefined, costUsd: undefined }
+  // from the final result event) to report once on exit (gd-334). gd-466 also
+  // captures the final result text/subtype (for usage-limit detection).
+  const meta = { model: undefined, usage: undefined, costUsd: undefined, resultText: undefined, subtype: undefined }
   const onMeta = (m) => {
     if (m.model) meta.model = m.model
     if (m.usage) meta.usage = m.usage
     if (typeof m.costUsd === 'number') meta.costUsd = m.costUsd
+    if (m.resultText) meta.resultText = m.resultText
+    if (m.subtype) meta.subtype = m.subtype
   }
 
+  // gd-466: claude's own session id (from its init event) + any stderr — both
+  // feed a token-reset resume: the id lets us --resume, the stderr helps detect
+  // a usage-limit stop.
+  let capturedSession = null
+  let sentSession = false
+  const onInit = (sid) => { if (sid) capturedSession = sid }
+  let stderrBuf = ''
+
   log(`▶ ai_run ${runId} @ ${repoPath} via ${claudePath}`)
   postRunEvents(cfg, runId, [{ kind: 'SYSTEM', text: `Стартиране на Claude Code в ${repoPath}…` }], 'running')
 
@@ -1296,14 +1345,14 @@ function runAiCommand(cfg, cmd, repoPath) {
     while ((nl = buf.indexOf('\n')) >= 0) {
       const line = buf.slice(0, nl).trim()
       buf = buf.slice(nl + 1)
-      if (line) parseStreamLine(line, push, undefined, onDelta, onMeta)
+      if (line) parseStreamLine(line, push, onInit, onDelta, onMeta)
     }
   })
-  child.stderr.on('data', (d) => { const s = d.toString().trim(); if (s) push('SYSTEM', s) })
+  child.stderr.on('data', (d) => { const s = d.toString().trim(); if (s) { stderrBuf = (stderrBuf + '\n' + s).slice(-8000); push('SYSTEM', s) } })
   child.on('error', (err) => push('SYSTEM', `Процесна грешка: ${err.message}`))
   child.on('close', async (code) => {
     clearInterval(timer)
-    if (buf.trim()) parseStreamLine(buf.trim(), push, undefined, onDelta, onMeta)
+    if (buf.trim()) parseStreamLine(buf.trim(), push, onInit, onDelta, onMeta)
     liveText = '' // run is over — drop any lingering live preview / thought
     liveActivity = ''
     await flush()
@@ -1312,17 +1361,38 @@ function runAiCommand(cfg, cmd, repoPath) {
     const usage = meta.usage
       ? { model: meta.model, ...meta.usage, ...(typeof meta.costUsd === 'number' ? { costUsd: meta.costUsd } : {}) }
       : undefined
-    const events = [{ kind: 'SYSTEM', text: ok ? '✓ Готово.' : `✗ Процесът приключи с код ${code}.` }]
+
+    // gd-466: did we stop on the token limit? Check the final result text, its
+    // subtype, and stderr. A hard hit gives us the precise reset epoch; report
+    // it so the server parks the task for an exact auto-resume.
+    const limit = detectUsageLimit(`${meta.resultText || ''}\n${meta.subtype || ''}\n${stderrBuf}`)
+    const extra = {
+      ...(capturedSession ? { claudeSessionId: capturedSession } : {}),
+      ...(limit.limited ? { stopReason: 'usage_limit' } : {}),
+      ...(limit.limited && typeof limit.resetAt === 'number' ? { resetAt: limit.resetAt } : {}),
+    }
+
+    const events = [{
+      kind: 'SYSTEM',
+      text: limit.limited
+        ? '⏳ Достигнат лимит на токени — спирам. gitDone ще ме продължи автоматично след ресета.'
+        : (ok ? '✓ Готово.' : `✗ Процесът приключи с код ${code}.`),
+    }]
     if (usage) events.push({ kind: 'SYSTEM', text: `📊 Токени: ${fmtTokens(usage.inputTokens)} вход · ${fmtTokens(usage.outputTokens)} изход${usage.cacheReadTokens ? ` · ${fmtTokens(usage.cacheReadTokens)} кеш` : ''}${typeof usage.costUsd === 'number' ? ` · $${usage.costUsd.toFixed(4)}` : ''}` })
     await postRunEvents(
       cfg, runId,
       events,
-      ok ? 'done' : 'error',
-      ok ? 'ok' : `exit ${code}`,
+      // A limit stop is not a clean finish — report it as 'error' so the run
+      // ends and the server's park/resume path (not the DONE path) takes over.
+      ok && !limit.limited ? 'done' : 'error',
+      limit.limited ? 'usage_limit' : (ok ? 'ok' : `exit ${code}`),
       usage,
+      undefined,
+      undefined,
+      extra,
     )
-    reportCommandResult(cfg, cmd.id, ok ? 'done' : 'error', `exit ${code}`)
-    log(`■ ai_run ${runId} приключи (code ${code})`)
+    reportCommandResult(cfg, cmd.id, ok && !limit.limited ? 'done' : 'error', limit.limited ? 'usage_limit' : `exit ${code}`)
+    log(`■ ai_run ${runId} приключи (code ${code}${limit.limited ? ', usage_limit' : ''})`)
   })
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "gitdone-agent",
-    "version":  "0.7.5",
+    "version":  "0.7.6",
     "description":  "Local git agent for gitdone — watches a local repo and sends snapshots to gitdone.eu",
     "type":  "module",
     "bin":  {