sidekick-shared 0.23.1 → 0.24.1

package/dist/report/transcriptParser.js

@@ -1,8 +1,5 @@
 "use strict";
-/**
- * Parse Claude Code JSONL session files into typed transcript entries
- * with full, untruncated content suitable for HTML report rendering.
- */
+/** Report compatibility adapters over the canonical transcript projection. */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -39,167 +36,85 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseTranscript = parseTranscript;
 exports.parseTranscriptFromEvents = parseTranscriptFromEvents;
-const fs = __importStar(require("fs"));
+const fs = __importStar(require("node:fs"));
 const jsonl_1 = require("../parsers/jsonl");
-/**
- * Parse a JSONL session file into an array of TranscriptEntry objects.
- *
- * Unlike the FollowEvent pipeline (which truncates to 120-200 chars),
- * this preserves full message content for HTML report rendering.
- */
+const sessionEvent_1 = require("../schemas/sessionEvent");
+const transcript_1 = require("../transcript");
+/** Parse a Claude Code JSONL session through the canonical provider reader. */
 function parseTranscript(sessionPath) {
-    let data;
     try {
-        data = fs.readFileSync(sessionPath, 'utf-8');
+        const events = [];
+        const parser = new jsonl_1.JsonlParser({
+            onEvent: (raw) => events.push(...(0, sessionEvent_1.extractSessionEvents)(raw)),
+        });
+        parser.processChunk(fs.readFileSync(sessionPath, 'utf8'));
+        parser.flush();
+        return parseTranscriptFromEvents(events);
     }
     catch {
         return [];
     }
-    const events = [];
-    const parser = new jsonl_1.JsonlParser({
-        onEvent: (event) => events.push(event),
-    });
-    parser.processChunk(data);
-    parser.flush();
-    const entries = [];
-    for (const event of events) {
-        const entry = eventToTranscriptEntry(event);
-        if (entry) {
-            entries.push(entry);
-        }
-    }
-    return entries;
 }
