sidekick-shared 0.19.2 → 0.19.3

package/README.md

@@ -27,7 +27,7 @@ npm install sidekick-shared
 | **Search** | Cross-session full-text search, advanced filtering (substring, fuzzy, regex, date) |
 | **Aggregation** | Event aggregation, frequency tracking, activity heatmaps, pattern extraction |
 | **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) |
-| **Assistant Turns** | Browser-safe process/answer projection for provider-normalized assistant turns (`segmentAssistantTurn()`, `assistantTurnEventsFromSessionEvents()`), including reasoning blocks, compact tool groups, and Claude `Task` subagent refs without prompt leakage |
+| **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 |
 | **Report** | Self-contained HTML session report generation |
 | **Credentials** | Claude Max OAuth credential reading from `~/.claude/.credentials.json` |
 | **Quota** | Claude Max subscription quota fetching (5-hour and 7-day windows) and Codex rate-limit extraction from event streams |
@@ -204,9 +204,9 @@ if (provider) {
 
 Use `createSessionContextProjector()` for incremental updates as new events stream in, or `calculateSessionContextPressure(contextTokens, contextWindow)` for the pressure band alone.
 
-### Project an assistant turn into Process + Answer
+### Project an assistant turn into Timeline + Process + Answer
 
-Build a compact UI-safe projection from provider-normalized turn events. The final contiguous text run becomes `answer`; earlier narration, tools, and reasoning stay in `process` / `reasoningBlocks`.
+Build a compact UI-safe projection from provider-normalized turn events. The final contiguous text run becomes `answer`; earlier narration, tools, and reasoning stay in `process` / `reasoningBlocks`, and `timeline` preserves their interleaved arrival order for rendering.
 
 ```typescript
 import {
@@ -217,6 +217,7 @@ import {
 const projection = segmentAssistantTurn(assistantTurnEventsFromSessionEvents(sessionEvents));
 
 console.log(projection.answer);
+console.log(projection.timeline);
 console.log(projection.process.steps);
 console.log(projection.subagents); // Claude Task spawns, prompt text omitted
 ```

package/dist/browser.d.ts

@@ -13,6 +13,6 @@ export type { FormatDurationMsOptions, FormatTokenCountOptions } from './formatt
 export { buildSessionContextSnapshot, calculateSessionContextPressure, createSessionContextProjector, } from './context/sessionContext';
 export type { BuildSessionContextSnapshotOptions, SessionContextCapabilities, SessionContextLayerBreakdown, SessionContextPressure, SessionContextProjector, SessionContextSnapshot, SessionContextSource, SessionContextSourceType, } from './context/sessionContext';
 export { assistantTurnEventsFromSessionEvents, extractTurnSubagents, isAssistantTurnSubagentTool, reasoningSummary, segmentAssistantTurn, } from './turns/assistantTurn';
-export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnToolRef, ExtractTurnSubagentsOptions, ReasoningSummary, SegmentAssistantTurnOptions, } from './turns/assistantTurn';
+export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnTimelineItem, AssistantTurnToolRef, ExtractTurnSubagentsOptions, ReasoningSummary, SegmentAssistantTurnOptions, } from './turns/assistantTurn';
 export { parseModelId, getModelPricing, getModelInfo, calculateCost, calculateCostWithPricing, calculateCostWithProvenance, mergeCostSources, shortModelName, getModelDisplayInfo, compareModelIds, sortModelIds, formatCost, } from './modelInfo';
 export type { ModelPricing, CostTokenUsage, CostSource, CostProvenanceInput, CostWithProvenance, ModelProvider, ParsedModelId, ModelInfo, ModelDisplayInfo, } from './modelInfo';

package/dist/index.d.ts

@@ -53,7 +53,7 @@ export type { Fidelity, ContextResult } from './context/composer';
 export { buildSessionContextSnapshot, calculateSessionContextPressure, createSessionContextProjector, readSessionContextSnapshot, } from './context/sessionContext';
 export type { BuildSessionContextSnapshotOptions, ReadSessionContextSnapshotOptions, SessionContextCapabilities, SessionContextLayerBreakdown, SessionContextPressure, SessionContextProjector, SessionContextSnapshot, SessionContextSource, SessionContextSourceType, } from './context/sessionContext';
 export { assistantTurnEventsFromSessionEvents, extractTurnSubagents, isAssistantTurnSubagentTool, reasoningSummary, segmentAssistantTurn, } from './turns/assistantTurn';
