@agentconnect/host 0.2.5 → 0.2.6

package/dist/host.js

@@ -9,7 +9,7 @@ import { listModels, listRecentModels, providers, resolveProviderForModel, } fro
 import { debugLog, setSpawnLogging } from './providers/utils.js';
 import { createObservedTracker } from './observed.js';
 import { createStorage } from './storage.js';
-import { buildSummaryPrompt, getSummaryModel, runSummaryPrompt, } from './summary.js';
+import { buildSummaryPrompt, buildSummaryPromptWithOverride, getSummaryModel, runSummaryPrompt, } from './summary.js';
 function send(socket, payload) {
     socket.send(JSON.stringify(payload));
 }
@@ -126,6 +126,29 @@ function createHostRuntime(options) {
             return null;
         }
     }
+    function normalizeSummaryMode(value) {
+        const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
+        if (raw === 'auto' || raw === 'off' || raw === 'force')
+            return raw;
+        return undefined;
+    }
+    function normalizeSummaryPrompt(value) {
+        if (typeof value !== 'string')
+            return undefined;
+        const trimmed = value.trim();
+        return trimmed ? trimmed : undefined;
+    }
+    function resolveSummaryMode(session, requested) {
+        if (requested)
+            return requested;
+        return session.summaryMode ?? 'auto';
+    }
+    function resolveEffectiveSummaryMode(session, requested) {
+        const mode = resolveSummaryMode(session, requested);
+        if (mode === 'auto' && session.summaryAutoUsed)
+            return 'off';
+        return mode;
+    }
     function recordCapability(capability) {
         observedTracker.record(capability);
     }
