dsh-auto-review 0.4.0

package/lib/events-CFl6CHZi.js

@@ -0,0 +1,344 @@
+//#region src/events.ts
+/** Closed {@link AutoReviewFallback} list for runtime normalization. */
+const AUTO_REVIEW_FALLBACKS = [
+	"timeout",
+	"cancelled",
+	"unavailable",
+	"schema"
+];
+/**
+* Brand a string as an {@link AutoReviewVerdictId}.
+* @param id - the raw id string.
+* @returns the same string, branded (a compile-time cast — no runtime cost).
+*/
+function AutoReviewVerdictId(id) {
+	return id;
+}
+/**
+* Brand a string as an {@link AutoReviewCircuitId}.
+* @param id - the raw id string.
+* @returns the same string, branded (a compile-time cast — no runtime cost).
+*/
+function AutoReviewCircuitId(id) {
+	return id;
+}
+/**
+* Brand a string as an {@link AutoReviewRejectionId}.
+* @param id - the raw id string.
+* @returns the same string, branded (a compile-time cast — no runtime cost).
+*/
+function AutoReviewRejectionId(id) {
+	return id;
+}
+/** Stable marker prefix inside every injected deny reason, parsed by the invariant companion. */
+const DENY_MARKER = "[auto-review]";
+/** Regex extracting the reviewId from an injected deny reason. */
+const DENY_MARKER_PATTERN = /\[auto-review\] review ([^\s]+) denied/u;
+/** Stable marker prefix inside every injected fallback rejection text (a distinct vocabulary from {@link DENY_MARKER}). */
+const FALLBACK_MARKER = "[auto-review-fallback]";
+/** Regex extracting the reviewId from an injected fallback rejection. */
+const FALLBACK_MARKER_PATTERN = /\[auto-review-fallback\] review ([^\s]+) failed/u;
+/** Stable marker prefix inside every injected circuit rejection text. */
+const CIRCUIT_MARKER = "[auto-review-circuit]";
+/** Regex extracting the circuitId and tool name from an injected circuit rejection. */
+const CIRCUIT_MARKER_PATTERN = /\[auto-review-circuit\] circuit ([^\s]+) rejected tool "([^"]+)" before review/u;
+/** Stable marker prefix inside every injected hard-disable (`never`) rejection text. */
+const NEVER_MARKER = "[auto-review-never]";
+/** Regex extracting the rejectionId and tool name from an injected never rejection. */
+const NEVER_MARKER_PATTERN = /\[auto-review-never\] rejection ([^\s]+) hard-disabled tool "([^"]+)"/u;
+/**
+* Build the model-visible deny text injected into a denied tool result. The
+* embedded reviewId is what makes the model-visible text reconstructable
+* from the session log (model-visible ⟺ logged).
+* @param reviewId - the verdict event's id.
+* @param toolName - the denied tool.
+* @param reason - the reviewer's reason (already truncated).
+* @returns the exact error text shown to the model.
+*/
+function denyResultText(reviewId, toolName, reason) {
+	return `Error: ${DENY_MARKER} review ${reviewId} denied tool "${toolName}": ${reason}`;
+}
+/**
+* Build the model-visible text injected into a tool result whose review
+* failed and was rejected by the fallback policy. The embedded reviewId
+* links it to the recorded fallback verdict (model-visible ⟺ logged).
+* @param reviewId - the fallback verdict event's id.
+* @param fallback - the failure category (timeout/unavailable/schema).
+* @param error - the failure detail (already truncated upstream).
+* @returns the exact error text shown to the model.
+*/
+function fallbackResultText(reviewId, fallback, error) {
+	return `Error: ${FALLBACK_MARKER} review ${reviewId} failed (${fallback}) and the request was rejected: ${error}`;
+}
+/**
+* Build the model-visible text injected into a tool result rejected by a
+* tripped circuit breaker. The embedded circuitId links it to the recorded
+* `autoReview/circuit` event (model-visible ⟺ logged).
+* @param circuitId - the circuit event's id.
+* @param toolName - the rejected tool.
+* @param explanation - why the breaker rejects (trip kind and count).
+* @returns the exact error text shown to the model.
+*/
+function circuitResultText(circuitId, toolName, explanation) {
+	return `Error: ${CIRCUIT_MARKER} circuit ${circuitId} rejected tool "${toolName}" before review: ${explanation}`;
+}
+/**
+* Build the model-visible text injected into a tool result rejected by a
+* `never` policy (a hard disable: risk rule or tool-policy table entry). The
+* embedded rejectionId links it to the recorded `autoReview/rejection` event
+* (model-visible ⟺ logged).
+* @param rejectionId - the rejection event's id.
+* @param toolName - the hard-disabled tool.
+* @param source - which rule or policy entry disabled it.
+* @returns the exact error text shown to the model.
+*/
+function neverResultText(rejectionId, toolName, source) {
+	return `Error: ${NEVER_MARKER} rejection ${rejectionId} hard-disabled tool "${toolName}": ${source}`;
+}
+/**
+* The session's auto-review override: the last `autoReview/state` event, or
+* `undefined` when the session never switched (callers apply the configured
+* `enableByDefault`). The pure fold — replay IS the state.
+* @param events - session events in log order (other types are skipped).
+* @returns the enabled flag of the last switch, or undefined without one.
+*/
+function effectiveAutoReviewState(events) {
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.type === "autoReview/state") return event.data.enabled;
+	}
+}
+/**
+* The verdict events inside the session's CURRENT open turn, oldest first.
+* A turn without `turn/start` (or one already closed by `turn/end`) yields
+* an empty list.
+* @param events - session events in log order.
+* @returns the open turn's verdict payloads.
+*/
+function openTurnVerdicts(events) {
+	let openSeq = -1;
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const type = events[index].type;
+		if (type === "turn/end") return [];
+		if (type === "turn/start") {
+			openSeq = events[index].seq;
+			break;
+		}
+	}
+	if (openSeq < 0) return [];
+	const verdicts = [];
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.seq <= openSeq) break;
+		if (event.type === "autoReview/verdict") verdicts.push(event.data);
+	}
+	verdicts.reverse();
+	return verdicts;
+}
+/**
+* How many REAL AI verdicts the session's CURRENT open turn has consumed.
+* Fallback verdicts do not count: they are budgeted separately by
+* {@link autoReviewFailuresInOpenTurn}, so a failing reviewer does not eat
+* the AI-decision budget. A turn without `turn/start` (or one already closed
+* by `turn/end`) counts zero.
+* @param events - session events in log order.
+* @returns the decision-carrying verdict count inside the current open turn.
+*/
+function autoReviewsInOpenTurn(events) {
+	return openTurnVerdicts(events).filter((data) => data.decision !== void 0).length;
+}
+/**
+* How many reviewer FAILURES the session's CURRENT open turn has consumed —
+* `autoReview/verdict` events carrying a fallback other than `cancelled`
+* (a user withdrawal is not a reviewer failure). The answerer delegates once
+* the budget is exhausted so a broken reviewer costs one timeout instead of
+* `maxFailuresPerTurn` of them.
+* @param events - session events in log order.
+* @returns the failure count inside the current open turn.
+*/
+function autoReviewFailuresInOpenTurn(events) {
+	return openTurnVerdicts(events).filter((data) => data.fallback !== void 0 && data.fallback !== "cancelled").length;
+}
+/**
+* Whether a verdict is a denial of the request: a reviewer deny, or an allow
+* overridden by the risk policy (`escalation: 'risk-policy'` with the deny
+* outcome). The circuit breaker and the approve list count both.
+* @param data - the verdict payload.
+* @returns true when the request was denied.
+*/
+function isDenial(data) {
+	return data.decision === "deny" || data.escalation === "risk-policy";
+}
+/**
+* The trailing run of consecutive denials in the current open turn —
+* the circuit breaker's `consecutiveDenies` signal.
+* @param events - session events in log order.
+* @returns the length of the trailing denial run.
+*/
+function consecutiveDeniesInOpenTurn(events) {
+	const verdicts = openTurnVerdicts(events);
+	let count = 0;
+	for (let index = verdicts.length - 1; index >= 0; index -= 1) {
+		if (!isDenial(verdicts[index])) break;
+		count += 1;
+	}
+	return count;
+}
+/**
+* How many of the last {@link windowSize} decision verdicts in the current
+* open turn are denials — the circuit breaker's `windowDenies` signal.
+* @param events - session events in log order.
+* @param windowSize - how many recent verdicts the window counts.
+* @returns the denial count inside the window.
+*/
+function deniesInRecentVerdicts(events, windowSize) {
+	return openTurnVerdicts(events).filter((data) => data.decision !== void 0).slice(-windowSize).filter((data) => isDenial(data)).length;
+}
+/**
+* The current open turn's circuit trip, when one was recorded.
+* @param events - session events in log order.
+* @returns the last `autoReview/circuit` payload in the open turn, or undefined.
+*/
+function circuitInOpenTurn(events) {
+	let openSeq = -1;
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const type = events[index].type;
+		if (type === "turn/end") return void 0;
+		if (type === "turn/start") {
+			openSeq = events[index].seq;
+			break;
+		}
+	}
+	if (openSeq < 0) return void 0;
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.seq <= openSeq) break;
+		if (event.type === "autoReview/circuit") return event.data;
+	}
+}
+/**
+* The most recent deny verdicts, newest first — the `/auto-review approve`
+* candidate list.
+* @param events - session events in log order.
+* @param limit - how many to collect.
+* @returns up to {@link limit} deny verdicts, newest first.
+*/
+function lastDeniedVerdicts(events, limit) {
+	const result = [];
+	for (let index = events.length - 1; index >= 0 && result.length < limit; index -= 1) {
+		const event = events[index];
+		if (event.type !== "autoReview/verdict" || !isDenial(event.data)) continue;
+		const data = event.data;
+		result.push({
+			reviewId: data.reviewId,
+			toolName: data.toolName,
+			...data.reason !== void 0 ? { reason: data.reason } : {},
+			...data.riskLevel !== void 0 ? { riskLevel: data.riskLevel } : {}
+		});
+	}
+	return result;
+}
+/**
+* Whether a human one-shot override is pending for a tool: the latest
+* `autoReview/override` for the tool is still unconsumed (no verdict for the
+* tool after it) and unexpired. An override is consumed by the NEXT
+* same-tool review regardless of its decision — single-use by construction.
+* @param events - session events in log order.
+* @param toolName - the tool an approval request is about.
+* @param ttlMs - the override lifetime.
+* @param now - the current epoch milliseconds.
+* @returns the overridden deny verdict's id, or undefined without a pending override.
+*/
+function activeOverride(events, toolName, ttlMs, now) {
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.type === "autoReview/verdict" && event.data.toolName === toolName) return void 0;
+		if (event.type === "autoReview/override" && event.data.toolName === toolName) return now - event.time <= ttlMs ? event.data.reviewId : void 0;
+	}
+}
+/**
+* Fold one session's review statistics: verdict counts, never-rejection
+* count, mean duration, and the three most recent verdicts.
+* @param events - session events in log order.
+* @returns the statistics.
+*/
+function reviewStats(events) {
+	let allows = 0;
+	let denies = 0;
+	let fallbacks = 0;
+	let rejections = 0;
+	let decided = 0;
+	let durationSum = 0;
+	for (const event of events) {
+		if (event.type === "autoReview/rejection") {
+			rejections += 1;
+			continue;
+		}
+		if (event.type !== "autoReview/verdict") continue;
+		const data = event.data;
+		if (data.decision === "allow") allows += 1;
+		else if (data.decision === "deny") denies += 1;
+		else fallbacks += 1;
+		if (data.decision !== void 0) {
+			decided += 1;
+			durationSum += data.durationMs;
+		}
+	}
+	const recent = [];
+	for (let index = events.length - 1; index >= 0 && recent.length < 3; index -= 1) {
+		const event = events[index];
+		if (event.type === "autoReview/verdict") recent.push(event.data);
+	}
+	return {
+		allows,
+		denies,
+		fallbacks,
+		rejections,
+		avgDurationMs: decided === 0 ? 0 : Math.round(durationSum / decided),
+		recent
+	};
+}
+/**
+* Correlate a pending approval request with the `approval/asked` event the
+* service just appended. The service appends the asked event synchronously
+* before waterfall dispatch, so the matching event is the last unpaired
+* asked event whose call id (or, without one, tool name) matches the request.
+* @param events - session events in log order.
+* @param toolName - the request's tool name.
+* @param callId - the request's call id, when present.
+* @returns the asked event's approval id, or undefined when the chain is broken.
+*/
+function correlateApprovalId(events, toolName, callId) {
+	const decided = /* @__PURE__ */ new Set();
+	let candidate;
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.type === "approval/decided") {
+			decided.add(event.data.id);
+			continue;
+		}
+		if (event.type !== "approval/asked") continue;
+		const asked = event.data;
+		if (decided.has(asked.id)) continue;
+		if (callId !== void 0 ? asked.callId === callId : asked.toolName === toolName) {
+			candidate = asked.id;
+			break;
+		}
+	}
+	return candidate;
+}
+/**
+* Find the already-presented tool call the approval request refers to — the
+* `tool/call` event whose arguments the model produced and the UI streamed.
+* @param events - session events in log order.
+* @param callId - the exact call to find.
+* @returns the call's raw arguments JSON string, or undefined without one.
+*/
+function findPresentedCall(events, callId) {
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
+		if (event.type === "tool/call" && event.data.callId === callId) return event.data.arguments;
+	}
+}
+//#endregion
+export { fallbackResultText as C, neverResultText as D, lastDeniedVerdicts as E, openTurnVerdicts as O, effectiveAutoReviewState as S, isDenial as T, circuitResultText as _, CIRCUIT_MARKER as a, deniesInRecentVerdicts as b, DENY_MARKER_PATTERN as c, NEVER_MARKER as d, NEVER_MARKER_PATTERN as f, circuitInOpenTurn as g, autoReviewsInOpenTurn as h, AutoReviewVerdictId as i, reviewStats as k, FALLBACK_MARKER as l, autoReviewFailuresInOpenTurn as m, AutoReviewCircuitId as n, CIRCUIT_MARKER_PATTERN as o, activeOverride as p, AutoReviewRejectionId as r, DENY_MARKER as s, AUTO_REVIEW_FALLBACKS as t, FALLBACK_MARKER_PATTERN as u, consecutiveDeniesInOpenTurn as v, findPresentedCall as w, denyResultText as x, correlateApprovalId as y };