-/** Parse canonical provider events into transcript entries. */
+/** Project canonical provider events into the legacy report transcript shape. */
 function parseTranscriptFromEvents(events) {
-    const entries = [];
-    for (const event of events) {
-        const entry = eventToTranscriptEntry(event);
-        if (entry) {
-            entries.push(entry);
-        }
-    }
-    return entries;
-}
-function eventToTranscriptEntry(event) {
-    if (!event.type || !event.message)
-        return null;
-    const role = event.message.role;
-    const timestamp = event.timestamp || '';
-    const sourceLabel = event.message.sourceLabel;
-    const model = event.message.model;
-    const usage = event.message.usage
-        ? {
-            input_tokens: event.message.usage.input_tokens || 0,
-            output_tokens: event.message.usage.output_tokens || 0,
-            cache_creation_input_tokens: event.message.usage.cache_creation_input_tokens,
-            cache_read_input_tokens: event.message.usage.cache_read_input_tokens,
-        }
-        : undefined;
-    const content = extractContentBlocks(event.message.content);
-    // Skip empty entries (warmup messages, etc.)
-    if (content.length === 0) {
-        if (usage || sourceLabel) {
-            content.push({
-                type: 'text',
-                text: sourceLabel ? `${sourceLabel} updated` : 'Usage updated',
-            });
-        }
-        else {
-            return null;
-        }
-    }
-    let type;
-    // Check event.type first — summary events have role 'assistant' but should be typed as 'summary'
-    if (event.type === 'summary') {
-        type = 'summary';
-    }
-    else if (event.type === 'system') {
-        type = 'system';
-    }
-    else if (role === 'user') {
-        type = 'user';
-    }
-    else if (role === 'assistant') {
-        type = 'assistant';
-    }
-    else {
-        type = 'system';
-    }
-    return { type, timestamp, sourceLabel, model, usage, content };
-}
-function extractContentBlocks(content) {
-    if (!content)
-        return [];
-    // Simple string content
-    if (typeof content === 'string') {
-        return content.trim() ? [{ type: 'text', text: content }] : [];
-    }
-    // Array of content blocks (Claude API format)
-    if (!Array.isArray(content))
-        return [];
-    const blocks = [];
-    for (const block of content) {
-        if (!block || typeof block !== 'object')
-            continue;
-        switch (block.type) {
-            case 'text': {
-                const text = typeof block.text === 'string' ? block.text : '';
-                if (text.trim()) {
-                    blocks.push({ type: 'text', text });
-                }
-                break;
-            }
-            case 'thinking': {
-                const text = typeof block.thinking === 'string' ? block.thinking : '';
-                if (text.trim()) {
-                    blocks.push({ type: 'thinking', text });
-                }
-                break;
-            }
-            case 'tool_use': {
-                const toolName = typeof block.name === 'string' ? block.name : 'unknown';
-                const toolInput = block.input && typeof block.input === 'object'
-                    ? block.input
-                    : {};
-                const toolUseId = typeof block.id === 'string' ? block.id : undefined;
-                blocks.push({ type: 'tool_use', toolName, toolInput, toolUseId });
-                break;
+    return (0, transcript_1.projectSessionTranscript)(events, { fidelity: 'full' }).messages.map((message) => ({
+        type: message.role === 'tool' ? 'system' : message.role,
+        timestamp: message.timestamp,
+        sourceLabel: message.sourceLabel,
+        model: message.model,
+        usage: message.usage
+            ? {
+                input_tokens: message.usage.uncachedInputTokens,
+                output_tokens: message.usage.outputTokens,
+                cache_creation_input_tokens: message.usage.cacheWriteTokens || undefined,
+                cache_read_input_tokens: message.usage.cacheReadTokens || undefined,
             }
-            case 'tool_result': {
-                const toolUseId = typeof block.tool_use_id === 'string' ? block.tool_use_id : undefined;
-                const isError = block.is_error === true;
-                const output = extractToolResultContent(block.content);
-                blocks.push({ type: 'tool_result', toolUseId, output, isError });
-                break;
-            }
-            case 'image': {
-                blocks.push({ type: 'image', text: '[Image content]' });
-                break;
-            }
-            default:
-                break;
-        }
+            : undefined,
+        content: message.content.flatMap(toReportBlock),
+    }));
+}
+function toReportBlock(block) {
+    switch (block.type) {
+        case 'text':
+            return block.text ? [{ type: 'text', text: block.text }] : [];
+        case 'thinking':
+            return block.text ? [{ type: 'thinking', text: block.text }] : [];
+        case 'tool_use':
+            return [
+                {
+                    type: 'tool_use',
+                    toolName: block.toolName ?? 'unknown',
+                    toolInput: block.input && typeof block.input === 'object'
+                        ? block.input
+                        : {},
+                    toolUseId: block.toolUseId,
+                },
+            ];
+        case 'tool_result':
+            return [
+                {
+                    type: 'tool_result',
+                    toolUseId: block.toolUseId,
+                    output: reportToolOutput(block.output),
+                    isError: block.isError,
+                },
+            ];
+        case 'image':
+            return [{ type: 'image', text: block.text ?? '[Image content]' }];
+        case 'unknown':
+            return [];
     }
-    return blocks;
 }
-/** Extract text from tool_result content (can be string or array of blocks). */
-function extractToolResultContent(content) {
-    if (!content)
-        return '';
-    if (typeof content === 'string')
-        return content;
-    if (Array.isArray(content)) {
-        const parts = [];
-        for (const part of content) {
-            if (part &&
-                typeof part === 'object' &&
-                part.type === 'text' &&
-                typeof part.text === 'string') {
-                parts.push(part.text);
-            }
-        }
-        return parts.join('\n');
+function reportToolOutput(output) {
+    if (typeof output === 'string')
+        return output;
+    if (Array.isArray(output)) {
+        return output
+            .flatMap((part) => part && typeof part === 'object' && part.type === 'text'
+            ? [String(part.text ?? '')]
+            : [])
+            .filter(Boolean)
+            .join('\n');
     }
-    return '';
+    return JSON.stringify(output ?? '');
 }

package/dist/schemas/index.d.ts

@@ -10,8 +10,14 @@
  * The mirrored TypeScript interfaces are re-exported as types so this
  * subpath is self-sufficient for boundary-validation modules.
  */
-export { messageUsageSchema, sessionMessageSchema, sessionEventSchema, permissionModeSchema, extractSessionEvents, } from './sessionEvent';
+export { messageUsageSchema, sessionMessageSchema, sessionEventSchema, permissionModeSchema, extractSessionEvents, userSessionEventSchema, assistantSessionEventSchema, summarySessionEventSchema, systemSessionEventSchema, toolUseSessionEventSchema, toolResultSessionEventSchema, } from './sessionEvent';
 export type { MessageUsage, SessionMessage, SessionEvent, PermissionMode, } from '../types/sessionEvent';
+export { normalizedUsageSchema, normalizedUsageCostSchema } from './usageNormalization';
+export type { NormalizedUsage, NormalizedUsageCost } from '../usageNormalization';
+export { tokenEstimateSchema } from './tokenEstimation';
+export type { TokenEstimate } from '../tokenEstimation';
+export { transcriptSourceProvenanceSchema, canonicalTranscriptBlockSchema, canonicalToolCallSchema, canonicalTranscriptMessageSchema, canonicalSessionTranscriptSchema, } from './transcript';
+export type { CanonicalSessionTranscript, CanonicalTranscriptMessage, CanonicalToolCall, TranscriptSourceProvenance, } from '../transcript';
 export { observationProvenanceV1Schema, observedAgentSessionV1Schema, observedValueV1Schema, pendingUserRequestV1Schema, providerCapabilitiesV1Schema, providerSessionAdapterV1Schema, sessionEvidenceRefV1Schema, } from './observedSessionV1';
 export type { ObservationProvenanceV1, ObservedAgentSessionV1, ObservedValueV1, PendingUserRequestV1, ProviderCapabilitiesV1, ProviderSessionAdapterV1, SessionEvidenceRefV1, } from '../types/observedSessionV1';
 export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, codexResetCreditSchema, codexResetCreditsSnapshotSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, zaiProviderQuotaStateSchema, providerQuotaMapSchema, } from './quota';

package/dist/schemas/index.js

@@ -12,14 +12,31 @@
  * subpath is self-sufficient for boundary-validation modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.sessionEvidenceRefV1Schema = exports.providerSessionAdapterV1Schema = exports.providerCapabilitiesV1Schema = exports.pendingUserRequestV1Schema = exports.observedValueV1Schema = exports.observedAgentSessionV1Schema = exports.observationProvenanceV1Schema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = void 0;
-exports.assistantTurnToolRefSchema = void 0;
+exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.sessionEvidenceRefV1Schema = exports.providerSessionAdapterV1Schema = exports.providerCapabilitiesV1Schema = exports.pendingUserRequestV1Schema = exports.observedValueV1Schema = exports.observedAgentSessionV1Schema = exports.observationProvenanceV1Schema = exports.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = exports.transcriptSourceProvenanceSchema = exports.tokenEstimateSchema = exports.normalizedUsageCostSchema = exports.normalizedUsageSchema = exports.toolResultSessionEventSchema = exports.toolUseSessionEventSchema = exports.systemSessionEventSchema = exports.summarySessionEventSchema = exports.assistantSessionEventSchema = exports.userSessionEventSchema = 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.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = 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; } });
 Object.defineProperty(exports, "sessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.sessionEventSchema; } });
 Object.defineProperty(exports, "permissionModeSchema", { enumerable: true, get: function () { return sessionEvent_1.permissionModeSchema; } });
 Object.defineProperty(exports, "extractSessionEvents", { enumerable: true, get: function () { return sessionEvent_1.extractSessionEvents; } });
+Object.defineProperty(exports, "userSessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.userSessionEventSchema; } });
+Object.defineProperty(exports, "assistantSessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.assistantSessionEventSchema; } });
+Object.defineProperty(exports, "summarySessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.summarySessionEventSchema; } });
+Object.defineProperty(exports, "systemSessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.systemSessionEventSchema; } });
+Object.defineProperty(exports, "toolUseSessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.toolUseSessionEventSchema; } });
+Object.defineProperty(exports, "toolResultSessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.toolResultSessionEventSchema; } });
+var usageNormalization_1 = require("./usageNormalization");
+Object.defineProperty(exports, "normalizedUsageSchema", { enumerable: true, get: function () { return usageNormalization_1.normalizedUsageSchema; } });
+Object.defineProperty(exports, "normalizedUsageCostSchema", { enumerable: true, get: function () { return usageNormalization_1.normalizedUsageCostSchema; } });
+var tokenEstimation_1 = require("./tokenEstimation");
+Object.defineProperty(exports, "tokenEstimateSchema", { enumerable: true, get: function () { return tokenEstimation_1.tokenEstimateSchema; } });
+var transcript_1 = require("./transcript");
+Object.defineProperty(exports, "transcriptSourceProvenanceSchema", { enumerable: true, get: function () { return transcript_1.transcriptSourceProvenanceSchema; } });
+Object.defineProperty(exports, "canonicalTranscriptBlockSchema", { enumerable: true, get: function () { return transcript_1.canonicalTranscriptBlockSchema; } });
+Object.defineProperty(exports, "canonicalToolCallSchema", { enumerable: true, get: function () { return transcript_1.canonicalToolCallSchema; } });
+Object.defineProperty(exports, "canonicalTranscriptMessageSchema", { enumerable: true, get: function () { return transcript_1.canonicalTranscriptMessageSchema; } });
+Object.defineProperty(exports, "canonicalSessionTranscriptSchema", { enumerable: true, get: function () { return transcript_1.canonicalSessionTranscriptSchema; } });
 var observedSessionV1_1 = require("./observedSessionV1");
 Object.defineProperty(exports, "observationProvenanceV1Schema", { enumerable: true, get: function () { return observedSessionV1_1.observationProvenanceV1Schema; } });
 Object.defineProperty(exports, "observedAgentSessionV1Schema", { enumerable: true, get: function () { return observedSessionV1_1.observedAgentSessionV1Schema; } });

package/dist/schemas/observedSessionV1.d.ts

@@ -290,8 +290,39 @@ export declare const observedAgentSessionV1Schema: z.ZodObject<{
                 timestamp: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
+        normalized: z.ZodOptional<z.ZodObject<{
+            value: z.ZodObject<{
+                uncachedInputTokens: z.ZodNumber;
+                cacheReadTokens: z.ZodNumber;
+                cacheWriteTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+                reasoningTokens: z.ZodNumber;
+                cacheInclusiveInputTokens: z.ZodNumber;
+                billableOutputTokens: z.ZodNumber;
+                totalTokens: z.ZodNumber;
+            }, z.core.$strip>;
+            provenance: z.ZodEnum<{
+                reported: "reported";
+                estimated: "estimated";
+                inferred: "inferred";
+            }>;
+            confidence: z.ZodNumber;
+            evidence: z.ZodArray<z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                provider: z.ZodEnum<{
+                    "claude-code": "claude-code";
+                    codex: "codex";
+                    opencode: "opencode";
+                }>;
+                sessionId: z.ZodString;
+                sourcePath: z.ZodOptional<z.ZodString>;
+                eventIndex: z.ZodOptional<z.ZodNumber>;
+                eventId: z.ZodOptional<z.ZodString>;
+                timestamp: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         costUsd: z.ZodObject<{
-            value: z.ZodNumber;
+            value: z.ZodNullable<z.ZodNumber>;
             provenance: z.ZodEnum<{
                 reported: "reported";
                 estimated: "estimated";

package/dist/schemas/observedSessionV1.js

@@ -43,7 +43,17 @@ exports.observedAgentSessionV1Schema = zod_1.z.object({
         outputTokens: (0, exports.observedValueV1Schema)(zod_1.z.number().nonnegative()),
         cacheReadTokens: (0, exports.observedValueV1Schema)(zod_1.z.number().nonnegative()),
         cacheWriteTokens: (0, exports.observedValueV1Schema)(zod_1.z.number().nonnegative()),
-        costUsd: (0, exports.observedValueV1Schema)(zod_1.z.number().nonnegative()),
+        normalized: (0, exports.observedValueV1Schema)(zod_1.z.object({
+            uncachedInputTokens: zod_1.z.number().finite().nonnegative(),
+            cacheReadTokens: zod_1.z.number().finite().nonnegative(),
+            cacheWriteTokens: zod_1.z.number().finite().nonnegative(),
+            outputTokens: zod_1.z.number().finite().nonnegative(),
+            reasoningTokens: zod_1.z.number().finite().nonnegative(),
+            cacheInclusiveInputTokens: zod_1.z.number().finite().nonnegative(),
+            billableOutputTokens: zod_1.z.number().finite().nonnegative(),
+            totalTokens: zod_1.z.number().finite().nonnegative(),
+        })).optional(),
+        costUsd: (0, exports.observedValueV1Schema)(zod_1.z.number().nonnegative().nullable()),
     }),
     pendingUserRequest: exports.pendingUserRequestV1Schema.nullable(),
     observedAt: zod_1.z.string(),