@xemahq/platform-common 0.1.3

package/dist/lib/run-events/event-families.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SNAPSHOT_RELEVANT_EVENT_TYPES = exports.RUN_EVENT_FAMILY_SET = exports.RUN_EVENT_FAMILIES = exports.RUN_EVENT_TYPE_SET = exports.RUN_EVENT_TYPES = exports.TRACE_EVENT_TYPE_SET = exports.TRACE_EVENT_TYPES = exports.SEMANTIC_EVENT_TYPE_SET = exports.SEMANTIC_EVENT_TYPES = void 0;
+exports.isSemanticEventType = isSemanticEventType;
+exports.isTraceEventType = isTraceEventType;
+exports.isRunEventType = isRunEventType;
+exports.isRunEventFamily = isRunEventFamily;
+exports.SEMANTIC_EVENT_TYPES = [
+    'run.lifecycle.started',
+    'run.lifecycle.completed',
+    'run.lifecycle.stopped',
+    'run.lifecycle.cancelled',
+    'run.lifecycle.failed',
+    'run.lifecycle.paused',
+    'run.lifecycle.resumed',
+    'run.cost.updated',
+    'phase.lifecycle.started',
+    'phase.lifecycle.completed',
+    'phase.lifecycle.retrying',
+    'phase.lifecycle.gate_started',
+    'phase.lifecycle.gate_result',
+    'phase.step.planning_started',
+    'phase.step.planning_completed',
+    'phase.step.planning_coverage_gap',
+    'phase.step.packages_started',
+    'phase.step.package_started',
+    'phase.step.package_completed',
+    'phase.step.coordination_started',
+    'phase.step.coordination_completed',
+    'phase.step.template_resolution_started',
+    'phase.step.template_resolution_completed',
+    'phase.skipped_by_policy',
+    'run.lifecycle.timeout_warning',
+    'run.lifecycle.waiting_for_slot',
+    'worker.session.acquiring',
+    'worker.session.acquired',
+    'worker.session.setup',
+    'worker.session.provisioning',
+    'worker.session.phase_changed',
+    'worker.session.initializing',
+    'worker.session.idle',
+    'worker.session.finishing',
+    'worker.session.released',
+    'worker.session.failed',
+    'worker.session.status_change',
+    'worker.session.checkpoint',
+    'capacity.slot.available',
+    'capacity.slot.unavailable',
+    'capacity.limit.reached',
+    'admission.queued',
+    'admission.admitted',
+    'admission.rejected',
+    'admission.timeout',
+    'artifact.lifecycle.proposed',
+    'artifact.lifecycle.validated',
+    'artifact.lifecycle.approved',
+    'artifact.lifecycle.rejected',
+    'artifact.lifecycle.merged',
+    'artifact.lifecycle.superseded',
+    'artifact.lifecycle.archived',
+    'artifact.storage.created',
+    'artifact.storage.versioned',
+    'artifact.storage.finalized',
+    'gate.requested',
+    'gate.check_updated',
+    'gate.vote_cast',
+    'gate.resolved',
+    'gate.convergence_warning',
+    'gate.reviewing',
+    'gate.review_findings',
+    'gate.feedback_dispatched',
+    'gate.artifact_unchanged',
+    'validation.tier1_passed',
+    'validation.tier1_failed',
+    'validation.tier2_passed',
+    'validation.tier2_failed',
+    'validation.tier3_requested',
+    'validation.tier3_passed',
+    'validation.tier3_failed',
+    'blocker.raised',
+    'blocker.resolved',
+    'decision.made',
+    'decision.challenged',
+    'action.required.approval',
+    'action.required.review',
+    'action.required.escalation',
+    'action.resolved',
+    'work_unit.started',
+    'work_unit.exploring',
+    'work_unit.implementing',
+    'work_unit.testing',
+    'work_unit.reviewing',
+    'work_unit.completed',
+    'work_unit.failed',
+    'work_unit.escalated',
+    'escalation.blocked',
+    'escalation.ambiguous',
+    'escalation.human_required',
+    'escalation.context_overflow',
+    'error.detail',
+    'progress.checkpoint',
+    'progress.phase_progress',
+    'policy.applied',
+    'policy.overridden',
+    'audit.sessions_completed',
+    'workforce.resolution_started',
+    'workforce.skill_resolution_started',
+    'workforce.skill_resolution_deterministic_match',
+    'workforce.skill_resolution_llm_fallback',
+    'workforce.skills_resolved',
+    'workforce.structural_gap_detected',
+    'workforce.specialist_detected',
+    'workforce.new_agent_composed',
+    'workforce.built',
+    'integration.sync.completed',
+    'integration.sync.failed',
+    'cu.plan_drafted',
+    'cu.plan_approved',
+    'cu.amendment_requested',
+    'cu.amendment_approved',
+    'cu.executor_started',
+    'cu.executor_finished',
+];
+exports.SEMANTIC_EVENT_TYPE_SET = new Set(exports.SEMANTIC_EVENT_TYPES);
+function isSemanticEventType(value) {
+    return typeof value === 'string' && exports.SEMANTIC_EVENT_TYPE_SET.has(value);
+}
+exports.TRACE_EVENT_TYPES = [
+    'worker.tool_call.started',
+    'worker.tool_call.completed',
+    'worker.tool_call.error',
+    'worker.file_patch.proposed',
+    'worker.file_patch.applied',
+    'worker.file_patch.rejected',
+    'worker.session.todo_updated',
+    'worker.session.created',
+    'worker.session.message_user',
+    'worker.session.message_assistant',
+    'telemetry.token_usage',
+    'telemetry.model_switch',
+    'telemetry.tool_timing',
+    'telemetry.progress_ping',
+    'evidence.attached',
+    'evidence.test_results',
+    'evidence.build_log',
+    'evidence.coverage_report',
+    'conversation.chunk',
+    'cu.todo_completed',
+];
+exports.TRACE_EVENT_TYPE_SET = new Set(exports.TRACE_EVENT_TYPES);
+function isTraceEventType(value) {
+    return typeof value === 'string' && exports.TRACE_EVENT_TYPE_SET.has(value);
+}
+exports.RUN_EVENT_TYPES = [
+    ...exports.SEMANTIC_EVENT_TYPES,
+    ...exports.TRACE_EVENT_TYPES,
+];
+exports.RUN_EVENT_TYPE_SET = new Set(exports.RUN_EVENT_TYPES);
+function isRunEventType(value) {
+    return typeof value === 'string' && exports.RUN_EVENT_TYPE_SET.has(value);
+}
+exports.RUN_EVENT_FAMILIES = [
+    'run.lifecycle',
+    'run.cost',
+    'phase.lifecycle',
+    'phase.step',
+    'phase.skipped_by_policy',
+    'worker.session',
+    'artifact.lifecycle',
+    'artifact.storage',
+    'gate',
+    'validation',
+    'blocker',
+    'decision',
+    'action.required',
+    'action',
+    'work_unit',
+    'escalation',
+    'error',
+    'progress',
+    'policy',
+    'worker.tool_call',
+    'worker.file_patch',
+    'telemetry',
+    'evidence',
+    'audit',
+    'workforce',
+    'integration',
+    'capacity',
+    'admission',
+    'conversation',
+    'cu',
+];
+exports.RUN_EVENT_FAMILY_SET = new Set(exports.RUN_EVENT_FAMILIES);
+function isRunEventFamily(value) {
+    return typeof value === 'string' && exports.RUN_EVENT_FAMILY_SET.has(value);
+}
+exports.SNAPSHOT_RELEVANT_EVENT_TYPES = new Set([
+    'run.lifecycle.started',
+    'run.lifecycle.completed',
+    'run.lifecycle.stopped',
+    'run.lifecycle.cancelled',
+    'run.lifecycle.failed',
+    'run.lifecycle.paused',
+    'run.lifecycle.resumed',
+    'run.cost.updated',
+    'phase.lifecycle.started',
+    'phase.lifecycle.completed',
+    'phase.lifecycle.retrying',
+    'phase.lifecycle.gate_started',
+    'phase.lifecycle.gate_result',
+    'phase.step.planning_started',
+    'phase.step.planning_completed',
+    'phase.step.planning_coverage_gap',
+    'phase.step.packages_started',
+    'phase.step.package_started',
+    'phase.step.package_completed',
+    'phase.step.coordination_started',
+    'phase.step.coordination_completed',
+    'phase.skipped_by_policy',
+    'run.lifecycle.timeout_warning',
+    'run.lifecycle.waiting_for_slot',
+    'worker.session.acquiring',
+    'worker.session.acquired',
+    'worker.session.provisioning',
+    'worker.session.phase_changed',
+    'worker.session.initializing',
+    'worker.session.released',
+    'worker.session.failed',
+    'capacity.slot.available',
+    'capacity.slot.unavailable',
+    'capacity.limit.reached',
+    'admission.queued',
+    'admission.admitted',
+    'admission.rejected',
+    'admission.timeout',
+    'gate.requested',
+    'gate.reviewing',
+    'gate.review_findings',
+    'gate.feedback_dispatched',
+    'gate.artifact_unchanged',
+    'gate.resolved',
+    'gate.convergence_warning',
+    'blocker.raised',
+    'blocker.resolved',
+    'action.required.approval',
+    'action.required.review',
+    'action.required.escalation',
+    'action.resolved',
+    'artifact.lifecycle.proposed',
+    'artifact.lifecycle.validated',
+    'artifact.lifecycle.approved',
+    'artifact.lifecycle.rejected',
+    'artifact.lifecycle.merged',
+    'artifact.lifecycle.superseded',
+    'artifact.lifecycle.archived',
+    'artifact.storage.created',
+    'artifact.storage.versioned',
+    'artifact.storage.finalized',
+    'validation.tier1_passed',
+    'validation.tier1_failed',
+    'validation.tier2_passed',
+    'validation.tier2_failed',
+    'validation.tier3_requested',
+    'validation.tier3_passed',
+    'validation.tier3_failed',
+    'work_unit.started',
+    'work_unit.completed',
+    'work_unit.failed',
+    'work_unit.escalated',
+    'escalation.blocked',
+    'escalation.ambiguous',
+    'escalation.human_required',
+    'escalation.context_overflow',
+    'error.detail',
+    'progress.phase_progress',
+    'run.cost.updated',
+    'workforce.resolution_started',
+    'workforce.skills_resolved',
+    'workforce.built',
+]);
+//# sourceMappingURL=event-families.js.map

