sidekick-shared 0.24.0 → 0.24.1

package/README.md

@@ -165,6 +165,18 @@ const transcript = readSessionTranscript(provider, recent.sessionPath, {
 
 The same API works with `ClaudeCodeProvider` and `OpenCodeProvider`. It covers provider sessions discoverable by those readers. Remote Claude SDK-only history and Codex history entries whose rollout file has disappeared are not synthesized.
 
+Canonical transcript messages retain provider-origin facts on `message.source`, including the original role, entrypoint, meta/sidechain flags, and source identifiers. Transcript-level `cwd` and `gitBranch` use the latest non-empty value reported by the provider. Consumers can therefore distinguish a human Claude Code CLI prompt without reparsing JSONL:
+
+```typescript
+const humanCliPrompts = transcript.messages.filter(
+  (message) =>
+    message.source.originalRole === 'user' &&
+    message.source.entrypoint === 'cli' &&
+    message.source.isMeta !== true &&
+    message.source.isSidechain !== true,
+);
+```
+
 For an already-open incremental Codex rollout, keep one `CodexRolloutParser` per stream and pass each parsed `SessionEvent[]` batch to `projectSessionTranscript()` (or append the events to an existing projection). This preserves parser state for paired tool calls, model context, and cumulative token deltas; consumers should not convert raw `response_item` rows themselves.
 
 ### Collect observed sessions with isolation and retry
@@ -181,6 +193,13 @@ const collector = new ObservedSessionCollector({
 await collector.collect(); // scheduling remains the host's responsibility
 ```
 
+Each provider-backed source also exposes the same adapter's `ProviderCapabilitiesV1` record used for its reads and lifecycle:
+
+```typescript
+const source = observedSessionSourceFromProvider(provider, workspacePath);
+applyReadOnlyProjection(source.capabilities);
+```
+
 Discovery and reads are isolated, retries use bounded 30-second-to-5-minute exponential backoff, file changes bypass delay, duplicate identical failures are suppressed, and recovery emits a content-free diagnostic. Clock and fingerprint callbacks are injectable for deterministic hosts/tests.
 
 ## Usage Examples

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export type { TranscriptFidelity, TranscriptSourceProvenance, CanonicalTranscrip
 export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
 export type { ProviderSessionIndex, ListRecentSessionsOptions } from './sessionTranscripts';
 export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, } from './observedSessionCollector';
-export type { ObservedSessionReference, ObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';
+export type { ObservedSessionReference, ObservedSessionCollectionSource, ProviderObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';
 export type { SessionEvent, ClaudeSessionEvent, MessageUsage, SessionMessage, SessionEventBase, MessageSessionEvent, UserSessionEvent, AssistantSessionEvent, SummarySessionEvent, SystemSessionEvent, ToolUseSessionEvent, ToolResultSessionEvent, TokenUsage, ToolCall, ToolAnalytics, TimelineEvent, PendingToolCall, TaskStatus as SessionTaskStatus, TrackedTask, TaskState, SubagentStats, PendingUserRequest, ResponseLatency, LatencyStats, PlanStep, PlanState, SessionStats, CompactionEvent, TruncationEvent, ContextAttribution, TurnAttribution, ContextSizePoint, PermissionMode, PermissionModeChange, } from './types/sessionEvent';
 export type { OpenCodeSession, OpenCodeMessage, OpenCodePart, OpenCodeTextPart, OpenCodeReasoningPart, OpenCodeToolInvocationPart, OpenCodeCompactionPart, OpenCodeDbToolPart, OpenCodeStepStartPart, OpenCodeStepFinishPart, OpenCodePatchPart, OpenCodeSubtaskPart, OpenCodeAgentPart, OpenCodeFilePart, OpenCodeRetryPart, OpenCodeSnapshotPart, OpenCodeProject, DbProject as OpenCodeDbProject, DbSession as OpenCodeDbSession, DbMessage as OpenCodeDbMessage, DbPart as OpenCodeDbPart, } from './types/opencode';
 export type { CodexRolloutLine, CodexSessionMeta, CodexResponseItem, CodexMessageItem, CodexContentPart, CodexReasoningItem, CodexFunctionCallItem, CodexFunctionCallOutputItem, CodexLocalShellCallItem, CodexWebSearchCallItem, CodexCustomToolCallItem, CodexCustomToolCallOutputItem, CodexCompacted, CodexTurnContext, CodexEventMsg, CodexEvent, CodexTurnStartedEvent, CodexTurnCompleteEvent, CodexTaskStartedEvent, CodexTaskCompleteEvent, CodexTurnAbortedEvent, CodexTokenCountEvent, CodexTokenUsage, CodexRateLimits, CodexAgentMessageEvent, CodexAgentReasoningEvent, CodexUserMessageEvent, CodexExecCommandBeginEvent, CodexExecCommandEndEvent, CodexMcpToolCallBeginEvent, CodexMcpToolCallEndEvent, CodexErrorEvent, CodexContextCompactedEvent, CodexPatchAppliedEvent, CodexBackgroundEvent, CodexGenericEvent, CodexDbThread, CodexReasoningSummary, } from './types/codex';

package/dist/node.d.ts

@@ -10,4 +10,4 @@ export type { HydrateOptions, HydrateResult } from './pricingCatalog';
 export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
 export type { ProviderSessionIndex, ListRecentSessionsOptions } from './sessionTranscripts';
 export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, } from './observedSessionCollector';
-export type { ObservedSessionReference, ObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';
+export type { ObservedSessionReference, ObservedSessionCollectionSource, ProviderObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';

package/dist/observedSessionCollector.d.ts

@@ -1,4 +1,4 @@
-import type { ObservedAgentSessionV1 } from './types/observedSessionV1';
+import type { ObservedAgentSessionV1, ProviderCapabilitiesV1 } from './types/observedSessionV1';
 import type { SessionProviderBase } from './providers/types';
 export interface ObservedSessionReference {
     sessionId: string;
@@ -12,6 +12,9 @@ export interface ObservedSessionCollectionSource<T = unknown> {
     read(reference: ObservedSessionReference): Promise<T> | T;
     dispose?(): void;
 }
+export interface ProviderObservedSessionCollectionSource extends ObservedSessionCollectionSource<ObservedAgentSessionV1> {
+    capabilities: ProviderCapabilitiesV1;
+}
 export type ObservedSessionDiagnosticKind = 'provider-discovery-failed' | 'session-read-failed' | 'provider-recovered' | 'session-recovered';
 /** Content-safe diagnostics: identifiers and retry metadata only. */
 export interface ObservedSessionDiagnostic {
@@ -63,6 +66,6 @@ export declare class ObservedSessionCollector<T = unknown> {
  * Adapt a provider using path-only discovery and independent adapter reads, so
  * one malformed session cannot reject discovery of its healthy siblings.
  */
-export declare function observedSessionSourceFromProvider(provider: SessionProviderBase, cwd: string): ObservedSessionCollectionSource<ObservedAgentSessionV1>;
+export declare function observedSessionSourceFromProvider(provider: SessionProviderBase, cwd: string): ProviderObservedSessionCollectionSource;
 /** Size/mtime fingerprint suitable for retry bypass; returns null for synthetic DB locators. */
 export declare function fileFingerprint(sourcePath: string): string | null;

package/dist/observedSessionCollector.js

@@ -144,6 +144,7 @@ function observedSessionSourceFromProvider(provider, cwd) {
     const adapter = (0, observedSessionV1_1.createProviderSessionAdapterV1)(provider);
     return {
         providerId: provider.id,
+        capabilities: adapter.capabilities,
         discover() {
             return provider.findAllSessions(cwd).map((sessionPath) => ({
                 sessionId: provider.getSessionId(sessionPath),

package/dist/parsers/codexParser.js

@@ -200,18 +200,21 @@ class CodexRolloutParser {
     handleSessionMeta(timestamp, payload) {
         this.sessionMeta = payload;
         const text = payload.base_instructions?.text?.trim();
-        if (!text)
-            return [];
         return [
             {
                 type: 'system',
-                message: {
-                    role: 'system',
-                    id: `${payload.id}:base-instructions`,
-                    sourceLabel: 'base instructions',
-                    content: [{ type: 'text', text }],
-                },
+                ...(text
+                    ? {
+                        message: {
+                            role: 'system',
+                            id: `${payload.id}:base-instructions`,
+                            sourceLabel: 'base instructions',
+                            content: [{ type: 'text', text }],
+                        },
+                    }
+                    : {}),
                 timestamp,
+                cwd: payload.cwd || undefined,
             },
         ];
     }

package/dist/schemas/index.d.ts

@@ -16,8 +16,8 @@ export { normalizedUsageSchema, normalizedUsageCostSchema } from './usageNormali
 export type { NormalizedUsage, NormalizedUsageCost } from '../usageNormalization';
 export { tokenEstimateSchema } from './tokenEstimation';
 export type { TokenEstimate } from '../tokenEstimation';
-export { canonicalTranscriptBlockSchema, canonicalToolCallSchema, canonicalTranscriptMessageSchema, canonicalSessionTranscriptSchema, } from './transcript';
-export type { CanonicalSessionTranscript, CanonicalTranscriptMessage, CanonicalToolCall, } from '../transcript';
+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,8 +12,8 @@
  * subpath is self-sufficient for boundary-validation modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = 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 = 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; } });
@@ -32,6 +32,7 @@ Object.defineProperty(exports, "normalizedUsageCostSchema", { enumerable: true,
 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; } });

package/dist/schemas/sessionEvent.d.ts

@@ -61,7 +61,11 @@ export declare const permissionModeSchema: z.ZodEnum<{
 }>;
 export declare const userSessionEventSchema: z.ZodObject<{
     timestamp: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
     isSidechain: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
     permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
@@ -136,7 +140,11 @@ export declare const userSessionEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const assistantSessionEventSchema: z.ZodObject<{
     timestamp: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
     isSidechain: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
     permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
@@ -212,7 +220,11 @@ export declare const assistantSessionEventSchema: z.ZodObject<{
 export declare const summarySessionEventSchema: z.ZodType<SummarySessionEvent>;
 export declare const systemSessionEventSchema: z.ZodObject<{
     timestamp: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
     isSidechain: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
     permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
@@ -291,7 +303,11 @@ export declare const toolUseSessionEventSchema: z.ZodObject<{
         input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strip>;
     timestamp: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
     isSidechain: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
     permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
@@ -371,7 +387,11 @@ export declare const toolResultSessionEventSchema: z.ZodObject<{
         is_error: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     timestamp: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
     isSidechain: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
     permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";

package/dist/schemas/sessionEvent.js

@@ -41,7 +41,11 @@ exports.permissionModeSchema = zod_1.z.enum([
 // ── SessionEvent ──
 const eventBaseShape = {
     timestamp: zod_1.z.string(),
+    entrypoint: zod_1.z.string().optional(),
+    isMeta: zod_1.z.boolean().optional(),
     isSidechain: zod_1.z.boolean().optional(),
+    cwd: zod_1.z.string().optional(),
+    gitBranch: zod_1.z.string().optional(),
     permissionMode: exports.permissionModeSchema.optional(),
     rateLimits: zod_1.z
         .object({
@@ -169,19 +173,38 @@ const MAX_PROGRESS_DEPTH = 8;
  * Returns zero events for unrecognized input — never throws.
  */
 function extractSessionEvents(raw, depth = 0) {
+    return extractSessionEventsWithProvenance(raw, depth, {});
+}
+function extractSessionEventsWithProvenance(raw, depth, inherited) {
     const direct = exports.sessionEventSchema.safeParse(raw);
     if (direct.success)
-        return [direct.data];
+        return [{ ...inherited, ...direct.data }];
     if (depth >= MAX_PROGRESS_DEPTH)
         return [];
     if (typeof raw === 'object' && raw !== null && raw.type === 'progress') {
+        const provenance = { ...inherited, ...progressProvenance(raw) };
         const data = raw.data;
         if (typeof data === 'object' && data !== null) {
             const message = data.message;
             if (typeof message === 'object' && message !== null) {
-                return extractSessionEvents(message, depth + 1);
+                return extractSessionEventsWithProvenance(message, depth + 1, provenance);
             }
         }
     }
     return [];
 }
+function progressProvenance(raw) {
+    const value = raw;
+    const provenance = {};
+    if (typeof value.entrypoint === 'string')
+        provenance.entrypoint = value.entrypoint;
+    if (typeof value.isMeta === 'boolean')
+        provenance.isMeta = value.isMeta;
+    if (typeof value.isSidechain === 'boolean')
+        provenance.isSidechain = value.isSidechain;
+    if (typeof value.cwd === 'string')
+        provenance.cwd = value.cwd;
+    if (typeof value.gitBranch === 'string')
+        provenance.gitBranch = value.gitBranch;
+    return provenance;
+}

package/dist/schemas/transcript.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import type { CanonicalSessionTranscript, CanonicalTranscriptMessage, CanonicalToolCall } from '../transcript';
+import type { CanonicalSessionTranscript, CanonicalTranscriptMessage, CanonicalToolCall, TranscriptSourceProvenance } from '../transcript';
+export declare const transcriptSourceProvenanceSchema: z.ZodType<TranscriptSourceProvenance>;
 export declare const canonicalTranscriptBlockSchema: z.ZodObject<{
     type: z.ZodEnum<{
         unknown: "unknown";

package/dist/schemas/transcript.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = void 0;
+exports.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = exports.transcriptSourceProvenanceSchema = void 0;
 const zod_1 = require("zod");
 const usageNormalization_1 = require("./usageNormalization");
-const transcriptSourceSchema = zod_1.z.object({
+exports.transcriptSourceProvenanceSchema = zod_1.z.object({
     provider: zod_1.z.string().optional(),
     sessionId: zod_1.z.string().optional(),
     sourcePath: zod_1.z.string().optional(),
     source: zod_1.z.string().optional(),
+    entrypoint: zod_1.z.string().optional(),
+    isMeta: zod_1.z.boolean().optional(),
+    isSidechain: zod_1.z.boolean().optional(),
+    originalRole: zod_1.z.string().optional(),
     eventIndex: zod_1.z.number().int().nonnegative(),
     eventType: zod_1.z.enum(['user', 'assistant', 'tool_use', 'tool_result', 'summary', 'system']),
     eventId: zod_1.z.string().optional(),
@@ -32,7 +36,7 @@ exports.canonicalToolCallSchema = zod_1.z.object({
     output: zod_1.z.unknown().optional(),
     isError: zod_1.z.boolean().optional(),
     command: zod_1.z.string().optional(),
-    source: transcriptSourceSchema,
+    source: exports.transcriptSourceProvenanceSchema,
 });
 exports.canonicalTranscriptMessageSchema = zod_1.z.object({
     id: zod_1.z.string().optional(),
@@ -46,12 +50,14 @@ exports.canonicalTranscriptMessageSchema = zod_1.z.object({
     cost: usageNormalization_1.normalizedUsageCostSchema.optional(),
     tools: zod_1.z.array(exports.canonicalToolCallSchema),
     commands: zod_1.z.array(zod_1.z.string()),
-    source: transcriptSourceSchema,
+    source: exports.transcriptSourceProvenanceSchema,
 });
 exports.canonicalSessionTranscriptSchema = zod_1.z.object({
     provider: zod_1.z.string().optional(),
     sessionId: zod_1.z.string().optional(),
     sourcePath: zod_1.z.string().optional(),
+    cwd: zod_1.z.string().optional(),
+    gitBranch: zod_1.z.string().optional(),
     startedAt: zod_1.z.string().optional(),
     endedAt: zod_1.z.string().optional(),
     models: zod_1.z.array(zod_1.z.string()),

package/dist/transcript.d.ts

@@ -7,6 +7,10 @@ export interface TranscriptSourceProvenance {
     sessionId?: string;
     sourcePath?: string;
     source?: string;
+    entrypoint?: string;
+    isMeta?: boolean;
+    isSidechain?: boolean;
+    originalRole?: string;
     eventIndex: number;
     eventType: SessionEvent['type'];
     eventId?: string;
@@ -61,6 +65,8 @@ export interface CanonicalSessionTranscript {
     provider?: ProviderId | string;
     sessionId?: string;
     sourcePath?: string;
+    cwd?: string;
+    gitBranch?: string;
     startedAt?: string;
     endedAt?: string;
     models: string[];

package/dist/transcript.js

@@ -25,13 +25,23 @@ function projectSessionTranscript(events, options = {}) {
     const usageCosts = [];
     const totals = { ...EMPTY_TOTALS };
     const toolsById = new Map();
+    let cwd;
+    let gitBranch;
     events.forEach((event, eventIndex) => {
+        if (nonEmpty(event.cwd))
+            cwd = event.cwd;
+        if (nonEmpty(event.gitBranch))
+            gitBranch = event.gitBranch;
         const message = event.message;
         const source = {
             provider: options.provider ?? event.providerMetadata?.providerId,
             sessionId: options.sessionId,
             sourcePath: options.sourcePath,
             source: event.providerMetadata?.source,
+            entrypoint: event.entrypoint,
+            isMeta: event.isMeta,
+            isSidechain: event.isSidechain,
+            originalRole: message?.role,
             eventIndex,
             eventType: event.type,
             eventId: message?.id,
@@ -119,6 +129,8 @@ function projectSessionTranscript(events, options = {}) {
         provider: options.provider,
         sessionId: options.sessionId,
         sourcePath: options.sourcePath,
+        cwd,
+        gitBranch,
         startedAt: events[0]?.timestamp,
         endedAt: events.at(-1)?.timestamp,
         models: [...models],
@@ -136,6 +148,9 @@ function projectSessionTranscript(events, options = {}) {
         provenance: { source: 'session-events', fidelity, eventCount: events.length },
     };
 }
+function nonEmpty(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
 function roleForEvent(event) {
     if (event.type === 'summary')
         return 'summary';

package/dist/types/sessionEvent.d.ts

@@ -57,8 +57,16 @@ export interface SessionMessage {
 export interface SessionEventBase {
     /** ISO 8601 timestamp of event */
     timestamp: string;
+    /** Provider-reported entrypoint that produced this event. */
+    entrypoint?: string;
+    /** Whether the provider identifies this as orchestration or metadata. */
+    isMeta?: boolean;
     /** Whether this is a subagent/sidechain event */
     isSidechain?: boolean;
+    /** Provider-reported working directory for this event/session. */
+    cwd?: string;
+    /** Provider-reported git branch for this event/session. */
+    gitBranch?: string;
     /** Permission mode active when this event occurred */
     permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';
     /** Subscription rate limits, when provided by the session source. */

package/package.json

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