@@ -183,17 +206,22 @@ function createHostRuntime(options) {
     function clearSummarySeed(session) {
         session.summarySeed = undefined;
         session.summaryReasoning = undefined;
+        session.summaryNextMode = undefined;
+        session.summaryNextPrompt = undefined;
     }
     async function startPromptSummary(options) {
-        const { sessionId, session, message, reasoning, emit } = options;
+        const { sessionId, session, message, reasoning, summaryPrompt, mode, emit } = options;
         if (session.summaryRequested)
             return;
         session.summaryRequested = true;
+        let completed = false;
         try {
             const provider = providers[session.providerId];
             if (!provider)
                 return;
-            const prompt = buildSummaryPrompt(message, reasoning);
+            const prompt = summaryPrompt
+                ? buildSummaryPromptWithOverride(summaryPrompt, message, reasoning)
+                : buildSummaryPrompt(message, reasoning);
             const summaryModel = getSummaryModel(session.providerId);
             const cwd = session.cwd || basePath;
             const repoRoot = session.repoRoot || basePath;
@@ -213,9 +241,13 @@ function createHostRuntime(options) {
                 model: result.model ?? null,
                 createdAt: new Date().toISOString(),
             }, session);
+            completed = true;
         }
         finally {
             session.summaryRequested = false;
+            if (!completed && mode === 'auto') {
+                session.summaryAutoUsed = true;
+            }
             if (session.summarySeed) {
                 maybeStartPromptSummary({
                     sessionId,
@@ -342,6 +374,9 @@ function createHostRuntime(options) {
     }
     function maybeStartPromptSummary(options) {
         const { sessionId, session, emit, trigger } = options;
+        const mode = resolveEffectiveSummaryMode(session, session.summaryNextMode);
+        if (mode === 'off')
+            return;
         if (session.summaryRequested)
             return;
         if (!session.summarySeed)
@@ -350,8 +385,17 @@ function createHostRuntime(options) {
             return;
         const message = session.summarySeed;
         const reasoning = session.summaryReasoning;
+        const summaryPrompt = session.summaryNextPrompt ?? session.summaryPrompt;
         clearSummarySeed(session);
-        void startPromptSummary({ sessionId, session, message, reasoning, emit });
+        void startPromptSummary({
+            sessionId,
+            session,
+            message,
+            reasoning,
+            summaryPrompt,
+            mode,
+            emit,
+        });
     }
     function sessionSummaryKey(sessionId) {
         return `session:${sessionId}:summary`;
@@ -360,9 +404,6 @@ function createHostRuntime(options) {
         if (!payload.summary)
             return;
         if (session) {
-            if (session.summarySource === 'claude-log' && payload.source === 'prompt') {
-                return;
-            }
             if (session.summary === payload.summary && session.summarySource === payload.source) {
                 return;
             }
@@ -370,6 +411,7 @@ function createHostRuntime(options) {
             session.summarySource = payload.source;
             session.summaryModel = payload.model ?? null;
             session.summaryCreatedAt = payload.createdAt;
+            session.summaryAutoUsed = true;
         }
         emitSessionEvent(emit, sessionId, 'summary', payload);
         storage.set(sessionSummaryKey(sessionId), payload);
@@ -602,6 +644,8 @@ function createHostRuntime(options) {
             else {
                 recordProviderCapability(providerId);
             }
+            const summaryMode = normalizeSummaryMode(params.summary?.mode);
+            const summaryPrompt = normalizeSummaryPrompt(params.summary?.prompt);
             sessions.set(sessionId, {
                 id: sessionId,
                 providerId,
@@ -614,6 +658,9 @@ function createHostRuntime(options) {
                 providerDetailLevel: providerDetailLevel === 'raw' || providerDetailLevel === 'minimal'
                     ? providerDetailLevel
                     : undefined,
+                summaryMode: summaryMode === 'force' ? 'auto' : summaryMode ?? 'auto',
+                summaryPrompt,
+                summaryAutoUsed: false,
             });
             responder.reply(id, { sessionId });
             return;
@@ -643,6 +690,16 @@ function createHostRuntime(options) {
                     existing.providerDetailLevel = level;
                 }
             }
+            if ('summary' in params) {
+                const summaryMode = normalizeSummaryMode(params.summary?.mode);
+                const summaryPrompt = normalizeSummaryPrompt(params.summary?.prompt);
+                if (summaryMode) {
+                    existing.summaryMode = summaryMode === 'force' ? 'auto' : summaryMode;
+                }
+                if (summaryPrompt !== undefined) {
+                    existing.summaryPrompt = summaryPrompt;
+                }
+            }
             if (!existing.model && typeof params.model === 'string' && params.model.trim()) {
                 const candidate = params.model.trim();
                 const matches = await isModelForProvider(candidate, existing.providerId);
@@ -698,7 +755,13 @@ function createHostRuntime(options) {
                     return;
                 }
             }
-            if (message.trim()) {
+            const summaryMode = resolveEffectiveSummaryMode(session, normalizeSummaryMode(params.summary?.mode));
+            const summaryPrompt = normalizeSummaryPrompt(params.summary?.prompt);
+            session.summaryNextMode = summaryMode;
+            if (summaryPrompt !== undefined) {
+                session.summaryNextPrompt = summaryPrompt;
+            }
+            if (summaryMode !== 'off' && message.trim()) {
                 session.summarySeed = message;
                 session.summaryReasoning = '';
             }

package/dist/providers/claude.js

@@ -903,6 +903,180 @@ function mapClaudeModel(model) {
         return value.replace('claude-', '');
     return model;
 }
+function extractUsageFromValue(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const usage = value;
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
+    const input = toNumber(usage.input_tokens ?? usage.prompt_tokens ?? usage.inputTokens ?? usage.promptTokens);
+    const output = toNumber(usage.output_tokens ?? usage.completion_tokens ?? usage.outputTokens ?? usage.completionTokens);
+    const total = toNumber(usage.total_tokens ?? usage.totalTokens);
+    let cached = toNumber(usage.cached_input_tokens ?? usage.cachedInputTokens);
+    const cacheCreation = toNumber(usage.cache_creation_input_tokens ?? usage.cacheCreationInputTokens);
+    const cacheRead = toNumber(usage.cache_read_input_tokens ?? usage.cacheReadInputTokens);
+    if (cached === undefined) {
+        const sum = (cacheCreation ?? 0) + (cacheRead ?? 0);
+        if (sum > 0)
+            cached = sum;
+    }
+    const reasoning = toNumber(usage.reasoning_tokens ?? usage.reasoningTokens);
+    const out = {};
+    if (input !== undefined)
+        out.input_tokens = input;
+    if (output !== undefined)
+        out.output_tokens = output;
+    if (total !== undefined)
+        out.total_tokens = total;
+    if (cached !== undefined)
+        out.cached_input_tokens = cached;
+    if (reasoning !== undefined)
+        out.reasoning_tokens = reasoning;
+    return Object.keys(out).length ? out : null;
+}
+function pickModelUsage(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const entries = Object.values(value);
+    for (const entry of entries) {
+        if (entry && typeof entry === 'object')
+            return entry;
+    }
+    return null;
+}
+function extractClaudeUsage(msg) {
+    const usage = msg.usage ??
+        msg.message?.usage ??
+        msg.event?.usage ??
+        msg.delta?.usage ??
+        msg.token_usage ??
+        msg.tokenUsage;
+    if (usage)
+        return extractUsageFromValue(usage);
+    const resultRecord = msg.result && typeof msg.result === 'object' ? msg.result : null;
+    const nestedUsage = resultRecord?.usage ??
+        resultRecord?.token_usage ??
+        resultRecord?.tokenUsage ??
+        resultRecord?.token_usage;
+    if (nestedUsage)
+        return extractUsageFromValue(nestedUsage);
+    const modelUsage = pickModelUsage(msg.modelUsage ?? msg.message?.modelUsage ?? resultRecord?.modelUsage);
+    return extractUsageFromValue(modelUsage);
+}
+function extractClaudeContextUsage(msg, usage) {
+    const context = msg.context_usage ??
+        msg.contextUsage ??
+        msg.message?.context_usage ??
+        msg.message?.contextUsage ??
+        msg.event?.context_usage ??
+        msg.event?.contextUsage;
+    const resultRecord = msg.result && typeof msg.result === 'object' ? msg.result : null;
+    const modelUsage = pickModelUsage(msg.modelUsage ?? msg.message?.modelUsage ?? resultRecord?.modelUsage);
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
+    const toBoolean = (v) => typeof v === 'boolean' ? v : undefined;
+    const contextWindow = toNumber(context?.context_window ??
+        context?.contextWindow ??
+        modelUsage?.contextWindow ??
+        modelUsage?.context_window ??
+        msg.context_window ??
+        msg.contextWindow);
+    let contextTokens = toNumber(context?.context_tokens ??
+        context?.contextTokens ??
+        msg.context_tokens ??
+        msg.contextTokens);
+    let contextCachedTokens = toNumber(context?.context_cached_tokens ??
+        context?.contextCachedTokens ??
+        msg.context_cached_tokens ??
+        msg.contextCachedTokens);
+    let contextRemainingTokens = toNumber(context?.context_remaining_tokens ??
+        context?.contextRemainingTokens ??
+        msg.context_remaining_tokens ??
+        msg.contextRemainingTokens);
+    const contextTruncated = toBoolean(context?.context_truncated ??
+        context?.contextTruncated ??
+        msg.context_truncated ??
+        msg.contextTruncated);
+    if (contextCachedTokens === undefined) {
+        const cached = toNumber(context?.cache_creation_input_tokens) ??
+            toNumber(context?.cacheCreationInputTokens) ??
+            toNumber(context?.cache_read_input_tokens) ??
+            toNumber(context?.cacheReadInputTokens);
+        if (cached !== undefined)
+            contextCachedTokens = cached;
+    }
+    if (contextTokens === undefined) {
+        if (usage?.input_tokens !== undefined &&
+            usage?.cached_input_tokens !== undefined) {
+            contextTokens = usage.input_tokens + usage.cached_input_tokens;
+        }
+        else if (usage?.input_tokens !== undefined) {
+            contextTokens = usage.input_tokens;
+        }
+    }
+    if (contextCachedTokens === undefined && usage?.cached_input_tokens !== undefined) {
+        contextCachedTokens = usage.cached_input_tokens;
+    }
+    if (contextRemainingTokens === undefined &&
+        contextWindow !== undefined &&
+        contextTokens !== undefined) {
+        contextRemainingTokens = Math.max(0, contextWindow - contextTokens);
+    }
+    const out = {};
+    if (contextWindow !== undefined)
+        out.context_window = contextWindow;
+    if (contextTokens !== undefined)
+        out.context_tokens = contextTokens;
+    if (contextCachedTokens !== undefined)
+        out.context_cached_tokens = contextCachedTokens;
+    if (contextRemainingTokens !== undefined)
+        out.context_remaining_tokens = contextRemainingTokens;
+    if (contextTruncated !== undefined)
+        out.context_truncated = contextTruncated;
+    return Object.keys(out).length ? out : null;
+}
+function mergeUsage(current, next) {
+    const out = { ...(current ?? {}) };
+    if (next.input_tokens !== undefined)
+        out.input_tokens = next.input_tokens;
+    if (next.output_tokens !== undefined)
+        out.output_tokens = next.output_tokens;
+    if (next.total_tokens !== undefined)
+        out.total_tokens = next.total_tokens;
+    if (next.cached_input_tokens !== undefined)
+        out.cached_input_tokens = next.cached_input_tokens;
+    if (next.reasoning_tokens !== undefined)
+        out.reasoning_tokens = next.reasoning_tokens;
+    return out;
+}
+function mergeContextUsage(current, next) {
+    const out = { ...(current ?? {}) };
+    if (next.context_window !== undefined)
+        out.context_window = next.context_window;
+    if (next.context_tokens !== undefined)
+        out.context_tokens = next.context_tokens;
+    if (next.context_cached_tokens !== undefined)
+        out.context_cached_tokens = next.context_cached_tokens;
+    if (next.context_remaining_tokens !== undefined)
+        out.context_remaining_tokens = next.context_remaining_tokens;
+    if (next.context_truncated !== undefined)
+        out.context_truncated = next.context_truncated;
+    return out;
+}
 function extractSessionId(msg) {
     const direct = msg.session_id ?? msg.sessionId;
     if (typeof direct === 'string' && direct)
@@ -1004,6 +1178,11 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
         let finalSessionId = null;
         let didFinalize = false;
         let sawError = false;
+        let usageEmitted = false;
+        let latestUsage = null;
+        let latestContextUsage = null;
+        let latestUsageDetail;
+        let latestContextUsageDetail;
         const toolBlocks = new Map();
         const thinkingBlocks = new Set();
         const includeRaw = providerDetailLevel === 'raw';
@@ -1027,11 +1206,46 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
             if (sawError)
                 return;
             sawError = true;
+            emitUsageIfAvailable();
             emit({ type: 'error', message });
         };
         const emitFinal = (text, providerDetail) => {
+            emitUsageIfAvailable();
             emit({ type: 'final', text, providerDetail });
         };
+        const captureUsage = (msg, providerDetail) => {
+            const usage = extractClaudeUsage(msg);
+            if (usage) {
+                latestUsage = mergeUsage(latestUsage, usage);
+                latestUsageDetail = providerDetail;
+            }
+            const contextUsage = extractClaudeContextUsage(msg, latestUsage);
+            if (contextUsage) {
+                latestContextUsage = mergeContextUsage(latestContextUsage, contextUsage);
+                latestContextUsageDetail = providerDetail;
+            }
+        };
+        const emitUsageIfAvailable = () => {
+            if (usageEmitted)
+                return;
+            if (!latestUsage && !latestContextUsage)
+                return;
+            if (latestUsage) {
+                emit({
+                    type: 'usage',
+                    usage: latestUsage,
+                    providerDetail: latestUsageDetail,
+                });
+            }
+            if (latestContextUsage) {
+                emit({
+                    type: 'context_usage',
+                    contextUsage: latestContextUsage,
+                    providerDetail: latestContextUsageDetail ?? latestUsageDetail,
+                });
+            }
+            usageEmitted = true;
+        };
         const handleLine = (line) => {
             const parsed = safeJsonParse(line);
             if (!parsed || typeof parsed !== 'object') {
@@ -1046,6 +1260,8 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
                 finalSessionId = sid;
             const msgType = String(msg.type ?? '');
             let handled = false;
+            const detail = buildProviderDetail(msgType || 'unknown', {}, msg);
+            captureUsage(msg, detail);
             if (msgType === 'assistant' || msgType === 'user' || msgType === 'system') {
                 const role = msg.message?.role === 'assistant' ||
                     msg.message?.role === 'user' ||
@@ -1060,7 +1276,7 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
                     role,
                     content,
                     contentParts: rawContent ?? null,
-                    providerDetail: buildProviderDetail(msgType, {}, msg),
+                    providerDetail: detail,
                 });
                 handled = true;
             }
@@ -1152,7 +1368,7 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
                 emit({
                     type: 'delta',
                     text: delta,
-                    providerDetail: buildProviderDetail(msgType || 'delta', {}, msg),
+                    providerDetail: detail,
                 });
                 return;
             }
@@ -1162,21 +1378,21 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
                 emit({
                     type: 'delta',
                     text: assistant,
-                    providerDetail: buildProviderDetail(msgType || 'assistant', {}, msg),
+                    providerDetail: detail,
                 });
                 return;
             }
             const result = extractResultText(msg);
             if (result && !didFinalize && !sawError) {
                 didFinalize = true;
-                emitFinal(aggregated || result, buildProviderDetail('result', {}, msg));
+                emitFinal(aggregated || result, detail);
                 handled = true;
             }
             if (!handled) {
                 emit({
                     type: 'detail',
                     provider: 'claude',
-                    providerDetail: buildProviderDetail(msgType || 'unknown', {}, msg),
+                    providerDetail: detail,
                 });
             }
         };
@@ -1193,6 +1409,9 @@ export function runClaudePrompt({ prompt, system, resumeSessionId, model, cwd, p
                     emitFinal(aggregated);
                 }
             }
+            if (!usageEmitted) {
+                emitUsageIfAvailable();
+            }
             resolve({ sessionId: finalSessionId });
         });
         child.on('error', (err) => {

package/dist/providers/codex.js

@@ -430,11 +430,20 @@ function extractUsage(ev) {
     const usage = ev.usage ?? ev.token_usage ?? ev.tokens ?? ev.tokenUsage;
     if (!usage || typeof usage !== 'object')
         return null;
-    const toNumber = (v) => typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
     const input = toNumber(usage.input_tokens ?? usage.prompt_tokens ?? usage.inputTokens ?? usage.promptTokens);
     const output = toNumber(usage.output_tokens ?? usage.completion_tokens ?? usage.outputTokens ?? usage.completionTokens);
     const total = toNumber(usage.total_tokens ?? usage.totalTokens);
     const cached = toNumber(usage.cached_input_tokens ?? usage.cachedInputTokens);
+    const reasoning = toNumber(usage.reasoning_tokens ?? usage.reasoningTokens);
     const out = {};
     if (input !== undefined)
         out.input_tokens = input;
@@ -444,6 +453,61 @@ function extractUsage(ev) {
         out.total_tokens = total;
     if (cached !== undefined)
         out.cached_input_tokens = cached;
+    if (reasoning !== undefined)
+        out.reasoning_tokens = reasoning;
+    return Object.keys(out).length ? out : null;
+}
+function extractContextUsage(ev, usage) {
+    const context = ev.context_usage ?? ev.contextUsage;
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
+    const toBoolean = (v) => typeof v === 'boolean' ? v : undefined;
+    const contextWindow = toNumber(context?.context_window ?? context?.contextWindow ?? ev.context_window ?? ev.contextWindow);
+    let contextTokens = toNumber(context?.context_tokens ?? context?.contextTokens ?? ev.context_tokens ?? ev.contextTokens);
+    let contextCachedTokens = toNumber(context?.context_cached_tokens ??
+        context?.contextCachedTokens ??
+        ev.context_cached_tokens ??
+        ev.contextCachedTokens);
+    let contextRemainingTokens = toNumber(context?.context_remaining_tokens ??
+        context?.contextRemainingTokens ??
+        ev.context_remaining_tokens ??
+        ev.contextRemainingTokens);
+    const contextTruncated = toBoolean(context?.context_truncated ?? context?.contextTruncated ?? ev.context_truncated ?? ev.contextTruncated);
+    if (contextTokens === undefined) {
+        if (usage?.input_tokens !== undefined &&
+            usage?.cached_input_tokens !== undefined) {
+            contextTokens = usage.input_tokens + usage.cached_input_tokens;
+        }
+        else if (usage?.input_tokens !== undefined) {
+            contextTokens = usage.input_tokens;
+        }
+    }
+    if (contextCachedTokens === undefined && usage?.cached_input_tokens !== undefined) {
+        contextCachedTokens = usage.cached_input_tokens;
+    }
+    if (contextRemainingTokens === undefined &&
+        contextWindow !== undefined &&
+        contextTokens !== undefined) {
+        contextRemainingTokens = Math.max(0, contextWindow - contextTokens);
+    }
+    const out = {};
+    if (contextWindow !== undefined)
+        out.context_window = contextWindow;
+    if (contextTokens !== undefined)
+        out.context_tokens = contextTokens;
+    if (contextCachedTokens !== undefined)
+        out.context_cached_tokens = contextCachedTokens;
+    if (contextRemainingTokens !== undefined)
+        out.context_remaining_tokens = contextRemainingTokens;
+    if (contextTruncated !== undefined)
+        out.context_truncated = contextTruncated;
     return Object.keys(out).length ? out : null;
 }
 function normalizeItem(raw) {
@@ -840,8 +904,16 @@ export function runCodexPrompt({ prompt, system, resumeSessionId, model, reasoni
                 if (usage) {
                     emit({
                         type: 'usage',
-                        inputTokens: usage.input_tokens,
-                        outputTokens: usage.output_tokens,
+                        usage,
+                        providerDetail,
+                    });
+                    handled = true;
+                }
+                const contextUsage = extractContextUsage(ev, usage);
+                if (contextUsage) {
+                    emit({
+                        type: 'context_usage',
+                        contextUsage,
                         providerDetail,
                     });
                     handled = true;

package/dist/providers/cursor.js

@@ -468,10 +468,20 @@ function extractUsage(ev) {
     const usage = ev.usage ?? ev.token_usage ?? ev.tokenUsage ?? ev.tokens;
     if (!usage || typeof usage !== 'object')
         return null;
-    const toNumber = (v) => typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
     const input = toNumber(usage.input_tokens ?? usage.prompt_tokens ?? usage.inputTokens ?? usage.promptTokens);
     const output = toNumber(usage.output_tokens ?? usage.completion_tokens ?? usage.outputTokens ?? usage.completionTokens);
     const total = toNumber(usage.total_tokens ?? usage.totalTokens);
+    const cached = toNumber(usage.cached_input_tokens ?? usage.cachedInputTokens);
+    const reasoning = toNumber(usage.reasoning_tokens ?? usage.reasoningTokens);
     const out = {};
     if (input !== undefined)
         out.input_tokens = input;
@@ -479,6 +489,63 @@ function extractUsage(ev) {
         out.output_tokens = output;
     if (total !== undefined)
         out.total_tokens = total;
+    if (cached !== undefined)
+        out.cached_input_tokens = cached;
+    if (reasoning !== undefined)
+        out.reasoning_tokens = reasoning;
+    return Object.keys(out).length ? out : null;
+}
+function extractContextUsage(ev, usage) {
+    const context = ev.context_usage ?? ev.contextUsage;
+    const toNumber = (v) => {
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim()) {
+            const parsed = Number(v);
+            return Number.isFinite(parsed) ? parsed : undefined;
+        }
+        return undefined;
+    };
+    const toBoolean = (v) => typeof v === 'boolean' ? v : undefined;
+    const contextWindow = toNumber(context?.context_window ?? context?.contextWindow ?? ev.context_window ?? ev.contextWindow);
+    let contextTokens = toNumber(context?.context_tokens ?? context?.contextTokens ?? ev.context_tokens ?? ev.contextTokens);
+    let contextCachedTokens = toNumber(context?.context_cached_tokens ??
+        context?.contextCachedTokens ??
+        ev.context_cached_tokens ??
+        ev.contextCachedTokens);
+    let contextRemainingTokens = toNumber(context?.context_remaining_tokens ??
+        context?.contextRemainingTokens ??
+        ev.context_remaining_tokens ??
+        ev.contextRemainingTokens);
+    const contextTruncated = toBoolean(context?.context_truncated ?? context?.contextTruncated ?? ev.context_truncated ?? ev.contextTruncated);
+    if (contextTokens === undefined) {
+        if (usage?.input_tokens !== undefined &&
+            usage?.cached_input_tokens !== undefined) {
+            contextTokens = usage.input_tokens + usage.cached_input_tokens;
+        }
+        else if (usage?.input_tokens !== undefined) {
+            contextTokens = usage.input_tokens;
+        }
+    }
+    if (contextCachedTokens === undefined && usage?.cached_input_tokens !== undefined) {
+        contextCachedTokens = usage.cached_input_tokens;
+    }
+    if (contextRemainingTokens === undefined &&
+        contextWindow !== undefined &&
+        contextTokens !== undefined) {
+        contextRemainingTokens = Math.max(0, contextWindow - contextTokens);
+    }
+    const out = {};
+    if (contextWindow !== undefined)
+        out.context_window = contextWindow;
+    if (contextTokens !== undefined)
+        out.context_tokens = contextTokens;
+    if (contextCachedTokens !== undefined)
+        out.context_cached_tokens = contextCachedTokens;
+    if (contextRemainingTokens !== undefined)
+        out.context_remaining_tokens = contextRemainingTokens;
+    if (contextTruncated !== undefined)
+        out.context_truncated = contextTruncated;
     return Object.keys(out).length ? out : null;
 }
 function extractTextFromContent(content) {
@@ -787,8 +854,14 @@ export function runCursorPrompt({ prompt, system, resumeSessionId, model, repoRo
             if (usage) {
                 emit({
                     type: 'usage',
-                    inputTokens: usage.input_tokens,
-                    outputTokens: usage.output_tokens,
+                    usage,
+                });
+            }
+            const contextUsage = extractContextUsage(ev, usage);
+            if (contextUsage) {
+                emit({
+                    type: 'context_usage',
+                    contextUsage,
                 });
             }
             if (isErrorEvent(ev)) {

package/dist/summary.d.ts

@@ -1,5 +1,5 @@
 import type { Provider, ProviderId } from './types.js';
-export type SummarySource = 'prompt' | 'claude-log';
+export type SummarySource = 'prompt';
 export type SummaryPayload = {
     summary: string;
     source: SummarySource;
@@ -9,6 +9,7 @@ export type SummaryPayload = {
 };
 export declare function getSummaryModel(providerId: ProviderId): string | null;
 export declare function buildSummaryPrompt(userPrompt: string, reasoning?: string): string;
+export declare function buildSummaryPromptWithOverride(template: string, userPrompt: string, reasoning?: string): string;
 export declare function sanitizeSummary(raw: string): string;
 export declare function runSummaryPrompt(options: {
     provider: Provider;

package/dist/summary.js

@@ -26,6 +26,7 @@ export function buildSummaryPrompt(userPrompt, reasoning) {
     const clippedReasoning = reasoning?.trim() ? clipText(reasoning, REASONING_MAX_CHARS) : '';
     const lines = [
         'You write ultra-short task summaries for a chat list.',
+        'Do not run commands or edit files; only write the summary.',
         `Summarize the task in ${Math.max(6, SUMMARY_MAX_WORDS - 4)}-${SUMMARY_MAX_WORDS} words.`,
         'Capture the task and outcome; include key file/component/tech if present.',
         'Use a specific action verb; avoid vague verbs like "help" or "work on".',
@@ -42,6 +43,27 @@ export function buildSummaryPrompt(userPrompt, reasoning) {
     }
     return lines.join('\n');
 }
+export function buildSummaryPromptWithOverride(template, userPrompt, reasoning) {
+    const trimmedTemplate = template.trim();
+    if (!trimmedTemplate)
+        return buildSummaryPrompt(userPrompt, reasoning);
+    const clipped = clipText(userPrompt.trim(), 1200);
+    const clippedReasoning = reasoning?.trim() ? clipText(reasoning, REASONING_MAX_CHARS) : '';
+    const hasMessage = trimmedTemplate.includes('{{message}}');
+    const hasReasoning = trimmedTemplate.includes('{{reasoning}}');
+    let prompt = trimmedTemplate;
+    if (hasMessage)
+        prompt = prompt.replaceAll('{{message}}', clipped);
+    if (hasReasoning)
+        prompt = prompt.replaceAll('{{reasoning}}', clippedReasoning);
+    if (!hasMessage) {
+        prompt = `${prompt}\n\nUser request:\n${clipped}`;
+    }
+    if (clippedReasoning && !hasReasoning) {
+        prompt = `${prompt}\n\nInitial reasoning (first lines):\n${clippedReasoning}`;
+    }
+    return prompt;
+}
 export function sanitizeSummary(raw) {
     const normalized = raw
         .replace(/[\r\n]+/g, ' ')

package/dist/types.d.ts

@@ -116,6 +116,20 @@ export interface ModelInfo {
     reasoningEfforts?: ReasoningEffort[];
     defaultReasoningEffort?: string;
 }
+export type TokenUsage = {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    cached_input_tokens?: number;
+    reasoning_tokens?: number;
+};
+export type ContextUsage = {
+    context_window?: number;
+    context_tokens?: number;
+    context_cached_tokens?: number;
+    context_remaining_tokens?: number;
+    context_truncated?: boolean;
+};
 export interface ProviderLoginOptions {
     baseUrl?: string;
     apiKey?: string;
@@ -125,15 +139,15 @@ export interface ProviderLoginOptions {
     loginExperience?: 'embedded' | 'terminal';
 }
 export interface SessionEvent {
-    type: 'delta' | 'final' | 'usage' | 'status' | 'error' | 'raw_line' | 'message' | 'thinking' | 'tool_call' | 'detail' | 'summary';
+    type: 'delta' | 'final' | 'usage' | 'context_usage' | 'status' | 'error' | 'raw_line' | 'message' | 'thinking' | 'tool_call' | 'detail' | 'summary';
     text?: string;
     message?: string;
     line?: string;
     provider?: ProviderId;
     providerDetail?: ProviderDetail;
     providerSessionId?: string | null;
-    inputTokens?: number;
-    outputTokens?: number;
+    usage?: TokenUsage;
+    contextUsage?: ContextUsage;
     role?: 'system' | 'user' | 'assistant';
     content?: string;
     contentParts?: unknown;
@@ -146,7 +160,7 @@ export interface SessionEvent {
     timestampMs?: number;
     cancelled?: boolean;
     summary?: string;
-    source?: 'prompt' | 'claude-log';
+    source?: 'prompt';
     model?: string | null;
     createdAt?: string;
 }
@@ -195,11 +209,16 @@ export interface SessionState {
     repoRoot?: string;
     providerDetailLevel?: ProviderDetailLevel;
     systemPrompt?: string;
+    summaryMode?: 'auto' | 'off';
+    summaryPrompt?: string;
+    summaryNextMode?: 'auto' | 'off' | 'force';
+    summaryNextPrompt?: string;
+    summaryAutoUsed?: boolean;
     summaryRequested?: boolean;
     summarySeed?: string;
     summaryReasoning?: string;
     summary?: string | null;
-    summarySource?: 'prompt' | 'claude-log';
+    summarySource?: 'prompt';
     summaryModel?: string | null;
     summaryCreatedAt?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentconnect/host",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "license": "MIT",
   "type": "module",
   "homepage": "https://github.com/rayzhudev/agent-connect",