package/dist/lib/run-events/event-families.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-families.js","sourceRoot":"","sources":["../../../src/lib/run-events/event-families.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-events/index.d.ts

@@ -0,0 +1,7 @@
+export * from './run-event.types';
+export * from './event-families';
+export * from './run-live-snapshot.types';
+export * from './snapshot-reducer';
+export * from './stream-contracts';
+export * from './action-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/run-events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/run-events/index.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/lib/run-events/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./run-event.types"), exports);
+__exportStar(require("./event-families"), exports);
+__exportStar(require("./run-live-snapshot.types"), exports);
+__exportStar(require("./snapshot-reducer"), exports);
+__exportStar(require("./stream-contracts"), exports);
+__exportStar(require("./action-types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/run-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/run-events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAGA,oDAAkC;AAClC,mDAAiC;AACjC,4DAA0C;AAC1C,qDAAmC;AACnC,qDAAmC;AACnC,iDAA+B"}

package/dist/lib/run-events/run-event.types.d.ts

@@ -0,0 +1,60 @@
+import type { RunEventType, RunEventFamily } from './event-families';
+export declare const RUN_EVENT_SCOPE_TYPES: readonly ["run", "phase", "step", "package", "worker", "tool_call", "gate", "artifact", "validation", "work_unit", "evidence", "action", "escalation", "policy", "checkpoint", "integration", "change_unit"];
+export type RunEventScopeType = (typeof RUN_EVENT_SCOPE_TYPES)[number];
+export declare const RUN_EVENT_SCOPE_TYPE_SET: ReadonlySet<string>;
+export declare function isRunEventScopeType(value: unknown): value is RunEventScopeType;
+export declare const RUN_EVENT_ACTOR_TYPES: readonly ["user", "agent", "worker", "system"];
+export type RunEventActorType = (typeof RUN_EVENT_ACTOR_TYPES)[number];
+export declare const RUN_EVENT_ACTOR_TYPE_SET: ReadonlySet<string>;
+export declare function isRunEventActorType(value: unknown): value is RunEventActorType;
+export declare const VISIBILITY_TIERS: readonly ["user", "owner", "trace"];
+export type VisibilityTier = (typeof VISIBILITY_TIERS)[number];
+export declare const VISIBILITY_TIER_SET: ReadonlySet<string>;
+export declare function isVisibilityTier(value: unknown): value is VisibilityTier;
+export declare const IMPORTANCE_LEVELS: readonly ["milestone", "decision", "action", "normal", "trace"];
+export type ImportanceLevel = (typeof IMPORTANCE_LEVELS)[number];
+export declare const IMPORTANCE_LEVEL_SET: ReadonlySet<string>;
+export declare function isImportanceLevel(value: unknown): value is ImportanceLevel;
+export interface PayloadRef {
+    kind: string;
+    id: string;
+}
+export interface RunEventArtifactRef {
+    id: string;
+    kind: string;
+}
+export interface ActionRef {
+    id: string;
+    kind: string;
+}
+export interface RunEvent {
+    id: string;
+    schemaVersion: number;
+    runId: string;
+    orgId: string;
+    projectId: string;
+    sequence: number;
+    emitterEventId: string;
+    eventType: RunEventType;
+    eventFamily: RunEventFamily;
+    scopeType: RunEventScopeType;
+    scopeId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    correlationId?: string;
+    groupKey?: string;
+    attempt?: number;
+    sourceService: string;
+    sourceInstanceId?: string;
+    actorType?: RunEventActorType;
+    actorId?: string;
+    visibilityTier: VisibilityTier;
+    importance: ImportanceLevel;
+    summary?: string;
+    payload?: unknown;
+    payloadRef?: PayloadRef | null;
+    artifactRefs?: RunEventArtifactRef[];
+    actionRefs?: ActionRef[];
+    occurredAt: string;
+}
+//# sourceMappingURL=run-event.types.d.ts.map

package/dist/lib/run-events/run-event.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-event.types.d.ts","sourceRoot":"","sources":["../../../src/lib/run-events/run-event.types.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-events/run-event.types.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORTANCE_LEVEL_SET = exports.IMPORTANCE_LEVELS = exports.VISIBILITY_TIER_SET = exports.VISIBILITY_TIERS = exports.RUN_EVENT_ACTOR_TYPE_SET = exports.RUN_EVENT_ACTOR_TYPES = exports.RUN_EVENT_SCOPE_TYPE_SET = exports.RUN_EVENT_SCOPE_TYPES = void 0;
+exports.isRunEventScopeType = isRunEventScopeType;
+exports.isRunEventActorType = isRunEventActorType;
+exports.isVisibilityTier = isVisibilityTier;
+exports.isImportanceLevel = isImportanceLevel;
+exports.RUN_EVENT_SCOPE_TYPES = [
+    'run',
+    'phase',
+    'step',
+    'package',
+    'worker',
+    'tool_call',
+    'gate',
+    'artifact',
+    'validation',
+    'work_unit',
+    'evidence',
+    'action',
+    'escalation',
+    'policy',
+    'checkpoint',
+    'integration',
+    'change_unit',
+];
+exports.RUN_EVENT_SCOPE_TYPE_SET = new Set(exports.RUN_EVENT_SCOPE_TYPES);
+function isRunEventScopeType(value) {
+    return typeof value === 'string' && exports.RUN_EVENT_SCOPE_TYPE_SET.has(value);
+}
+exports.RUN_EVENT_ACTOR_TYPES = [
+    'user',
+    'agent',
+    'worker',
+    'system',
+];
+exports.RUN_EVENT_ACTOR_TYPE_SET = new Set(exports.RUN_EVENT_ACTOR_TYPES);
+function isRunEventActorType(value) {
+    return typeof value === 'string' && exports.RUN_EVENT_ACTOR_TYPE_SET.has(value);
+}
+exports.VISIBILITY_TIERS = ['user', 'owner', 'trace'];
+exports.VISIBILITY_TIER_SET = new Set(exports.VISIBILITY_TIERS);
+function isVisibilityTier(value) {
+    return typeof value === 'string' && exports.VISIBILITY_TIER_SET.has(value);
+}
+exports.IMPORTANCE_LEVELS = [
+    'milestone',
+    'decision',
+    'action',
+    'normal',
+    'trace',
+];
+exports.IMPORTANCE_LEVEL_SET = new Set(exports.IMPORTANCE_LEVELS);
+function isImportanceLevel(value) {
+    return typeof value === 'string' && exports.IMPORTANCE_LEVEL_SET.has(value);
+}
+//# sourceMappingURL=run-event.types.js.map

package/dist/lib/run-events/run-event.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-event.types.js","sourceRoot":"","sources":["../../../src/lib/run-events/run-event.types.ts"],"names":[],"mappings":";;;AAmCA,kDAIC;AAqBD,kDAIC;AAYD,4CAEC;AAkBD,8CAEC;AAzFY,QAAA,qBAAqB,GAAG;IACnC,KAAK;IACL,OAAO;IACP,MAAM;IACN,SAAS;IACT,QAAQ;IACR,WAAW;IACX,MAAM;IACN,UAAU;IACV,YAAY;IACZ,WAAW;IACX,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,aAAa;CACL,CAAC;AAIE,QAAA,wBAAwB,GAAwB,IAAI,GAAG,CAClE,6BAAqB,CACtB,CAAC;AAEF,SAAgB,mBAAmB,CACjC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gCAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAQY,QAAA,qBAAqB,GAAG;IACnC,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;CACA,CAAC;AAIE,QAAA,wBAAwB,GAAwB,IAAI,GAAG,CAClE,6BAAqB,CACtB,CAAC;AAEF,SAAgB,mBAAmB,CACjC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gCAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAIY,QAAA,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAIvD,QAAA,mBAAmB,GAAwB,IAAI,GAAG,CAC7D,wBAAgB,CACjB,CAAC;AAEF,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,2BAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAIY,QAAA,iBAAiB,GAAG;IAC/B,WAAW;IACX,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;CACC,CAAC;AAIE,QAAA,oBAAoB,GAAwB,IAAI,GAAG,CAC9D,yBAAiB,CAClB,CAAC;AAEF,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,4BAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/run-events/run-live-snapshot.types.d.ts

@@ -0,0 +1,69 @@
+export interface QueueSummary {
+    total: number;
+    queued: number;
+    running: number;
+    completed: number;
+    failed: number;
+}
+export interface SpanSummary {
+    total: number;
+    byKind: Record<string, number>;
+}
+export interface BlockerSummary {
+    openCount: number;
+    bySeverity: Record<string, number>;
+}
+export interface PendingActionSummary {
+    total: number;
+    byKind: Record<string, number>;
+}
+export interface EtaEstimate {
+    secondsRemaining?: number;
+    confidence: 'low' | 'medium' | 'high';
+}
+export interface CostSummary {
+    totalUsd: number;
+    burnRateUsdPerMin?: number;
+}
+export interface ArtifactLifecycleSummary {
+    proposed: number;
+    validated: number;
+    approved: number;
+    rejected: number;
+    merged: number;
+    superseded: number;
+    archived: number;
+}
+export interface ValidationPrimaryRef {
+    scopeType: 'phase' | 'gate' | 'work_unit' | 'artifact';
+    scopeId: string;
+    groupKey?: string;
+    attempt?: number;
+}
+export interface ValidationSummary {
+    activeCount: number;
+    failingCount: number;
+    pendingCount: number;
+    byScopeType: Record<'phase' | 'gate' | 'work_unit' | 'artifact', number>;
+    primaryValidationRef?: ValidationPrimaryRef;
+}
+export interface RunLiveSnapshot {
+    runId: string;
+    status: string;
+    primaryGroupKey?: string;
+    primaryStepKey?: string;
+    primaryAttempt?: number;
+    activeGroupKeys?: string[];
+    queueSummary: QueueSummary;
+    activeSpanSummary: SpanSummary;
+    blockerSummary: BlockerSummary;
+    pendingActionSummary: PendingActionSummary;
+    eta?: EtaEstimate;
+    cost: CostSummary;
+    runArtifactSummary?: ArtifactLifecycleSummary;
+    validationSummary?: ValidationSummary;
+    lastSemanticSequence: number;
+    snapshotVersion: number;
+}
+export declare function createInitialSnapshot(runId: string): RunLiveSnapshot;
+//# sourceMappingURL=run-live-snapshot.types.d.ts.map

package/dist/lib/run-events/run-live-snapshot.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-live-snapshot.types.d.ts","sourceRoot":"","sources":["../../../src/lib/run-events/run-live-snapshot.types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC;IACzE,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAGf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,oBAAoB,CAAC;IAE3C,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAGlB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAG9C,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAGtC,oBAAoB,EAAE,MAAM,CAAC;IAG7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAYpE"}

package/dist/lib/run-events/run-live-snapshot.types.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInitialSnapshot = createInitialSnapshot;
+function createInitialSnapshot(runId) {
+    return {
+        runId,
+        status: 'pending',
+        queueSummary: { total: 0, queued: 0, running: 0, completed: 0, failed: 0 },
+        activeSpanSummary: { total: 0, byKind: {} },
+        blockerSummary: { openCount: 0, bySeverity: {} },
+        pendingActionSummary: { total: 0, byKind: {} },
+        cost: { totalUsd: 0 },
+        lastSemanticSequence: 0,
+        snapshotVersion: 0,
+    };
+}
+//# sourceMappingURL=run-live-snapshot.types.js.map

package/dist/lib/run-events/run-live-snapshot.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-live-snapshot.types.js","sourceRoot":"","sources":["../../../src/lib/run-events/run-live-snapshot.types.ts"],"names":[],"mappings":";;AAqGA,sDAYC;AAZD,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO;QACL,KAAK;QACL,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC1E,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3C,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QAChD,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9C,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;QACrB,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC"}

package/dist/lib/run-events/snapshot-reducer.d.ts

@@ -0,0 +1,4 @@
+import type { RunEvent } from './run-event.types';
+import type { RunLiveSnapshot } from './run-live-snapshot.types';
+export declare function applyEventToSnapshot(snapshot: RunLiveSnapshot, event: RunEvent): RunLiveSnapshot;
+//# sourceMappingURL=snapshot-reducer.d.ts.map

package/dist/lib/run-events/snapshot-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-reducer.d.ts","sourceRoot":"","sources":["../../../src/lib/run-events/snapshot-reducer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,2BAA2B,CAAC;AAMnC,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,QAAQ,GACd,eAAe,CAkOjB"}