@smithers-orchestrator/components 0.24.0 → 0.25.0

package/src/components/computeSidecarDelta.ts

@@ -0,0 +1,57 @@
+import type { SidecarDelta } from "./SidecarDelta.ts";
+
+type RowLike = {
+	nodeId?: string;
+	node_id?: string;
+	scorerId?: string;
+	scorer_id?: string;
+	score?: number;
+	scoredAtMs?: number;
+	scored_at_ms?: number;
+} & Record<string, unknown>;
+
+type ComputeSidecarDeltaOptions = {
+	primaryNodeId: string;
+	sidecarNodeId: string;
+	scorerId?: string;
+};
+
+function getNodeId(row: RowLike): string | undefined {
+	return typeof row.nodeId === "string" ? row.nodeId : typeof row.node_id === "string" ? row.node_id : undefined;
+}
+
+function getScorerId(row: RowLike): string | undefined {
+	return typeof row.scorerId === "string"
+		? row.scorerId
+		: typeof row.scorer_id === "string"
+			? row.scorer_id
+			: undefined;
+}
+
+function getScoredAtMs(row: RowLike): number {
+	const value = row.scoredAtMs ?? row.scored_at_ms;
+	return typeof value === "number" ? value : 0;
+}
+
+function getScore(row: RowLike | undefined): number | null {
+	return typeof row?.score === "number" ? row.score : null;
+}
+
+function latestMatching(rows: RowLike[], nodeId: string, scorerId?: string): RowLike | undefined {
+	return rows
+		.filter((row) => getNodeId(row) === nodeId && (!scorerId || getScorerId(row) === scorerId))
+		.sort((a, b) => getScoredAtMs(b) - getScoredAtMs(a))[0];
+}
+
+export function computeSidecarDelta(rows: RowLike[], opts: ComputeSidecarDeltaOptions): SidecarDelta {
+	const primaryScore = getScore(latestMatching(rows, opts.primaryNodeId, opts.scorerId));
+	const sidecarScore = getScore(latestMatching(rows, opts.sidecarNodeId, opts.scorerId));
+	const delta =
+		primaryScore == null || sidecarScore == null ? null : Number((primaryScore - sidecarScore).toFixed(12));
+	return {
+		primaryScore,
+		sidecarScore,
+		delta,
+		cheaperWins: primaryScore != null && sidecarScore != null && sidecarScore >= primaryScore,
+	};
+}

package/src/components/index.js

@@ -59,6 +59,8 @@
 /** @typedef {import("./ScanFixVerifyProps.ts").ScanFixVerifyProps} ScanFixVerifyProps */
 /** @typedef {import("@smithers-orchestrator/graph/types").ScorersMap} ScorersMap */
 /** @typedef {import("./SequenceProps.ts").SequenceProps} SequenceProps */
+/** @typedef {import("./SidecarDelta.ts").SidecarDelta} SidecarDelta */
+/** @typedef {import("./SidecarProps.ts").SidecarProps} SidecarProps */
 /**
  * @template Schema
  * @typedef {import("./SignalProps.ts").SignalProps<Schema>} SignalProps
@@ -108,6 +110,8 @@ export { ScanFixVerify } from "./ScanFixVerify.js";
 export { Poller } from "./Poller.js";
 export { Supervisor } from "./Supervisor.js";
 export { Runbook } from "./Runbook.js";
+export { Sidecar } from "./Sidecar.js";
+export { computeSidecarDelta } from "./computeSidecarDelta.ts";
 // --- Engine-Backed Primitives ---
 export { Subflow } from "./Subflow.js";
 export { Sandbox } from "./Sandbox.js";
@@ -115,7 +119,7 @@ export { WaitForEvent } from "./WaitForEvent.js";
 export { Signal } from "./Signal.js";
 export { Timer } from "./Timer.js";
 export { HumanTask } from "./HumanTask.js";
-export { Saga } from "./Saga.js";
+export { Saga, SagaStep } from "./Saga.js";
 export { TryCatchFinally } from "./TryCatchFinally.js";
 // --- Core Enhancements ---
 export { Aspects } from "./Aspects.js";