causal-inspector 0.1.5 → 0.2.0

package/dist/queries.js

@@ -5,12 +5,12 @@ const EVENT_FIELDS = `
   type
   name
   id
-  parentId
-  correlationId
+  causationId
+  workflowId
   reactorId
   aggregateType
   aggregateId
-  streamVersion
+  streamRevision
   summary
   payload
 `;
@@ -26,14 +26,14 @@ export const INSPECTOR_EVENTS = `
     $limit: Int!
     $cursor: Int
     $search: String
-    $correlationId: String
+    $workflowId: String
     $aggregateKey: String
   ) {
     inspectorEvents(
       limit: $limit
       cursor: $cursor
       search: $search
-      correlationId: $correlationId
+      workflowId: $workflowId
       aggregateKey: $aggregateKey
     ) {
       events {
@@ -54,8 +54,8 @@ export const INSPECTOR_CAUSAL_TREE = `
   }
 `;
 export const INSPECTOR_CAUSAL_FLOW = `
-  query InspectorCausalFlow($correlationId: String!) {
-    inspectorCausalFlow(correlationId: $correlationId) {
+  query InspectorCausalFlow($workflowId: String!) {
+    inspectorCausalFlow(workflowId: $workflowId) {
       events {
         ${EVENT_FIELDS}
       }
@@ -74,9 +74,9 @@ export const INSPECTOR_REACTOR_LOGS = `
     }
   }
 `;
-export const INSPECTOR_REACTOR_LOGS_BY_CORRELATION = `
-  query InspectorReactorLogsByCorrelation($correlationId: String!) {
-    inspectorReactorLogsByCorrelation(correlationId: $correlationId) {
+export const INSPECTOR_REACTOR_LOGS_BY_WORKFLOW = `
+  query InspectorReactorLogsByWorkflow($workflowId: String!) {
+    inspectorReactorLogsByWorkflow(workflowId: $workflowId) {
       eventId
       reactorId
       level
@@ -87,16 +87,16 @@ export const INSPECTOR_REACTOR_LOGS_BY_CORRELATION = `
   }
 `;
 export const INSPECTOR_REACTOR_DESCRIPTIONS = `
-  query InspectorReactorDescriptions($correlationId: String!) {
-    inspectorReactorDescriptions(correlationId: $correlationId) {
+  query InspectorReactorDescriptions($workflowId: String!) {
+    inspectorReactorDescriptions(workflowId: $workflowId) {
       reactorId
       blocks
     }
   }
 `;
 export const INSPECTOR_REACTOR_DESCRIPTION_SNAPSHOTS = `
-  query InspectorReactorDescriptionSnapshots($correlationId: String!) {
-    inspectorReactorDescriptionSnapshots(correlationId: $correlationId) {
+  query InspectorReactorDescriptionSnapshots($workflowId: String!) {
+    inspectorReactorDescriptionSnapshots(workflowId: $workflowId) {
       seq
       eventId
       reactorId
@@ -105,8 +105,8 @@ export const INSPECTOR_REACTOR_DESCRIPTION_SNAPSHOTS = `
   }
 `;
 export const INSPECTOR_AGGREGATE_TIMELINE = `
-  query InspectorAggregateTimeline($correlationId: String!) {
-    inspectorAggregateTimeline(correlationId: $correlationId) {
+  query InspectorAggregateTimeline($workflowId: String!) {
+    inspectorAggregateTimeline(workflowId: $workflowId) {
       seq
       eventId
       eventType
@@ -138,17 +138,17 @@ export const INSPECTOR_AGGREGATE_LIFECYCLE = `
       eventId
       eventType
       ts
-      correlationId
+      workflowId
       aggregateKey
       state
     }
   }
 `;
-export const INSPECTOR_CORRELATIONS = `
-  query InspectorCorrelations($search: String, $limit: Int, $cursor: String) {
-    inspectorCorrelations(search: $search, limit: $limit, cursor: $cursor) {
-      correlations {
-        correlationId
+export const INSPECTOR_WORKFLOWS = `
+  query InspectorWorkflows($search: String, $limit: Int, $cursor: String) {
+    inspectorWorkflows(search: $search, limit: $limit, cursor: $cursor) {
+      workflows {
+        workflowId
         eventCount
         firstTs
         lastTs
@@ -160,8 +160,8 @@ export const INSPECTOR_CORRELATIONS = `
   }
 `;
 export const INSPECTOR_REACTOR_OUTCOMES = `
-  query InspectorReactorOutcomes($correlationId: String!) {
-    inspectorReactorOutcomes(correlationId: $correlationId) {
+  query InspectorReactorOutcomes($workflowId: String!) {
+    inspectorReactorOutcomes(workflowId: $workflowId) {
       reactorId
       status
       error
@@ -172,3 +172,93 @@ export const INSPECTOR_REACTOR_OUTCOMES = `
     }
   }
 `;
+export const INSPECTOR_REACTOR_ATTEMPTS = `
+  query InspectorReactorAttempts($workflowId: String!) {
+    inspectorReactorAttempts(workflowId: $workflowId) {
+      eventId
+      reactorId
+      workflowId
+      attempt
+      status
+      error
+      startedAt
+      completedAt
+    }
+  }
+`;
+// ── Entity-scoped inspection queries ─────────────────────────────────────
+const SUBJECT_CHAIN_EVENT_FIELDS = `
+  seq
+  ts
+  type
+  name
+  id
+  causationId
+  workflowId
+  reactorId
+  aggregateType
+  aggregateId
+  streamRevision
+  summary
+  payload
+  sourceMode
+`;
+export const INSPECTOR_SUBJECT_CHAIN = `
+  query InspectorSubjectChain(
+    $aggregateType: String!
+    $aggregateId: String!
+    $mode: SubjectChainMode!
+    $limit: Int
+    $cursor: Int
+  ) {
+    inspectorSubjectChain(
+      aggregateType: $aggregateType
+      aggregateId: $aggregateId
+      mode: $mode
+      limit: $limit
+      cursor: $cursor
+    ) {
+      events {
+        ${SUBJECT_CHAIN_EVENT_FIELDS}
+      }
+      nextCursor
+      depthCapReached
+    }
+  }
+`;
+export const INSPECTOR_EFFECTS_FOR_EVENT = `
+  query InspectorEffectsForEvent($eventId: String!) {
+    inspectorEffectsForEvent(eventId: $eventId) {
+      consumer
+      label
+      value
+      createdAt
+    }
+  }
+`;
+export const INSPECTOR_AGGREGATE_TYPES = `
+  query InspectorAggregateTypes($search: String, $limit: Int) {
+    inspectorAggregateTypes(search: $search, limit: $limit)
+  }
+`;
+export const INSPECTOR_AGGREGATE_KEYS_BY_TYPE = `
+  query InspectorAggregateKeysByType(
+    $aggregateType: String!
+    $search: String
+    $limit: Int
+    $cursor: String
+  ) {
+    inspectorAggregateKeysByType(
+      aggregateType: $aggregateType
+      search: $search
+      limit: $limit
+      cursor: $cursor
+    ) {
+      entries {
+        aggregateId
+        displayLabel
+      }
+      nextCursor
+    }
+  }
+`;

package/dist/reducer.js

@@ -3,24 +3,24 @@
  * (ui/flow_opened, ui/handler_selected) and browser-initiated
  * navigation (location/changed from popstate).
  */
-function applyNavigation(draft, correlationId, handler) {
-    // Correlation changed → reset flow state
-    if (correlationId !== draft.flowCorrelationId) {
-        if (correlationId) {
-            draft.flowCorrelationId = correlationId;
+function applyNavigation(draft, workflowId, handler) {
+    // Workflow changed → reset flow state
+    if (workflowId !== draft.flowWorkflowId) {
+        if (workflowId) {
+            draft.flowWorkflowId = workflowId;
             draft.flowData = [];
             draft.flowSelection = null;
             draft.scrubberStart = null;
             draft.scrubberEnd = null;
             draft.scrubberPlaying = false;
             draft.logsFilter = {
-                scope: "correlation",
+                scope: "workflow",
                 reactorId: null,
-                correlationId,
+                workflowId,
             };
         }
         else {
-            draft.flowCorrelationId = null;
+            draft.flowWorkflowId = null;
             draft.flowData = [];
             draft.flowSelection = null;
             draft.scrubberStart = null;
@@ -29,7 +29,7 @@ function applyNavigation(draft, correlationId, handler) {
             draft.logsFilter = {
                 scope: "reactor",
                 reactorId: null,
-                correlationId: null,
+                workflowId: null,
             };
         }
     }
@@ -38,24 +38,39 @@ function applyNavigation(draft, correlationId, handler) {
         draft.logsFilter = {
             scope: "reactor",
             reactorId: handler,
-            correlationId: draft.flowCorrelationId,
+            workflowId: draft.flowWorkflowId,
         };
     }
 }
+function applySubjectSelected(draft, aggregateType, aggregateId, mode) {
+    draft.subjectType = aggregateType;
+    draft.subjectId = aggregateId;
+    draft.subjectMode = mode;
+    draft.subjectChain = [];
+    draft.subjectChainCursor = null;
+    draft.subjectDepthCapped = false;
+    draft.subjectChainLoading = true;
+    // Mutual exclusion: clear workflow state
+    draft.flowWorkflowId = null;
+    draft.flowData = [];
+    draft.flowSelection = null;
+    draft.causalTree = null;
+    draft.logsFilter = { scope: "reactor", reactorId: null, workflowId: null };
+}
 export const reducer = (draft, event) => {
     switch (event.type) {
         // ── Subscription ──
         case "events/received": {
             const newEvents = event.payload;
             const filtered = newEvents.filter((e) => {
-                if (draft.filters.correlationId && e.correlationId !== draft.filters.correlationId) {
+                if (draft.filters.workflowId && e.workflowId !== draft.filters.workflowId) {
                     return false;
                 }
                 if (draft.filters.search) {
                     const s = draft.filters.search.toLowerCase();
                     const matches = e.name.toLowerCase().includes(s) ||
                         e.payload.toLowerCase().includes(s) ||
-                        (e.correlationId ?? "").toLowerCase().includes(s);
+                        (e.workflowId ?? "").toLowerCase().includes(s);
                     if (!matches)
                         return false;
                 }
@@ -90,35 +105,40 @@ export const reducer = (draft, event) => {
             draft.logs = event.payload;
             break;
         case "events/descriptions_loaded": {
-            const { correlationId, descriptions } = event.payload;
-            draft.descriptions[correlationId] = descriptions;
+            const { workflowId, descriptions } = event.payload;
+            draft.descriptions[workflowId] = descriptions;
             break;
         }
         case "events/description_snapshots_loaded": {
-            const { correlationId, snapshots } = event.payload;
-            draft.descriptionSnapshots[correlationId] = snapshots;
+            const { workflowId, snapshots } = event.payload;
+            draft.descriptionSnapshots[workflowId] = snapshots;
             break;
         }
         case "events/aggregate_timeline_loaded": {
-            const { correlationId, entries } = event.payload;
-            draft.aggregateTimeline[correlationId] = entries;
+            const { workflowId, entries } = event.payload;
+            draft.aggregateTimeline[workflowId] = entries;
             break;
         }
         case "events/outcomes_loaded": {
-            const { correlationId, outcomes } = event.payload;
-            draft.outcomes[correlationId] = outcomes;
+            const { workflowId, outcomes } = event.payload;
+            draft.outcomes[workflowId] = outcomes;
+            break;
+        }
+        case "events/attempts_loaded": {
+            const { workflowId, attempts } = event.payload;
+            draft.attempts[workflowId] = attempts;
             break;
         }
-        case "events/correlations_loaded": {
-            const { correlations, hasMore, append } = event.payload;
+        case "events/workflows_loaded": {
+            const { workflows, hasMore, append } = event.payload;
             if (append) {
-                draft.correlations.push(...correlations);
+                draft.workflows.push(...workflows);
             }
             else {
-                draft.correlations = correlations;
+                draft.workflows = workflows;
             }
-            draft.correlationsHasMore = hasMore;
-            draft.correlationsLoading = false;
+            draft.workflowsHasMore = hasMore;
+            draft.workflowsLoading = false;
             break;
         }
         case "events/reactor_dependencies_loaded":
@@ -133,17 +153,23 @@ export const reducer = (draft, event) => {
             break;
         // ── Navigation (user facts + browser popstate) ──
         case "ui/flow_opened":
-            applyNavigation(draft, event.payload.correlationId, null);
+            applyNavigation(draft, event.payload.workflowId, null);
             break;
         case "ui/flow_closed":
             applyNavigation(draft, null, null);
             break;
         case "ui/handler_selected":
-            applyNavigation(draft, draft.flowCorrelationId, event.payload.reactorId);
+            applyNavigation(draft, draft.flowWorkflowId, event.payload.reactorId);
             break;
         case "location/changed":
-            applyNavigation(draft, event.payload.correlationId, event.payload.handler);
-            draft.filters.correlationId = event.payload.correlationId;
+            if (event.payload.subject) {
+                const [subjectType, subjectId] = event.payload.subject.split(/:(.+)/);
+                applySubjectSelected(draft, subjectType, subjectId, event.payload.subjectMode ?? "both");
+            }
+            else {
+                applyNavigation(draft, event.payload.workflowId, event.payload.handler);
+                draft.filters.workflowId = event.payload.workflowId;
+            }
             break;
         // ── UI ──
         case "ui/event_selected":
@@ -158,9 +184,9 @@ export const reducer = (draft, event) => {
             // Clear reactor filter when deselecting a node
             if (event.payload == null && draft.logsFilter.reactorId != null) {
                 draft.logsFilter = {
-                    scope: "correlation",
+                    scope: "workflow",
                     reactorId: null,
-                    correlationId: draft.flowCorrelationId,
+                    workflowId: draft.flowWorkflowId,
                 };
             }
             break;
@@ -185,11 +211,51 @@ export const reducer = (draft, event) => {
         case "ui/scrubber_speed_changed":
             draft.scrubberSpeed = event.payload.speed;
             break;
-        case "ui/correlations_requested":
-            draft.correlationsLoading = true;
+        case "ui/workflows_requested":
+            draft.workflowsLoading = true;
+            break;
+        case "ui/load_more_workflows_requested":
+            draft.workflowsLoading = true;
+            break;
+        // ── Entity-scoped inspection ──
+        case "ui/subject_selected":
+            applySubjectSelected(draft, event.payload.aggregateType, event.payload.aggregateId, event.payload.mode ?? "both");
+            break;
+        case "ui/subject_mode_changed":
+            draft.subjectMode = event.payload.mode;
+            draft.subjectChain = [];
+            draft.subjectChainCursor = null;
+            draft.subjectChainLoading = true;
+            break;
+        case "ui/subject_chain_load_more":
+            draft.subjectChainLoading = true;
             break;
-        case "ui/load_more_correlations_requested":
-            draft.correlationsLoading = true;
+        case "ui/event_effects_requested": {
+            const { eventId } = event.payload;
+            if (!draft.loadingEffects.includes(eventId) && !(eventId in draft.expandedEffects)) {
+                draft.loadingEffects.push(eventId);
+            }
+            break;
+        }
+        case "events/subject_chain_loaded": {
+            const { events, hasMore, cursor, depthCapped, append } = event.payload;
+            if (append) {
+                draft.subjectChain.push(...events);
+            }
+            else {
+                draft.subjectChain = events;
+            }
+            draft.subjectChainHasMore = hasMore;
+            draft.subjectChainCursor = cursor;
+            draft.subjectDepthCapped = depthCapped;
+            draft.subjectChainLoading = false;
             break;
+        }
+        case "events/event_effects_loaded": {
+            const { eventId, effects } = event.payload;
+            draft.expandedEffects[eventId] = effects;
+            draft.loadingEffects = draft.loadingEffects.filter(id => id !== eventId);
+            break;
+        }
     }
 };

package/dist/state.d.ts

@@ -1,10 +1,10 @@
-import type { InspectorEvent, CorrelationSummary, ReactorDependency, AggregateLifecycleEntry, FilterState, FlowSelection, ReactorDescription, ReactorDescriptionSnapshot, AggregateTimelineEntry, ReactorLog, ReactorOutcome, LogsFilter, PaneLayout } from "./types";
+import type { InspectorEvent, WorkflowSummary, ReactorDependency, AggregateLifecycleEntry, FilterState, FlowSelection, ReactorDescription, ReactorDescriptionSnapshot, AggregateTimelineEntry, ReactorLog, ReactorOutcome, ReactorAttempt, LogsFilter, PaneLayout, SubjectChainEvent, SubjectChainMode, InspectorEffect } from "./types";
 export type InspectorState = {
     events: InspectorEvent[];
     hasMore: boolean;
     loading: boolean;
     selectedSeq: number | null;
-    flowCorrelationId: string | null;
+    flowWorkflowId: string | null;
     flowData: InspectorEvent[];
     flowSelection: FlowSelection;
     scrubberStart: number | null;
@@ -22,14 +22,25 @@ export type InspectorState = {
     descriptionSnapshots: Record<string, ReactorDescriptionSnapshot[]>;
     aggregateTimeline: Record<string, AggregateTimelineEntry[]>;
     outcomes: Record<string, ReactorOutcome[]>;
-    correlations: CorrelationSummary[];
-    correlationsLoading: boolean;
-    correlationsHasMore: boolean;
+    attempts: Record<string, ReactorAttempt[]>;
+    workflows: WorkflowSummary[];
+    workflowsLoading: boolean;
+    workflowsHasMore: boolean;
     reactorDependencies: ReactorDependency[];
     aggregateKeys: string[];
     aggregateLifecycle: AggregateLifecycleEntry[];
     aggregateLifecycleKey: string | null;
     subscription: "connected" | "disconnected" | "error";
     paneLayout: PaneLayout | null;
+    subjectType: string | null;
+    subjectId: string | null;
+    subjectMode: SubjectChainMode;
+    subjectChain: SubjectChainEvent[];
+    subjectChainLoading: boolean;
+    subjectChainHasMore: boolean;
+    subjectChainCursor: number | null;
+    subjectDepthCapped: boolean;
+    expandedEffects: Record<string, InspectorEffect[]>;
+    loadingEffects: string[];
 };
 export declare const initialState: InspectorState;

package/dist/state.js

@@ -3,7 +3,7 @@ export const initialState = {
     hasMore: true,
     loading: false,
     selectedSeq: null,
-    flowCorrelationId: null,
+    flowWorkflowId: null,
     flowData: [],
     flowSelection: null,
     scrubberStart: null,
@@ -13,26 +13,37 @@ export const initialState = {
     causalTree: null,
     filters: {
         search: "",
-        correlationId: null,
+        workflowId: null,
         aggregateKey: null,
     },
     logs: [],
     logsFilter: {
         scope: "reactor",
         reactorId: null,
-        correlationId: null,
+        workflowId: null,
     },
     descriptions: {},
     descriptionSnapshots: {},
     aggregateTimeline: {},
     outcomes: {},
-    correlations: [],
-    correlationsLoading: false,
-    correlationsHasMore: true,
+    attempts: {},
+    workflows: [],
+    workflowsLoading: false,
+    workflowsHasMore: true,
     reactorDependencies: [],
     aggregateKeys: [],
     aggregateLifecycle: [],
     aggregateLifecycleKey: null,
     subscription: "disconnected",
     paneLayout: null,
+    subjectType: null,
+    subjectId: null,
+    subjectMode: "both",
+    subjectChain: [],
+    subjectChainLoading: false,
+    subjectChainHasMore: false,
+    subjectChainCursor: null,
+    subjectDepthCapped: false,
+    expandedEffects: {},
+    loadingEffects: [],
 };

package/dist/theme.js

@@ -31,4 +31,5 @@ export const LOG_LEVEL_COLORS = {
     debug: "bg-zinc-600/20 text-zinc-400",
     info: "bg-indigo-500/15 text-indigo-400",
     warn: "bg-amber-500/15 text-amber-400",
+    error: "bg-red-500/15 text-red-400",
 };

package/dist/types.d.ts

@@ -5,12 +5,12 @@ export type InspectorEvent = {
     type: string;
     name: string;
     id: string | null;
-    parentId: string | null;
-    correlationId: string | null;
+    causationId: string | null;
+    workflowId: string | null;
     reactorId: string | null;
     aggregateType: string | null;
     aggregateId: string | null;
-    streamVersion: number | null;
+    streamRevision: number | null;
     summary: string | null;
     payload: string;
 };
@@ -75,6 +75,16 @@ export type ReactorOutcome = {
     completedAt: string | null;
     triggeringEventIds: string[];
 };
+export type ReactorAttempt = {
+    eventId: string;
+    reactorId: string;
+    workflowId: string;
+    attempt: number;
+    status: string;
+    error: string | null;
+    startedAt: string;
+    completedAt: string;
+};
 export type ReactorDescriptionSnapshot = {
     seq: number;
     eventId: string;
@@ -101,31 +111,31 @@ export type AggregateLifecycleEntry = {
     eventId: string;
     eventType: string;
     ts: string;
-    correlationId: string;
+    workflowId: string;
     aggregateKey: string;
     state: unknown;
 };
-export type CorrelationSummary = {
-    correlationId: string;
+export type WorkflowSummary = {
+    workflowId: string;
     eventCount: number;
     firstTs: string;
     lastTs: string;
     rootEventType: string;
     hasErrors: boolean;
 };
-export type CorrelationSummaryPage = {
-    correlations: CorrelationSummary[];
+export type WorkflowSummaryPage = {
+    workflows: WorkflowSummary[];
     nextCursor: string | null;
 };
 export type FilterState = {
     search: string;
-    correlationId: string | null;
+    workflowId: string | null;
     aggregateKey: string | null;
 };
 export type LogsFilter = {
-    scope: "reactor" | "correlation";
+    scope: "reactor" | "workflow";
     reactorId: string | null;
-    correlationId: string | null;
+    workflowId: string | null;
 };
 export type FlowSelection = {
     kind: "event-type";
@@ -140,3 +150,41 @@ export type FlowSelection = {
  * just stores and round-trips it.
  */
 export type PaneLayout = Record<string, unknown>;
+/** Whether a subject-chain event came from the entity's own stream or a downstream descendant. */
+export type SubjectChainSourceMode = "stream" | "descendant";
+/** Query mode for subject_chain — which events to include. */
+export type SubjectChainMode = "stream" | "descendants" | "both";
+/** One event in a subject chain response, with display names applied. */
+export type SubjectChainEvent = {
+    seq: number;
+    ts: string;
+    type: string;
+    name: string;
+    id: string | null;
+    causationId: string | null;
+    workflowId: string | null;
+    reactorId: string | null;
+    aggregateType: string | null;
+    aggregateId: string | null;
+    streamRevision: number | null;
+    summary: string | null;
+    payload: string;
+    sourceMode: SubjectChainSourceMode;
+};
+/** One `ctx.effect()` result for the effects inspector panel. */
+export type InspectorEffect = {
+    consumer: string;
+    label: string;
+    value: unknown;
+    createdAt: string;
+};
+/** One entity entry from the aggregate keys listing. */
+export type AggregateKeyEntry = {
+    aggregateId: string;
+    displayLabel: string | null;
+};
+/** Paginated entity listing response. */
+export type AggregateKeysPage = {
+    entries: AggregateKeyEntry[];
+    nextCursor: string | null;
+};

package/dist/utils.js

@@ -9,7 +9,7 @@ export function inScrubberRange(seq, start, end) {
 /** Derive the walkable seq list based on current context (flow, selection, or global). */
 export function getScrubberSequence(state) {
     let events;
-    if (state.flowCorrelationId) {
+    if (state.flowWorkflowId) {
         events = state.flowData;
         const sel = state.flowSelection;
         if (sel) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "causal-inspector",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",