sidekick-shared 0.22.0 → 0.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -43
- package/dist/accountRegistry.d.ts +2 -0
- package/dist/accountStatus.d.ts +1 -0
- package/dist/accountStatus.js +6 -0
- package/dist/accounts.js +2 -0
- package/dist/aggregation/EventAggregator.d.ts +32 -1
- package/dist/aggregation/EventAggregator.js +238 -25
- package/dist/aggregation/snapshot.js +1 -1
- package/dist/aggregation/types.d.ts +23 -1
- package/dist/analytics/codeImpact.d.ts +20 -0
- package/dist/analytics/codeImpact.js +21 -0
- package/dist/analytics/compactionLedger.d.ts +11 -0
- package/dist/analytics/compactionLedger.js +31 -0
- package/dist/analytics/qualityScore.d.ts +26 -0
- package/dist/analytics/qualityScore.js +115 -0
- package/dist/codexProfiles.js +2 -0
- package/dist/context/composer.d.ts +3 -2
- package/dist/context/composer.js +5 -5
- package/dist/doctor.d.ts +55 -0
- package/dist/doctor.js +244 -0
- package/dist/errorHistory.d.ts +32 -0
- package/dist/errorHistory.js +94 -0
- package/dist/extractors/errorTaxonomy.d.ts +6 -0
- package/dist/extractors/errorTaxonomy.js +47 -0
- package/dist/extractors/toolCall.d.ts +9 -0
- package/dist/extractors/toolCall.js +79 -0
- package/dist/handoffUrl.d.ts +7 -0
- package/dist/handoffUrl.js +26 -0
- package/dist/index.d.ts +32 -9
- package/dist/index.js +62 -24
- package/dist/parsers/codexParser.js +13 -0
- package/dist/parsers/openCodeParser.js +13 -0
- package/dist/parsers/planExtractor.js +17 -6
- package/dist/paths.d.ts +10 -0
- package/dist/paths.js +18 -5
- package/dist/projectMigration.d.ts +23 -0
- package/dist/projectMigration.js +95 -0
- package/dist/providers/codexDatabase.d.ts +1 -11
- package/dist/providers/openCodeDatabase.d.ts +1 -31
- package/dist/providers/openCodeDatabase.js +9 -8
- package/dist/providers/types.d.ts +1 -0
- package/dist/readers/decisions.d.ts +2 -1
- package/dist/readers/decisions.js +2 -4
- package/dist/readers/handoff.d.ts +2 -1
- package/dist/readers/handoff.js +13 -8
- package/dist/readers/helpers.d.ts +3 -0
- package/dist/readers/helpers.js +12 -0
- package/dist/readers/notes.d.ts +2 -1
- package/dist/readers/notes.js +2 -4
- package/dist/readers/plans.js +1 -1
- package/dist/readers/tasks.d.ts +2 -1
- package/dist/readers/tasks.js +2 -4
- package/dist/schemas/index.d.ts +2 -0
- package/dist/schemas/index.js +10 -1
- package/dist/schemas/observedSessionV1.d.ts +499 -0
- package/dist/schemas/observedSessionV1.js +69 -0
- package/dist/schemas/sessionEvent.d.ts +13 -0
- package/dist/schemas/sessionEvent.js +19 -0
- package/dist/search/sessionSearch.d.ts +2 -2
- package/dist/search/sessionSearch.js +2 -3
- package/dist/sessionMonitor.d.ts +29 -0
- package/dist/sessionMonitor.js +71 -0
- package/dist/statusline/BurnRateCalculator.d.ts +14 -0
- package/dist/statusline/BurnRateCalculator.js +45 -0
- package/dist/statusline/formatter.d.ts +16 -0
- package/dist/statusline/formatter.js +77 -0
- package/dist/statusline/index.d.ts +7 -0
- package/dist/statusline/index.js +13 -0
- package/dist/types/codex.d.ts +2 -0
- package/dist/types/historicalData.d.ts +35 -1
- package/dist/types/historicalData.js +6 -2
- package/dist/types/observedSessionV1.d.ts +70 -0
- package/dist/types/observedSessionV1.js +185 -0
- package/dist/types/opencode.d.ts +1 -0
- package/dist/types/sessionEvent.d.ts +18 -1
- package/dist/watchers/eventBridge.js +1 -0
- package/dist/watchers/types.d.ts +5 -0
- package/dist/writers/atomic.d.ts +4 -0
- package/dist/writers/atomic.js +113 -0
- package/dist/writers/decisions.d.ts +12 -0
- package/dist/writers/decisions.js +88 -0
- package/dist/writers/notes.d.ts +8 -0
- package/dist/writers/notes.js +82 -0
- package/dist/writers/tasks.d.ts +6 -0
- package/dist/writers/tasks.js +100 -0
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -9,12 +9,13 @@ Types, parsers, providers, readers, formatters, aggregation, search, reporting,
|
|
|
9
9
|
|
|
10
10
|
## Recent additions
|
|
11
11
|
|
|
12
|
+
- **Observed-session V1 contracts** — versioned provider-neutral `ObservedAgentSessionV1` / `ProviderCapabilitiesV1` / `PendingUserRequestV1` shapes with `createProviderSessionAdapterV1()` adapters and matching Zod schemas in [`sidekick-shared/schemas`](#supported-import-paths).
|
|
13
|
+
- **Atomic writers** — `addTask()`, `completeTask()`, `addDecision()`, and `addNote()` merge into the shared task/decision/note stores atomically, so concurrent CLI and extension captures are never lost.
|
|
14
|
+
- **Doctor report** — `runDoctor()` builds a typed cross-provider health report (project identity, sessions, accounts, providers, dependencies); `formatHealthReport()` renders it for terminals.
|
|
15
|
+
- **Analytics engines** — `scoreSessionQuality()` (beta) with weekly trends via `calculateQualityTrend()`, `calculateCodeImpact()` for cost per changed line and per-model churn, and `calculateCompactionLedger()` for reported-vs-heuristic compaction accounting.
|
|
16
|
+
- **Error taxonomy & history** — `categorizeError()` assigns one shared taxonomy at ingest, and `appendErrorHistory()` / `getTopFailingTools()` keep an append-only per-project failure history.
|
|
17
|
+
- **Statusline & burn rate** — `formatStatusline()` and `BurnRateCalculator` render a cache-only account/quota/burn footer, importable from the new [`sidekick-shared/statusline`](#supported-import-paths) subpath.
|
|
12
18
|
- **Codex reset credits** — `fetchCodexResetCreditsFromApi()` reads ChatGPT's reset-credit endpoint into a `CodexResetCreditsSnapshot`, and `fetchCodexQuotaFromApi()` attaches it to the returned quota state (preserved across session-sourced snapshot writes).
|
|
13
|
-
- **Assistant-turn projection** — `segmentAssistantTurn()` / `assistantTurnEventsFromSessionEvents()` segment a provider-normalized turn into a browser-safe Timeline + Process + Answer shape (see [Assistant Turns](#api-overview)).
|
|
14
|
-
- **Session-context snapshots** — `buildSessionContextSnapshot()` / `calculateSessionContextPressure()` expose layered evidence sources and low/medium/high context pressure.
|
|
15
|
-
- **Zod boundary schemas** — runtime validation for data crossing process/IPC boundaries, importable fs-free from [`sidekick-shared/schemas`](#supported-import-paths).
|
|
16
|
-
- **Opus 4.8 & Fable 5 model info** — 1M-token context windows and pricing, plus forgiving (trim/lowercase) model-ID lookups.
|
|
17
|
-
- **Node-only asset extraction** — `gatherAssetsForCwd()` collects URLs, file paths, commands, and plans from recent Claude Code and Codex sessions.
|
|
18
19
|
|
|
19
20
|
See the [full changelog](https://github.com/cesarandreslopez/sidekick-agent-hub/blob/main/CHANGELOG.md) for everything.
|
|
20
21
|
|
|
@@ -26,49 +27,56 @@ npm install sidekick-shared
|
|
|
26
27
|
|
|
27
28
|
## API Overview
|
|
28
29
|
|
|
29
|
-
| Module | Description
|
|
30
|
-
| ------------------------------- |
|
|
31
|
-
| **Types** | Session events, OpenCode/Codex format types, persistence schemas (tasks, decisions, notes, plans, historical data)
|
|
32
|
-
| **Paths** | Config directory resolution, project data paths, workspace encoding
|
|
33
|
-
| **Readers** | Read tasks, decisions, notes, history, handoff, and plans from `~/.config/sidekick/`
|
|
34
|
-
| **
|
|
35
|
-
| **
|
|
36
|
-
| **
|
|
37
|
-
| **
|
|
38
|
-
| **
|
|
39
|
-
| **
|
|
40
|
-
| **
|
|
41
|
-
| **
|
|
42
|
-
| **
|
|
43
|
-
| **
|
|
44
|
-
| **
|
|
45
|
-
| **
|
|
46
|
-
| **
|
|
47
|
-
| **
|
|
48
|
-
| **
|
|
49
|
-
| **
|
|
50
|
-
| **
|
|
51
|
-
| **
|
|
52
|
-
| **
|
|
53
|
-
| **
|
|
54
|
-
| **
|
|
55
|
-
| **Quota
|
|
56
|
-
| **
|
|
30
|
+
| Module | Description |
|
|
31
|
+
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
32
|
+
| **Types** | Session events, OpenCode/Codex format types, persistence schemas (tasks, decisions, notes, plans, historical data) |
|
|
33
|
+
| **Paths** | Config directory resolution, project data paths, workspace encoding |
|
|
34
|
+
| **Readers** | Read tasks, decisions, notes, history, handoff, and plans from `~/.config/sidekick/` |
|
|
35
|
+
| **Writers** | Atomic persistence writers — `atomicWriteJson()` / `updateJsonStoreAtomic()` plus lock-coordinated capture helpers `addTask()`, `completeTask()`, `addDecision()`, `addNote()` that merge into the shared stores without clobbering concurrent writers |
|
|
36
|
+
| **Providers** | Session provider abstraction with Claude Code, OpenCode, and Codex implementations; auto-detection via filesystem |
|
|
37
|
+
| **Observed Sessions (V1)** | Versioned provider-neutral observation contracts — `createProviderSessionAdapterV1()` / `derivePendingUserRequestV1()` with `ObservedAgentSessionV1`, `ProviderCapabilitiesV1`, `PendingUserRequestV1`, `SessionEvidenceRefV1`, and provenance/confidence wrapper types (Zod schemas in `sidekick-shared/schemas`) |
|
|
38
|
+
| **Parsers** | JSONL event parsing, OpenCode/Codex format normalization, subagent scanning, session path resolution, debug log parsing |
|
|
39
|
+
| **Watchers** | Live session file watching with event bridging, plus `createJsonlTail()` for raw incremental JSONL consumers |
|
|
40
|
+
| **Formatters** | Display helpers (`formatTokenCount()`, `formatDurationMs()`), tool summary, noise classification, session dump (text/markdown/JSON), event highlighting |
|
|
41
|
+
| **Search** | Cross-session full-text search, advanced filtering (substring, fuzzy, regex, date) |
|
|
42
|
+
| **Aggregation** | Event aggregation, frequency tracking, activity heatmaps, pattern extraction |
|
|
43
|
+
| **Analytics** | Session-quality scoring (beta) with factor contributions and weekly trends (`scoreSessionQuality()`, `calculateQualityTrend()`), code-impact metrics including cost per changed line and per-model churn/cost (`calculateCodeImpact()`), and reported-vs-heuristic compaction accounting (`calculateCompactionLedger()`, `formatCompactionLedger()`) |
|
|
44
|
+
| **Error History** | Shared error taxonomy (`categorizeError()`, `extractErrorMessage()`) plus append-only per-project failure history (`appendErrorHistory()`, `readErrorHistory()`, `getTopFailingTools()`) behind per-tool/hour/model error rollups |
|
|
45
|
+
| **Session Context** | Provider-neutral context evidence snapshots (`buildSessionContextSnapshot()`, `calculateSessionContextPressure()`, `createSessionContextProjector()`, `readSessionContextSnapshot()`): layered evidence sources, low/medium/high context pressure, and observed capabilities (tools, MCP servers, permission mode, rate limits) |
|
|
46
|
+
| **Assistant Turns** | Browser-safe timeline/process/answer projection for provider-normalized assistant turns (`segmentAssistantTurn()`, `assistantTurnEventsFromSessionEvents()`), including interleaved reasoning, compact tool groups, and Claude `Task` subagent refs without prompt leakage |
|
|
47
|
+
| **Report** | Self-contained HTML session report generation |
|
|
48
|
+
| **Credentials** | Claude Max OAuth credential reading from `~/.claude/.credentials.json` |
|
|
49
|
+
| **Quota** | Claude Max subscription quota fetching (5-hour and 7-day windows), Codex rate-limit extraction from event streams (plus Codex reset credits via `fetchCodexResetCreditsFromApi()`, attached to quota state by `fetchCodexQuotaFromApi()`), and authoritative z.ai Coding Plan quota fetching via `resolveZaiQuota()` / `fetchZaiQuotaFromApi()` (reads z.ai's `api/monitor/usage/quota/limit` endpoint with cached-snapshot fallback). The deprecated observed-traffic z.ai estimator exports were removed in 0.23.0 — `resolveZaiQuota()` is the single z.ai quota API |
|
|
50
|
+
| **Provider Status** | API health checking via status.claude.com and status.openai.com (indicator, components, incidents) |
|
|
51
|
+
| **Doctor** | Typed cross-provider health diagnostics — `runDoctor()` checks project identity, sessions, accounts, providers, and dependencies into a `HealthReport`; `formatHealthReport()` renders it and `getSessionDiagnostics()` exposes the per-provider session probe |
|
|
52
|
+
| **Schemas** | Zod schemas for runtime validation of data crossing process/IPC boundaries — JSONL session events (`sessionEventSchema`, `messageUsageSchema`, `sessionMessageSchema`), assistant turns, observed-session V1 records, quota, account status, and quota history — plus `extractSessionEvents()` to unwrap `progress`-wrapped events. Also published fs-free via the [`sidekick-shared/schemas`](#supported-import-paths) subpath |
|
|
53
|
+
| **Extractors** | Pure functions for single-event processing: `extractTokenUsage()`, `extractToolCall()` (top-level `tool_use`), `extractToolCalls()` (assistant content blocks), plus Node-only session asset extraction (`gatherAssetsForCwd()`, `readClaudeAssets()`, `readCodexAssets()`) for URLs, file paths, commands, and plans |
|
|
54
|
+
| **Model Info & Pricing** | Model family parsing (Anthropic / OpenAI / Google, including legacy `claude-3-opus-…` and `claude-3-5-sonnet-…` IDs), context-window lookup (including Fable 5 / Opus 4.8 / Opus 4.7 / Sonnet 4.7 1M and GPT-5.x variants), pricing tables with optional LiteLLM hydration, null-aware cost (`calculateCost()`), provenance-preserving cost (`calculateCostWithProvenance()`, `mergeCostSources()`), and display helpers (`shortModelName()`, `getModelDisplayInfo()`, `compareModelIds()`, `sortModelIds()`, `formatCost()`) |
|
|
55
|
+
| **Quota Polling** | `QuotaPoller` class with exponential backoff, active/idle intervals, and cached fallback |
|
|
56
|
+
| **Multi-Provider Quota** | `MultiProviderQuotaService` orchestrates Claude polling + peak-hours + account labels + Codex/z.ai quota updates behind one typed event stream. `CodexQuotaWatcher` watches the active Codex rollout for live rate limits with snapshot fallback; z.ai quota uses the API resolver with snapshot fallback |
|
|
57
|
+
| **Accounts** | Multi-provider account registry (v2) with per-provider active account, save/switch/remove, v1 migration, `ensureDefaultAccounts()` for first-run bootstrap of the active system Claude/Codex credentials as a "Default" saved account, `getActiveAccountStatus()` for a single-pass active-account read across providers, and live-first `resolveActiveClaudeAccount()` / `resolveActiveCodexAccount()` that report the currently logged-in account (self-healing the saved pointer) for display |
|
|
58
|
+
| **Account Management 2.0** | Provider-neutral acquisition + switching: `beginAccountLogin()` / `getAccountLoginStatus()` / `finalizeAccountLogin()` / `spawnAccountLogin()` drive a TTY-less, profile-isolated login that doesn't disturb the active account until finalization; `listAllAccounts()` and `switchAccount()` expose a shared switcher across Claude and Codex. Claude accounts get canonical profile homes with account-scoped macOS keychain suffixes and startup migration from legacy flat backups |
|
|
59
|
+
| **Terminal sync & auto-switch** | Opt-in terminal profile pointers, shell-hook/launcher helpers, and a default-off `AutoSwitchController` (`decideAutoSwitch()`) that moves to a healthier saved account when quota crosses a configured threshold |
|
|
60
|
+
| **Codex Profiles** | Codex account lifecycle — prepare, finalize, switch, remove — switching atomically swaps the profile's backed-up credentials into the system `~/.codex/auth.json`, with rotated-token staleness protection, one-time dual-home migration, and legacy multi-home session monitoring |
|
|
61
|
+
| **Quota Snapshots** | Persistent quota caching per provider/account for offline fallback |
|
|
62
|
+
| **Statusline** | Cache-only one-line account/quota/burn footer — `formatStatusline()`, `selectStatuslineAccount()`, `BurnRateCalculator`, and `estimateTimeToQuota()`, also published via the [`sidekick-shared/statusline`](#supported-import-paths) subpath for fast per-prompt rendering |
|
|
63
|
+
| **Phrases** | Curated humorous phrases for loading/idle states, available as a flat `ALL_PHRASES` array or grouped via `PHRASE_CATEGORIES` for category-aware UI |
|
|
57
64
|
|
|
58
65
|
## Supported import paths
|
|
59
66
|
|
|
60
67
|
`sidekick-shared` ships three public entry points plus a few convenience subpaths. Pick the one that matches your runtime.
|
|
61
68
|
|
|
62
|
-
| Path | Runtime | What it exposes
|
|
63
|
-
| ------------------------------ | -------------------------- |
|
|
64
|
-
| `sidekick-shared` | Node (CLI, extension host) | Full public API (readers, providers, parsers, pricing, …).
|
|
65
|
-
| `sidekick-shared/browser` | **Browser / webview** | Pure helpers: context-window lookup, model parsing, cost math, assistant turn projection.
|
|
66
|
-
| `sidekick-shared/node` | Node only | LiteLLM pricing catalog hydration (`fs` + `path`).
|
|
67
|
-
| `sidekick-shared/phrases` | Any runtime | Phrase arrays + `getRandomPhrase()`.
|
|
68
|
-
| `sidekick-shared/modelContext` | Any runtime | Direct access to the context-window module.
|
|
69
|
-
| `sidekick-shared/modelInfo` | Any runtime | Direct access to model parsing and cost math.
|
|
70
|
-
| `sidekick-shared/formatting` | Any runtime | Direct access to pure token and duration display helpers.
|
|
71
|
-
| `sidekick-shared/schemas` | Any runtime | Pure Zod boundary schemas (session events, assistant turns, quota, account status, quota history) — fs-free, no Node builtins. |
|
|
69
|
+
| Path | Runtime | What it exposes |
|
|
70
|
+
| ------------------------------ | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
71
|
+
| `sidekick-shared` | Node (CLI, extension host) | Full public API (readers, providers, parsers, pricing, …). |
|
|
72
|
+
| `sidekick-shared/browser` | **Browser / webview** | Pure helpers: context-window lookup, model parsing, cost math, assistant turn projection. |
|
|
73
|
+
| `sidekick-shared/node` | Node only | LiteLLM pricing catalog hydration (`fs` + `path`). |
|
|
74
|
+
| `sidekick-shared/phrases` | Any runtime | Phrase arrays + `getRandomPhrase()`. |
|
|
75
|
+
| `sidekick-shared/modelContext` | Any runtime | Direct access to the context-window module. |
|
|
76
|
+
| `sidekick-shared/modelInfo` | Any runtime | Direct access to model parsing and cost math. |
|
|
77
|
+
| `sidekick-shared/formatting` | Any runtime | Direct access to pure token and duration display helpers. |
|
|
78
|
+
| `sidekick-shared/schemas` | Any runtime | Pure Zod boundary schemas (session events, assistant turns, observed-session V1, quota, account status, quota history) — fs-free, no Node builtins. |
|
|
79
|
+
| `sidekick-shared/statusline` | Node only | Cache-only statusline surface: account status + quota snapshot readers, `formatStatusline()`, and burn-rate estimates. |
|
|
72
80
|
|
|
73
81
|
### Browser / webview runtimes
|
|
74
82
|
|
|
@@ -34,6 +34,8 @@ export interface ResolvedActiveAccount {
|
|
|
34
34
|
email?: string;
|
|
35
35
|
label?: string;
|
|
36
36
|
providerAccountId?: string;
|
|
37
|
+
/** Stable Sidekick registry ID used by cache/history stores. */
|
|
38
|
+
registryAccountId?: string;
|
|
37
39
|
source: 'live' | 'registry' | 'none';
|
|
38
40
|
}
|
|
39
41
|
export declare function getAccountsDir(): string;
|
package/dist/accountStatus.d.ts
CHANGED
package/dist/accountStatus.js
CHANGED
|
@@ -19,6 +19,9 @@ function getActiveAccountStatus(error) {
|
|
|
19
19
|
const claude = claudeAccount.source !== 'none'
|
|
20
20
|
? {
|
|
21
21
|
present: true,
|
|
22
|
+
...(claudeAccount.registryAccountId
|
|
23
|
+
? { accountId: claudeAccount.registryAccountId }
|
|
24
|
+
: {}),
|
|
22
25
|
email: claudeAccount.email,
|
|
23
26
|
label: claudeAccount.label ?? claudeAccount.email,
|
|
24
27
|
}
|
|
@@ -26,6 +29,9 @@ function getActiveAccountStatus(error) {
|
|
|
26
29
|
const codex = codexAccount.source !== 'none'
|
|
27
30
|
? {
|
|
28
31
|
present: true,
|
|
32
|
+
...(codexAccount.registryAccountId
|
|
33
|
+
? { accountId: codexAccount.registryAccountId }
|
|
34
|
+
: {}),
|
|
29
35
|
email: codexAccount.email,
|
|
30
36
|
label: codexAccount.label ?? codexAccount.email ?? codexAccount.providerAccountId,
|
|
31
37
|
}
|
package/dist/accounts.js
CHANGED
|
@@ -549,6 +549,7 @@ function resolveActiveClaudeAccount() {
|
|
|
549
549
|
email: live.email,
|
|
550
550
|
label: match?.label,
|
|
551
551
|
providerAccountId: live.uuid,
|
|
552
|
+
registryAccountId: match?.id,
|
|
552
553
|
source: 'live',
|
|
553
554
|
};
|
|
554
555
|
}
|
|
@@ -558,6 +559,7 @@ function resolveActiveClaudeAccount() {
|
|
|
558
559
|
email: active.email,
|
|
559
560
|
label: active.label,
|
|
560
561
|
providerAccountId: active.uuid,
|
|
562
|
+
registryAccountId: active.uuid,
|
|
561
563
|
source: 'registry',
|
|
562
564
|
};
|
|
563
565
|
}
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*/
|
|
10
10
|
import type { SessionEvent, ToolAnalytics, TimelineEvent, TrackedTask, TaskState, PlanState, CompactionEvent, TruncationEvent, ContextAttribution, ContextSizePoint, ResponseLatency, LatencyStats, PermissionMode, PermissionModeChange } from '../types/sessionEvent';
|
|
11
11
|
import type { FollowEvent } from '../watchers/types';
|
|
12
|
-
import type { EventAggregatorOptions, AggregatedTokens, ModelUsageStats, BurnRateInfo, SubagentLifecycle, AggregatedMetrics } from './types';
|
|
12
|
+
import type { EventAggregatorOptions, AggregatedTokens, ModelUsageStats, BurnRateInfo, SubagentLifecycle, AggregatedMetrics, ErrorRollup, ErrorRollupEntry, ErrorBucketMetric } from './types';
|
|
13
13
|
import type { SerializedFrequencyState } from './FrequencyTracker';
|
|
14
14
|
import type { SerializedHeatmapState } from './HeatmapTracker';
|
|
15
15
|
import type { SerializedPatternState } from './PatternExtractor';
|
|
@@ -45,6 +45,10 @@ export interface SerializedAggregatorState {
|
|
|
45
45
|
compactionEvents: CompactionEvent[];
|
|
46
46
|
truncationEvents: TruncationEvent[];
|
|
47
47
|
toolAnalytics: Array<[string, ToolAnalytics]>;
|
|
48
|
+
errorByToolCategory: Array<[string, ErrorRollupEntry]>;
|
|
49
|
+
errorBuckets: Array<[string, ErrorBucketMetric]>;
|
|
50
|
+
retryAttempts: number;
|
|
51
|
+
finishReasons: Array<[string, number]>;
|
|
48
52
|
contextAttribution: ContextAttribution;
|
|
49
53
|
burnSamples: BurnSample[];
|
|
50
54
|
lastBurnSampleTime: number;
|
|
@@ -94,10 +98,20 @@ export declare class EventAggregator {
|
|
|
94
98
|
private modelUsage;
|
|
95
99
|
private currentContextSize;
|
|
96
100
|
private previousContextSize;
|
|
101
|
+
/**
|
|
102
|
+
* Index of a heuristic compaction event still awaiting its real
|
|
103
|
+
* post-compaction size from the next usage event. Prevents the usage-drop
|
|
104
|
+
* detector from double-counting an explicit compaction marker.
|
|
105
|
+
*/
|
|
106
|
+
private pendingHeuristicCompactionIndex;
|
|
97
107
|
private compactionEvents;
|
|
98
108
|
private truncationEvents;
|
|
99
109
|
private toolAnalytics;
|
|
100
110
|
private pendingToolCalls;
|
|
111
|
+
private errorByToolCategory;
|
|
112
|
+
private errorBuckets;
|
|
113
|
+
private retryAttempts;
|
|
114
|
+
private finishReasons;
|
|
101
115
|
private burnSamples;
|
|
102
116
|
private lastBurnSampleTime;
|
|
103
117
|
private tokensSinceLastSample;
|
|
@@ -107,6 +121,8 @@ export declare class EventAggregator {
|
|
|
107
121
|
private subagents;
|
|
108
122
|
private pendingSubagents;
|
|
109
123
|
private planExtractor;
|
|
124
|
+
private planState;
|
|
125
|
+
private planEnteredAt;
|
|
110
126
|
private contextAttribution;
|
|
111
127
|
private currentPermissionMode;
|
|
112
128
|
private permissionModeHistory;
|
|
@@ -131,6 +147,7 @@ export declare class EventAggregator {
|
|
|
131
147
|
getAggregatedTokens(): AggregatedTokens;
|
|
132
148
|
getModelStats(): ModelUsageStats[];
|
|
133
149
|
getToolStats(): ToolAnalytics[];
|
|
150
|
+
getErrorRollup(): ErrorRollup;
|
|
134
151
|
getCompactionEvents(): CompactionEvent[];
|
|
135
152
|
getTruncationEvents(): TruncationEvent[];
|
|
136
153
|
getBurnRate(): BurnRateInfo;
|
|
@@ -157,10 +174,20 @@ export declare class EventAggregator {
|
|
|
157
174
|
private detectTruncationInContent;
|
|
158
175
|
private recordFollowToolUse;
|
|
159
176
|
private recordFollowToolResult;
|
|
177
|
+
private recordProviderMetadata;
|
|
178
|
+
private recordError;
|
|
160
179
|
private detectTruncationFromFollowEvent;
|
|
180
|
+
private recordExplicitCompaction;
|
|
181
|
+
/**
|
|
182
|
+
* Fills a pending heuristic compaction with the first observed
|
|
183
|
+
* post-compaction context size. Returns true when the observed drop was
|
|
184
|
+
* consumed by that pending event, so the caller must not record it again.
|
|
185
|
+
*/
|
|
186
|
+
private resolvePendingHeuristicCompaction;
|
|
161
187
|
private extractTaskStateFromEvent;
|
|
162
188
|
private extractTaskStateFromFollowEvent;
|
|
163
189
|
private applyTaskUpdate;
|
|
190
|
+
private syncPlanStepFromTaskUpdate;
|
|
164
191
|
private resolveTaskCreate;
|
|
165
192
|
private handleTodoWrite;
|
|
166
193
|
private handleUpdatePlan;
|
|
@@ -171,7 +198,11 @@ export declare class EventAggregator {
|
|
|
171
198
|
private extractSubagentFromFollowEvent;
|
|
172
199
|
private completeSubagent;
|
|
173
200
|
private extractPlanFromSessionEvent;
|
|
201
|
+
private processPlanFollowEvent;
|
|
174
202
|
private convertExtractedPlanToPlanState;
|
|
203
|
+
private getActivePlanStep;
|
|
204
|
+
private attributePlanUsage;
|
|
205
|
+
private attributePlanToolCall;
|
|
175
206
|
private attributeContextFromEvent;
|
|
176
207
|
private attributeContextFromFollowEvent;
|
|
177
208
|
private trackPermissionMode;
|