-export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnToolRef, ExtractTurnSubagentsOptions, ReasoningSummary, SegmentAssistantTurnOptions, } from './turns/assistantTurn';
+export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnTimelineItem, AssistantTurnToolRef, ExtractTurnSubagentsOptions, ReasoningSummary, SegmentAssistantTurnOptions, } from './turns/assistantTurn';
 export { PlanExtractor, parsePlanMarkdown as parsePlanMarkdownShared, extractProposedPlan as extractProposedPlanShared } from './parsers/planExtractor';
 export type { ExtractedPlan, ExtractedPlanStep } from './parsers/planExtractor';
 export { parseChangelog } from './parsers/changelogParser';
@@ -128,7 +128,7 @@ export { messageUsageSchema, sessionMessageSchema, sessionEventSchema, permissio
 export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, providerQuotaMapSchema, } from './schemas/quota';
 export { quotaHistoryRuntimeProviderSchema, quotaHistorySampleSchema, quotaHistoryDailyBucketSchema, } from './schemas/quotaHistory';
 export { activeProviderAccountStatusSchema, activeAccountStatusSchema, } from './schemas/accountStatus';
-export { assistantTurnEventSchema, assistantTurnEventTypeSchema, assistantTurnNarrationStepSchema, assistantTurnProcessSchema, assistantTurnProcessStepSchema, assistantTurnProjectionSchema, assistantTurnSubagentSchema, assistantTurnSubagentStatusSchema, assistantTurnToolGroupStepSchema, assistantTurnToolRefSchema, } from './schemas/assistantTurn';
+export { assistantTurnEventSchema, assistantTurnEventTypeSchema, assistantTurnNarrationStepSchema, assistantTurnProcessSchema, assistantTurnProcessStepSchema, assistantTurnProjectionSchema, assistantTurnReasoningTimelineItemSchema, assistantTurnSubagentSchema, assistantTurnSubagentStatusSchema, assistantTurnTimelineItemSchema, assistantTurnToolGroupStepSchema, assistantTurnToolRefSchema, } from './schemas/assistantTurn';
 export { fetchProviderStatus, fetchOpenAIStatus } from './providerStatus';
 export type { ProviderStatusState } from './providerStatus';
 export { createPeakHoursNotApplicableState, fetchPeakHoursStatus, isClaudeCodeSessionProvider, scopePeakHoursToSessionProvider, } from './peakHours';

package/dist/index.js

@@ -7,7 +7,7 @@ exports.findActiveClaudeSession = exports.discoverSessionDirectory = exports.get
 exports.clearHighlightCache = exports.highlightEvent = exports.formatSessionJson = exports.formatSessionMarkdown = exports.formatSessionText = exports.classifyNoise = exports.shouldMergeWithPrevious = exports.classifyFollowEvent = exports.classifyMessage = exports.getSoftNoiseReason = exports.isHardNoiseFollowEvent = exports.isHardNoise = exports.formatToolSummary = exports.formatTokenCount = exports.formatDurationMs = exports.createJsonlTail = exports.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = exports.segmentAssistantTurn = exports.reasoningSummary = exports.isAssistantTurnSubagentTool = exports.extractTurnSubagents = exports.assistantTurnEventsFromSessionEvents = exports.readSessionContextSnapshot = exports.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = void 0;
 exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getActiveCodexAccount = exports.listCodexAccounts = exports.getSystemCodexHome = exports.getCodexMonitoringHomes = exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.getActiveAccountStatus = exports.removeSavedAccountProfile = exports.replaceSavedAccountProfiles = exports.setActiveSavedAccount = exports.upsertSavedAccountProfile = exports.getActiveSavedAccount = exports.listSavedAccountProfiles = exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.isMultiAccountEnabled = exports.getActiveAccount = exports.listAccounts = exports.removeAccount = exports.switchToAccount = exports.addCurrentAccount = exports.readActiveClaudeAccount = exports.writeAccountRegistry = exports.readAccountRegistry = exports.ensureDefaultAccounts = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.writeActiveCredentials = exports.readActiveCredentials = exports.openInBrowser = exports.parseTranscriptFromEvents = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = void 0;
 exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.extractToolCalls = exports.extractToolCall = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.MultiProviderQuotaService = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = exports.fetchCodexQuotaFromApi = exports.getWorkspaceIdFromPath = exports.pruneQuotaHistory = exports.readQuotaHistoryDailyBuckets = exports.readQuotaHistoryRange = exports.appendQuotaHistorySample = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.fetchQuota = exports.removeCodexAccount = exports.switchToCodexAccount = exports.finalizeCodexAccount = exports.prepareCodexAccount = void 0;
-exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = void 0;
+exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = void 0;
 var taskPersistence_1 = require("./types/taskPersistence");
 Object.defineProperty(exports, "TASK_PERSISTENCE_SCHEMA_VERSION", { enumerable: true, get: function () { return taskPersistence_1.TASK_PERSISTENCE_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "normalizeTaskStatus", { enumerable: true, get: function () { return taskPersistence_1.normalizeTaskStatus; } });
@@ -334,8 +334,10 @@ Object.defineProperty(exports, "assistantTurnNarrationStepSchema", { enumerable:
 Object.defineProperty(exports, "assistantTurnProcessSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnProcessSchema; } });
 Object.defineProperty(exports, "assistantTurnProcessStepSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnProcessStepSchema; } });
 Object.defineProperty(exports, "assistantTurnProjectionSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnProjectionSchema; } });
+Object.defineProperty(exports, "assistantTurnReasoningTimelineItemSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnReasoningTimelineItemSchema; } });
 Object.defineProperty(exports, "assistantTurnSubagentSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnSubagentSchema; } });
 Object.defineProperty(exports, "assistantTurnSubagentStatusSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnSubagentStatusSchema; } });
+Object.defineProperty(exports, "assistantTurnTimelineItemSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnTimelineItemSchema; } });
 Object.defineProperty(exports, "assistantTurnToolGroupStepSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnToolGroupStepSchema; } });
 Object.defineProperty(exports, "assistantTurnToolRefSchema", { enumerable: true, get: function () { return assistantTurn_2.assistantTurnToolRefSchema; } });
 // Provider Status

package/dist/schemas/assistantTurn.d.ts

@@ -64,6 +64,24 @@ export declare const assistantTurnProcessStepSchema: z.ZodDiscriminatedUnion<[z.
         toolUseId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>], "kind">;
+export declare const assistantTurnReasoningTimelineItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"reasoning">;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const assistantTurnTimelineItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"reasoning">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"narration">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"toolGroup">;
+    tools: z.ZodArray<z.ZodObject<{
+        toolName: z.ZodString;
+        toolInput: z.ZodOptional<z.ZodString>;
+        toolUseId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "kind">;
 export declare const assistantTurnProcessSchema: z.ZodObject<{
     steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"narration">;
@@ -93,7 +111,7 @@ export declare const assistantTurnSubagentSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export declare const assistantTurnProjectionSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
+    schemaVersion: z.ZodLiteral<2>;
     answer: z.ZodString;
     reasoning: z.ZodString;
     reasoningBlocks: z.ZodArray<z.ZodString>;
@@ -110,6 +128,20 @@ export declare const assistantTurnProjectionSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>;
+    timeline: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"reasoning">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"narration">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"toolGroup">;
+        tools: z.ZodArray<z.ZodObject<{
+            toolName: z.ZodString;
+            toolInput: z.ZodOptional<z.ZodString>;
+            toolUseId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">>;
     subagents: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;

package/dist/schemas/assistantTurn.js

@@ -6,7 +6,7 @@
  * process/answer shape used at UI and IPC boundaries.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assistantTurnProjectionSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnProcessSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnToolRefSchema = exports.assistantTurnEventSchema = exports.assistantTurnEventTypeSchema = void 0;
+exports.assistantTurnProjectionSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnProcessSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnToolRefSchema = exports.assistantTurnEventSchema = exports.assistantTurnEventTypeSchema = void 0;
 const zod_1 = require("zod");
 exports.assistantTurnEventTypeSchema = zod_1.z.enum([
     'text',
@@ -43,6 +43,15 @@ exports.assistantTurnProcessStepSchema = zod_1.z.discriminatedUnion('kind', [
     exports.assistantTurnNarrationStepSchema,
     exports.assistantTurnToolGroupStepSchema,
 ]);
+exports.assistantTurnReasoningTimelineItemSchema = zod_1.z.object({
+    kind: zod_1.z.literal('reasoning'),
+    text: zod_1.z.string(),
+});
+exports.assistantTurnTimelineItemSchema = zod_1.z.discriminatedUnion('kind', [
+    exports.assistantTurnReasoningTimelineItemSchema,
+    exports.assistantTurnNarrationStepSchema,
+    exports.assistantTurnToolGroupStepSchema,
+]);
 exports.assistantTurnProcessSchema = zod_1.z.object({
     steps: zod_1.z.array(exports.assistantTurnProcessStepSchema),
 });
@@ -58,10 +67,11 @@ exports.assistantTurnSubagentSchema = zod_1.z.object({
     status: exports.assistantTurnSubagentStatusSchema,
 });
 exports.assistantTurnProjectionSchema = zod_1.z.object({
-    schemaVersion: zod_1.z.literal(1),
+    schemaVersion: zod_1.z.literal(2),
     answer: zod_1.z.string(),
     reasoning: zod_1.z.string(),
     reasoningBlocks: zod_1.z.array(zod_1.z.string()),
     process: exports.assistantTurnProcessSchema,
+    timeline: zod_1.z.array(exports.assistantTurnTimelineItemSchema),
     subagents: zod_1.z.array(exports.assistantTurnSubagentSchema),
 });

package/dist/schemas/index.d.ts

@@ -21,5 +21,5 @@ export { quotaHistoryRuntimeProviderSchema, quotaHistorySampleSchema, quotaHisto
 export type { QuotaHistoryRuntimeProvider, QuotaHistorySample, QuotaHistoryDailyBucket, } from '../quotaHistory';
 export { activeProviderAccountStatusSchema, activeAccountStatusSchema, } from './accountStatus';
 export type { ActiveProviderAccountStatus, ActiveAccountStatus, } from '../accountStatus';
-export { assistantTurnEventSchema, assistantTurnEventTypeSchema, assistantTurnNarrationStepSchema, assistantTurnProcessSchema, assistantTurnProcessStepSchema, assistantTurnProjectionSchema, assistantTurnSubagentSchema, assistantTurnSubagentStatusSchema, assistantTurnToolGroupStepSchema, assistantTurnToolRefSchema, } from './assistantTurn';
-export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnToolRef, } from '../turns/assistantTurn';
+export { assistantTurnEventSchema, assistantTurnEventTypeSchema, assistantTurnNarrationStepSchema, assistantTurnProcessSchema, assistantTurnProcessStepSchema, assistantTurnProjectionSchema, assistantTurnReasoningTimelineItemSchema, assistantTurnSubagentSchema, assistantTurnSubagentStatusSchema, assistantTurnTimelineItemSchema, assistantTurnToolGroupStepSchema, assistantTurnToolRefSchema, } from './assistantTurn';
+export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnTimelineItem, AssistantTurnToolRef, } from '../turns/assistantTurn';

package/dist/schemas/index.js

@@ -12,7 +12,7 @@
  * subpath is self-sufficient for boundary-validation modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = void 0;
+exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = void 0;
 var sessionEvent_1 = require("./sessionEvent");
 Object.defineProperty(exports, "messageUsageSchema", { enumerable: true, get: function () { return sessionEvent_1.messageUsageSchema; } });
 Object.defineProperty(exports, "sessionMessageSchema", { enumerable: true, get: function () { return sessionEvent_1.sessionMessageSchema; } });
@@ -46,7 +46,9 @@ Object.defineProperty(exports, "assistantTurnNarrationStepSchema", { enumerable:
 Object.defineProperty(exports, "assistantTurnProcessSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProcessSchema; } });
 Object.defineProperty(exports, "assistantTurnProcessStepSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProcessStepSchema; } });
 Object.defineProperty(exports, "assistantTurnProjectionSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProjectionSchema; } });
+Object.defineProperty(exports, "assistantTurnReasoningTimelineItemSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnReasoningTimelineItemSchema; } });
 Object.defineProperty(exports, "assistantTurnSubagentSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnSubagentSchema; } });
 Object.defineProperty(exports, "assistantTurnSubagentStatusSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnSubagentStatusSchema; } });
+Object.defineProperty(exports, "assistantTurnTimelineItemSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnTimelineItemSchema; } });
 Object.defineProperty(exports, "assistantTurnToolGroupStepSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnToolGroupStepSchema; } });
 Object.defineProperty(exports, "assistantTurnToolRefSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnToolRefSchema; } });

package/dist/turns/assistantTurn.d.ts

@@ -20,6 +20,16 @@ export type AssistantTurnProcessStep = {
     kind: 'toolGroup';
     tools: AssistantTurnToolRef[];
 };
+export type AssistantTurnTimelineItem = {
+    kind: 'reasoning';
+    text: string;
+} | {
+    kind: 'narration';
+    text: string;
+} | {
+    kind: 'toolGroup';
+    tools: AssistantTurnToolRef[];
+};
 export interface AssistantTurnProcess {
     steps: AssistantTurnProcessStep[];
 }
@@ -31,11 +41,12 @@ export interface AssistantTurnSubagent {
     status: AssistantTurnSubagentStatus;
 }
 export interface AssistantTurnProjection {
-    schemaVersion: 1;
+    schemaVersion: 2;
     answer: string;
     reasoning: string;
     reasoningBlocks: string[];
     process: AssistantTurnProcess;
+    timeline: AssistantTurnTimelineItem[];
     subagents: AssistantTurnSubagent[];
 }
 export interface SegmentAssistantTurnOptions {

package/dist/turns/assistantTurn.js

@@ -40,18 +40,24 @@ function segmentAssistantTurn(events, options = {}) {
     const subagentStatus = options.subagentStatus ?? 'completed';
     const reasoningParts = [];
     const steps = [];
+    const timelineItems = [];
     let textBuffer = [];
     let toolGroup = null;
     function closeToolGroup() {
         if (toolGroup != null && toolGroup.tools.length > 0) {
+            const processStepIndex = steps.length;
             steps.push(toolGroup);
+            timelineItems.push({ kind: 'toolGroup', tools: toolGroup.tools, processStepIndex });
         }
         toolGroup = null;
     }
     function sealTextAsNarration() {
         const text = joinText(textBuffer);
         if (text !== '') {
-            steps.push({ kind: 'narration', text: capText(text, maxNarrationChars) });
+            const processStepIndex = steps.length;
+            const step = { kind: 'narration', text: capText(text, maxNarrationChars) };
+            steps.push(step);
+            timelineItems.push({ kind: 'narration', text: step.text, processStepIndex });
         }
         textBuffer = [];
     }
@@ -69,7 +75,13 @@ function segmentAssistantTurn(events, options = {}) {
                     break;
                 sealTextAsNarration();
                 closeToolGroup();
+                const reasoningIndex = reasoningParts.length;
                 reasoningParts.push(event.content);
+                timelineItems.push({
+                    kind: 'reasoning',
+                    text: capText(event.content, maxReasoningChars),
+                    reasoningIndex,
+                });
                 break;
             }
             case 'tool_use': {
@@ -92,16 +104,16 @@ function segmentAssistantTurn(events, options = {}) {
     }
     const answer = joinText(textBuffer);
     closeToolGroup();
-    const reasoningBlocks = capReasoningBlocks(reasoningParts
-        .filter((part) => part.trim() !== '')
-        .map((part) => capText(part, maxReasoningChars)), maxReasoningBlocks);
-    const process = { steps: capProcessSteps(steps, maxProcessSteps) };
+    const cappedReasoning = capReasoningBlocks(reasoningParts.map((part) => capText(part, maxReasoningChars)), maxReasoningBlocks);
+    const cappedProcess = capProcessSteps(steps, maxProcessSteps);
+    const process = { steps: cappedProcess.steps };
     return {
-        schemaVersion: 1,
+        schemaVersion: 2,
         answer,
         reasoning: capText(joinText(reasoningParts), maxReasoningChars),
-        reasoningBlocks,
+        reasoningBlocks: cappedReasoning.blocks,
         process,
+        timeline: capTimelineItems(timelineItems, cappedReasoning, cappedProcess),
         subagents: extractTurnSubagents(flattenProcessTools(process), { status: subagentStatus }),
     };
 }
@@ -235,24 +247,74 @@ function flattenProcessTools(process) {
     return result;
 }
 function capProcessSteps(steps, maxRetainedSteps) {
+    const retainedIndexes = new Set();
     if (!Number.isFinite(maxRetainedSteps) || maxRetainedSteps < 0)
-        return [];
+        return { steps: [], retainedIndexes };
     const retainedCount = Math.floor(maxRetainedSteps);
-    if (steps.length <= retainedCount)
-        return steps;
-    const kept = retainedCount > 0 ? steps.slice(steps.length - retainedCount) : [];
+    if (steps.length <= retainedCount) {
+        steps.forEach((_step, index) => retainedIndexes.add(index));
+        return { steps, retainedIndexes };
+    }
+    const firstKeptIndex = Math.max(steps.length - retainedCount, 0);
+    const kept = retainedCount > 0 ? steps.slice(firstKeptIndex) : [];
+    for (let index = firstKeptIndex; index < steps.length; index += 1) {
+        retainedIndexes.add(index);
+    }
     const omitted = steps.length - kept.length;
-    return [{ kind: 'narration', text: `... ${omitted} earlier process step${omitted === 1 ? '' : 's'} omitted` }, ...kept];
+    const omittedMarker = `... ${omitted} earlier process step${omitted === 1 ? '' : 's'} omitted`;
+    return { steps: [{ kind: 'narration', text: omittedMarker }, ...kept], retainedIndexes, omittedMarker };
 }
 function capReasoningBlocks(blocks, maxRetainedBlocks) {
+    const retainedIndexes = new Set();
     if (!Number.isFinite(maxRetainedBlocks) || maxRetainedBlocks < 0)
-        return [];
+        return { blocks: [], retainedIndexes };
     const retainedCount = Math.floor(maxRetainedBlocks);
-    if (blocks.length <= retainedCount)
-        return blocks;
+    if (blocks.length <= retainedCount) {
+        blocks.forEach((_block, index) => retainedIndexes.add(index));
+        return { blocks, retainedIndexes };
+    }
     const kept = retainedCount > 0 ? blocks.slice(0, retainedCount) : [];
+    for (let index = 0; index < kept.length; index += 1) {
+        retainedIndexes.add(index);
+    }
     const omitted = blocks.length - kept.length;
-    return [...kept, `... ${omitted} more reasoning block${omitted === 1 ? '' : 's'} omitted`];
+    const omittedMarker = `... ${omitted} more reasoning block${omitted === 1 ? '' : 's'} omitted`;
+    return { blocks: [...kept, omittedMarker], retainedIndexes, omittedMarker };
+}
+function capTimelineItems(items, reasoning, process) {
+    const result = [];
+    let insertedReasoningOmission = false;
+    let insertedProcessOmission = false;
+    for (const item of items) {
+        if (item.kind === 'reasoning') {
+            if (reasoning.retainedIndexes.has(item.reasoningIndex)) {
+                result.push({ kind: 'reasoning', text: item.text });
+            }
+            else if (reasoning.omittedMarker != null && !insertedReasoningOmission) {
+                result.push({ kind: 'reasoning', text: reasoning.omittedMarker });
+                insertedReasoningOmission = true;
+            }
+            continue;
+        }
+        if (!process.retainedIndexes.has(item.processStepIndex)) {
+            if (process.omittedMarker != null && !insertedProcessOmission) {
+                result.push({ kind: 'narration', text: process.omittedMarker });
+                insertedProcessOmission = true;
+            }
+            continue;
+        }
+        if (process.omittedMarker != null && !insertedProcessOmission) {
+            result.push({ kind: 'narration', text: process.omittedMarker });
+            insertedProcessOmission = true;
+        }
+        if (item.kind === 'narration') {
+            result.push({ kind: 'narration', text: item.text });
+        }
+        else {
+            result.push({ kind: 'toolGroup', tools: item.tools });
+        }
+    }
+    return result;
 }
 function parseSubagentInput(input) {
     const record = coerceRecord(input);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-shared",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Shared data access layer for Sidekick — readers, types, providers, credentials, quota",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",