@overdeck/contracts 0.45.21 → 0.45.22

package/dist/index.cjs

@@ -835,6 +835,299 @@ const ExtractionProviderConfig = effect.Schema.Struct({
 	fallbackChain: effect.Schema.Array(ExtractionProviderTarget)
 });
 //#endregion
+//#region src/system-health.ts
+/**
+* Shared V2 system-health contract. Domain measurements use null for unavailable
+* evidence, unknown enum values decode to safe unavailable/unknown states, and
+* the legacy summary is a compatibility projection from the accepted V2 snapshot.
+*/
+const HealthStateValue = effect.Schema.Literals([
+	"measuring",
+	"healthy",
+	"warning",
+	"critical",
+	"unavailable"
+]);
+const HealthState = effect.Schema.String.pipe(effect.Schema.decodeTo(HealthStateValue, {
+	decode: effect.SchemaGetter.transform((value) => HealthStateValue.literals.includes(value) ? value : "unavailable"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const HealthReason = effect.Schema.Struct({
+	code: effect.Schema.String,
+	domain: effect.Schema.Literals([
+		"host",
+		"admission",
+		"agent",
+		"service"
+	]),
+	severity: effect.Schema.Literals([
+		"info",
+		"warning",
+		"critical"
+	]),
+	message: effect.Schema.String,
+	metric: effect.Schema.optional(effect.Schema.String),
+	observed: effect.Schema.optional(effect.Schema.Number),
+	threshold: effect.Schema.optional(effect.Schema.Number)
+});
+const HostPlatform = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"linux",
+	"darwin",
+	"unsupported"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "linux" || value === "darwin" || value === "unsupported" ? value : "unsupported"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+/**
+* Accepted host metrics. Null means that the platform collector could not
+* produce that signal; it must never be interpreted as a measured zero.
+*/
+const HostHealthMetrics = effect.Schema.Struct({
+	cpuPercent: effect.Schema.NullOr(effect.Schema.Number),
+	loadAverage1m: effect.Schema.NullOr(effect.Schema.Number),
+	loadPerCore1m: effect.Schema.NullOr(effect.Schema.Number),
+	totalMemoryBytes: effect.Schema.NullOr(effect.Schema.Number),
+	usedMemoryBytes: effect.Schema.NullOr(effect.Schema.Number),
+	availableMemoryBytes: effect.Schema.NullOr(effect.Schema.Number),
+	memoryUsedPercent: effect.Schema.NullOr(effect.Schema.Number),
+	memoryPressureSomeAvg10: effect.Schema.NullOr(effect.Schema.Number),
+	memoryPressureFullAvg10: effect.Schema.NullOr(effect.Schema.Number),
+	memoryPressureFreePercent: effect.Schema.NullOr(effect.Schema.Number),
+	swapTotalBytes: effect.Schema.NullOr(effect.Schema.Number),
+	swapUsedBytes: effect.Schema.NullOr(effect.Schema.Number),
+	swapUsedPercent: effect.Schema.NullOr(effect.Schema.Number),
+	swapActivityBytesPerMinute: effect.Schema.NullOr(effect.Schema.Number),
+	committedMemoryBytes: effect.Schema.NullOr(effect.Schema.Number),
+	commitLimitBytes: effect.Schema.NullOr(effect.Schema.Number),
+	virtualCommitmentPercent: effect.Schema.NullOr(effect.Schema.Number)
+});
+const AdmissionState = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"open",
+	"soft",
+	"blocked",
+	"unavailable"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "open" || value === "soft" || value === "blocked" || value === "unavailable" ? value : "unavailable"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const AgentHealthStatus = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"healthy",
+	"idle",
+	"waiting",
+	"warning",
+	"stalled",
+	"wedged",
+	"dead",
+	"unavailable"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "healthy" || value === "idle" || value === "waiting" || value === "warning" || value === "stalled" || value === "wedged" || value === "dead" || value === "unavailable" ? value : "unavailable"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const AgentHealthKind = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"work",
+	"planning",
+	"specialist",
+	"conversation",
+	"other"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "work" || value === "planning" || value === "specialist" || value === "conversation" || value === "other" ? value : "other"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const SpecialistLifecycle = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"active",
+	"warm",
+	"orphaned",
+	"unknown"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "active" || value === "warm" || value === "orphaned" || value === "unknown" ? value : "unknown"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const AgentHealthSnapshot = effect.Schema.Struct({
+	id: effect.Schema.String,
+	issueId: effect.Schema.optional(effect.Schema.String),
+	role: effect.Schema.optional(effect.Schema.String),
+	kind: effect.Schema.optional(AgentHealthKind),
+	status: AgentHealthStatus,
+	lifecycle: effect.Schema.optional(SpecialistLifecycle),
+	tmuxActive: effect.Schema.optional(effect.Schema.Boolean),
+	memoryBytes: effect.Schema.optional(effect.Schema.Number),
+	memoryGb: effect.Schema.optional(effect.Schema.Number),
+	cpuPercent: effect.Schema.optional(effect.Schema.Number),
+	currentIssue: effect.Schema.optional(effect.Schema.String),
+	lastActivityAt: effect.Schema.optional(effect.Schema.String),
+	consecutiveFailures: effect.Schema.optional(effect.Schema.Number),
+	killCount: effect.Schema.optional(effect.Schema.Number),
+	contextPercent: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Number)),
+	reasons: effect.Schema.Array(HealthReason)
+});
+const ServiceHealthStatus = effect.Schema.String.pipe(effect.Schema.decodeTo(effect.Schema.Literals([
+	"running",
+	"not_configured",
+	"degraded",
+	"stopped",
+	"unavailable"
+]), {
+	decode: effect.SchemaGetter.transform((value) => value === "running" || value === "not_configured" || value === "degraded" || value === "stopped" || value === "unavailable" ? value : "unavailable"),
+	encode: effect.SchemaGetter.transform((value) => value)
+}));
+const ServiceHealthSnapshot = effect.Schema.Struct({
+	id: effect.Schema.String,
+	label: effect.Schema.optional(effect.Schema.String),
+	required: effect.Schema.optional(effect.Schema.Boolean),
+	status: ServiceHealthStatus,
+	message: effect.Schema.String,
+	reasons: effect.Schema.Array(HealthReason)
+});
+const SystemHealthConsumer = effect.Schema.Struct({
+	id: effect.Schema.String,
+	label: effect.Schema.String,
+	type: effect.Schema.Literals([
+		"agent",
+		"specialist",
+		"container"
+	]),
+	memoryBytes: effect.Schema.Number,
+	memoryGb: effect.Schema.Number,
+	cpuPercent: effect.Schema.optional(effect.Schema.Number),
+	issueId: effect.Schema.optional(effect.Schema.String),
+	currentIssue: effect.Schema.optional(effect.Schema.String),
+	leaked: effect.Schema.optional(effect.Schema.Boolean),
+	killTarget: effect.Schema.optional(effect.Schema.Struct({
+		kind: effect.Schema.Literals([
+			"agent",
+			"specialist",
+			"container"
+		]),
+		agentId: effect.Schema.optional(effect.Schema.String),
+		containerId: effect.Schema.optional(effect.Schema.String),
+		projectKey: effect.Schema.optional(effect.Schema.String),
+		issueId: effect.Schema.optional(effect.Schema.String),
+		specialistType: effect.Schema.optional(effect.Schema.String)
+	}))
+});
+const LegacyWebhookRelaySummary = effect.Schema.Struct({
+	configured: effect.Schema.Boolean,
+	running: effect.Schema.Boolean,
+	status: effect.Schema.Literals([
+		"not_configured",
+		"running",
+		"stopped",
+		"unknown"
+	]),
+	message: effect.Schema.String
+});
+/** Compatibility fields retained for one release cycle. */
+const LegacySystemHealthSummary = effect.Schema.Struct({
+	cpuPercent: effect.Schema.Number,
+	loadAverage1m: effect.Schema.Number,
+	loadPerCore1m: effect.Schema.Number,
+	totalMemoryBytes: effect.Schema.Number,
+	usedMemoryBytes: effect.Schema.Number,
+	availableMemoryBytes: effect.Schema.Number,
+	memoryUsedPercent: effect.Schema.Number,
+	swapTotalBytes: effect.Schema.Number,
+	swapUsedBytes: effect.Schema.Number,
+	swapUsedPercent: effect.Schema.Number,
+	committedMemoryBytes: effect.Schema.Number,
+	commitLimitBytes: effect.Schema.Number,
+	overcommitPercent: effect.Schema.Number,
+	agentCount: effect.Schema.Number,
+	workAgentCount: effect.Schema.Number,
+	planningAgentCount: effect.Schema.Number,
+	specialistSessionCount: effect.Schema.Number,
+	leakedSpecialistCount: effect.Schema.Number,
+	containerCount: effect.Schema.Number,
+	containerMemoryBytes: effect.Schema.Number,
+	overdeckMemoryBytes: effect.Schema.Number,
+	overdeckMemoryPercent: effect.Schema.Number,
+	smeeRelay: LegacyWebhookRelaySummary
+});
+const SystemHealthSnapshot = effect.Schema.Struct({
+	version: effect.Schema.Literal(2),
+	state: HealthState,
+	updatedAt: effect.Schema.String,
+	nextPollMs: effect.Schema.Number,
+	host: effect.Schema.Struct({
+		state: HealthState,
+		platform: HostPlatform,
+		reasons: effect.Schema.Array(HealthReason),
+		metrics: HostHealthMetrics
+	}),
+	admission: effect.Schema.Struct({
+		state: AdmissionState,
+		availableMemoryBytes: effect.Schema.NullOr(effect.Schema.Number),
+		admittedWorkAgentCount: effect.Schema.Number,
+		reasons: effect.Schema.Array(HealthReason)
+	}),
+	agents: effect.Schema.Array(AgentHealthSnapshot),
+	services: effect.Schema.Array(ServiceHealthSnapshot),
+	topConsumers: effect.Schema.Array(SystemHealthConsumer),
+	summary: LegacySystemHealthSummary
+});
+function isWorkAgent(agent) {
+	return agent.kind === "work" || agent.role === "work";
+}
+function isPlanningAgent(agent) {
+	return agent.kind === "planning" || agent.role === "plan" || agent.role === "planning";
+}
+function isSpecialistAgent(agent) {
+	return agent.kind === "specialist" || agent.role === "review" || agent.role?.startsWith("review-") === true || agent.role === "test" || agent.role === "ship";
+}
+function projectWebhookRelay(services) {
+	const relay = services.find((service) => service.id === "smee-relay" || service.id === "webhook-relay");
+	if (!relay) return {
+		configured: false,
+		running: false,
+		status: "unknown",
+		message: "Webhook relay health is unavailable."
+	};
+	const status = relay.status === "running" || relay.status === "not_configured" || relay.status === "stopped" ? relay.status : "unknown";
+	return {
+		configured: relay.status !== "not_configured",
+		running: relay.status === "running",
+		status,
+		message: relay.message
+	};
+}
+/**
+* Projects the V2 domains into the legacy summary without recollecting state.
+* Diagnostic-only swap and virtual-commitment values remain visible here but
+* do not participate in V2 health-state evaluation.
+*/
+function projectLegacySystemHealthSummary(snapshot) {
+	const metrics = snapshot.host.metrics;
+	const agentMemoryBytes = snapshot.agents.reduce((total, agent) => total + (agent.memoryBytes ?? 0), 0);
+	const containers = snapshot.topConsumers.filter((consumer) => consumer.type === "container");
+	const containerMemoryBytes = containers.reduce((total, consumer) => total + consumer.memoryBytes, 0);
+	const overdeckMemoryBytes = agentMemoryBytes + containerMemoryBytes;
+	const totalMemoryBytes = metrics.totalMemoryBytes ?? 0;
+	return {
+		cpuPercent: metrics.cpuPercent ?? 0,
+		loadAverage1m: metrics.loadAverage1m ?? 0,
+		loadPerCore1m: metrics.loadPerCore1m ?? 0,
+		totalMemoryBytes,
+		usedMemoryBytes: metrics.usedMemoryBytes ?? 0,
+		availableMemoryBytes: metrics.availableMemoryBytes ?? 0,
+		memoryUsedPercent: metrics.memoryUsedPercent ?? 0,
+		swapTotalBytes: metrics.swapTotalBytes ?? 0,
+		swapUsedBytes: metrics.swapUsedBytes ?? 0,
+		swapUsedPercent: metrics.swapUsedPercent ?? 0,
+		committedMemoryBytes: metrics.committedMemoryBytes ?? 0,
+		commitLimitBytes: metrics.commitLimitBytes ?? 0,
+		overcommitPercent: metrics.virtualCommitmentPercent ?? 0,
+		agentCount: snapshot.agents.length,
+		workAgentCount: snapshot.agents.filter(isWorkAgent).length,
+		planningAgentCount: snapshot.agents.filter(isPlanningAgent).length,
+		specialistSessionCount: snapshot.agents.filter(isSpecialistAgent).length,
+		leakedSpecialistCount: snapshot.agents.filter((agent) => isSpecialistAgent(agent) && agent.lifecycle === "orphaned").length,
+		containerCount: containers.length,
+		containerMemoryBytes,
+		overdeckMemoryBytes,
+		overdeckMemoryPercent: totalMemoryBytes > 0 ? Math.round(overdeckMemoryBytes / totalMemoryBytes * 1e3) / 10 : 0,
+		smeeRelay: projectWebhookRelay(snapshot.services)
+	};
+}
+//#endregion
 //#region src/events.ts
 /** App-level liveness frame for the /ws/rpc domain-events stream. */
 const SystemHeartbeatEvent = effect.Schema.Struct({
@@ -1516,7 +1809,13 @@ const SystemHealthSeverityChangedEvent = effect.Schema.Struct({
 		previousSeverity: effect.Schema.String,
 		severity: effect.Schema.String,
 		reasons: effect.Schema.Array(effect.Schema.String),
-		leakedSpecialistCount: effect.Schema.Number
+		leakedSpecialistCount: effect.Schema.Number,
+		version: effect.Schema.optional(effect.Schema.Literal(2)),
+		transitionVersion: effect.Schema.optional(effect.Schema.Number),
+		previousState: effect.Schema.optional(HealthState),
+		state: effect.Schema.optional(HealthState),
+		reasonCodes: effect.Schema.optional(effect.Schema.Array(effect.Schema.String)),
+		acceptedAt: effect.Schema.optional(effect.Schema.String)
 	})
 });
 /** Replaces socket.io `issues:snapshot` */
@@ -4609,11 +4908,41 @@ const HygieneReport = effect.Schema.Struct({
 const OVERDECK_DASHBOARD_PROTOCOL_VERSION = 1;
 const OVERDECK_AGENT_PROTOCOL_VERSION = 1;
 //#endregion
+//#region src/deploy.ts
+const DeployStalenessSnapshot = effect.Schema.Struct({
+	status: effect.Schema.Literals([
+		"fresh",
+		"stale",
+		"unknown"
+	]),
+	buildCommit: effect.Schema.NullOr(effect.Schema.String),
+	originMainSha: effect.Schema.NullOr(effect.Schema.String),
+	behindTotal: effect.Schema.NullOr(effect.Schema.Number),
+	behindBuildInputs: effect.Schema.NullOr(effect.Schema.Number),
+	originMainLastCommitAt: effect.Schema.NullOr(effect.Schema.Number),
+	computedAt: effect.Schema.Number,
+	reason: effect.Schema.optional(effect.Schema.String)
+});
+//#endregion
+//#region src/issue-sort.ts
+const collator = new Intl.Collator("en", {
+	numeric: true,
+	sensitivity: "base"
+});
+/**
+* Compares issue identifiers numerically within their prefix, so PAN-532 sorts
+* before PAN-2822. Every issue-id sort should use this comparator (PAN-2831).
+*/
+function compareIssueIds(a, b) {
+	return collator.compare(a, b);
+}
+//#endregion
 exports.Activity = Activity;
 exports.ActivityDetailedEvent = ActivityDetailedEvent;
 exports.ActivityEntryEvent = ActivityEntryEvent;
 exports.ActivityTtsEvent = ActivityTtsEvent;
 exports.ActivityUpdatedEvent = ActivityUpdatedEvent;
+exports.AdmissionState = AdmissionState;
 exports.AgentActivityChangedEvent = AgentActivityChangedEvent;
 exports.AgentChannelReply = AgentChannelReply;
 exports.AgentChannelReplyEvent = AgentChannelReplyEvent;
@@ -4622,6 +4951,9 @@ exports.AgentContextSaturationChangedEvent = AgentContextSaturationChangedEvent;
 exports.AgentCreatedEvent = AgentCreatedEvent;
 exports.AgentCurrentIssueSetEvent = AgentCurrentIssueSetEvent;
 exports.AgentEnrichmentChangedEvent = AgentEnrichmentChangedEvent;
+exports.AgentHealthKind = AgentHealthKind;
+exports.AgentHealthSnapshot = AgentHealthSnapshot;
+exports.AgentHealthStatus = AgentHealthStatus;
 exports.AgentHeartbeatDeadEvent = AgentHeartbeatDeadEvent;
 exports.AgentId = AgentId;
 exports.AgentMessageReceivedEvent = AgentMessageReceivedEvent;
@@ -4707,6 +5039,7 @@ exports.DashboardLifecycleFailedEvent = DashboardLifecycleFailedEvent;
 exports.DashboardLifecycleStartedEvent = DashboardLifecycleStartedEvent;
 exports.DashboardSnapshot = DashboardSnapshot;
 exports.DeepWipeRpc = DeepWipeRpc;
+exports.DeployStalenessSnapshot = DeployStalenessSnapshot;
 exports.DiscoveredSessionSnapshot = DiscoveredSessionSnapshot;
 exports.DomainEvent = DomainEvent;
 exports.EDITORS = EDITORS;
@@ -4760,6 +5093,10 @@ exports.GetSnapshotRpc = GetSnapshotRpc;
 exports.GetWorkspaceDetailRpc = GetWorkspaceDetailRpc;
 exports.GlobalContextLayerRecord = GlobalContextLayerRecord;
 exports.GlobalContextLayerTarget = GlobalContextLayerTarget;
+exports.HealthReason = HealthReason;
+exports.HealthState = HealthState;
+exports.HostHealthMetrics = HostHealthMetrics;
+exports.HostPlatform = HostPlatform;
 exports.HygieneFinding = HygieneFinding;
 exports.HygienePullRequest = HygienePullRequest;
 exports.HygieneReport = HygieneReport;
@@ -4769,6 +5106,8 @@ exports.IssueStatusChangedEvent = IssueStatusChangedEvent;
 exports.IssueTransitionedEvent = IssueTransitionedEvent;
 exports.IssuesSnapshotEvent = IssuesSnapshotEvent;
 exports.IssuesUpdatedEvent = IssuesUpdatedEvent;
+exports.LegacySystemHealthSummary = LegacySystemHealthSummary;
+exports.LegacyWebhookRelaySummary = LegacyWebhookRelaySummary;
 exports.ListDiscoveredSessionsRpc = ListDiscoveredSessionsRpc;
 exports.ListSessionsFeedRpc = ListSessionsFeedRpc;
 exports.MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH = MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH;
@@ -4850,6 +5189,8 @@ exports.ScanStartedEvent = ScanStartedEvent;
 exports.SearchConversationsRpc = SearchConversationsRpc;
 exports.SendTerminalInputRpc = SendTerminalInputRpc;
 exports.SequenceNumber = SequenceNumber;
+exports.ServiceHealthSnapshot = ServiceHealthSnapshot;
+exports.ServiceHealthStatus = ServiceHealthStatus;
 exports.SessionNode = SessionNode;
 exports.SessionNodePresence = SessionNodePresence;
 exports.SessionNodeType = SessionNodeType;
@@ -4861,6 +5202,7 @@ exports.ShadowInferenceUpdateEvent = ShadowInferenceUpdateEvent;
 exports.ShellOpenInEditorRpc = ShellOpenInEditorRpc;
 exports.SpecialistCompletedEvent = SpecialistCompletedEvent;
 exports.SpecialistFailedEvent = SpecialistFailedEvent;
+exports.SpecialistLifecycle = SpecialistLifecycle;
 exports.SpecialistStartedEvent = SpecialistStartedEvent;
 exports.StartAgentRpc = StartAgentRpc;
 exports.StartPlanningRpc = StartPlanningRpc;
@@ -4872,7 +5214,9 @@ exports.SubscribeIssueEventsRpc = SubscribeIssueEventsRpc;
 exports.SubscribeProjectSessionTreeRpc = SubscribeProjectSessionTreeRpc;
 exports.SubscribeTerminalRpc = SubscribeTerminalRpc;
 exports.SubstrateBugFiledEvent = SubstrateBugFiledEvent;
+exports.SystemHealthConsumer = SystemHealthConsumer;
 exports.SystemHealthSeverityChangedEvent = SystemHealthSeverityChangedEvent;
+exports.SystemHealthSnapshot = SystemHealthSnapshot;
 exports.SystemHeartbeatEvent = SystemHeartbeatEvent;
 exports.TerminalCloseRpc = TerminalCloseRpc;
 exports.TerminalOpenRpc = TerminalOpenRpc;
@@ -4902,6 +5246,7 @@ exports.WorkspaceDetail = WorkspaceDetail;
 exports.WorkspaceWipeStartedEvent = WorkspaceWipeStartedEvent;
 exports.applyEvent = applyEvent;
 exports.applyEvents = applyEvents;
+exports.compareIssueIds = compareIssueIds;
 exports.decodeFlywheelStats = decodeFlywheelStats;
 exports.encodeFlywheelStats = encodeFlywheelStats;
 exports.getHarness = getHarness;
@@ -4913,6 +5258,7 @@ exports.isChannelReplyKind = isChannelReplyKind;
 exports.isTerminalTurnDiffSummaryStatus = isTerminalTurnDiffSummaryStatus;
 exports.normalizeChannelReplyPayload = normalizeChannelReplyPayload;
 exports.omitTurnDiffSummariesForAgent = omitTurnDiffSummariesForAgent;
+exports.projectLegacySystemHealthSummary = projectLegacySystemHealthSummary;
 exports.syncSnapshot = syncSnapshot;
 exports.trimMemoryObservations = trimMemoryObservations;
 exports.trimTurnDiffSummaries = trimTurnDiffSummaries;