@overdeck/contracts 0.60.0 → 0.62.0

package/dist/index.cjs

@@ -30,6 +30,8 @@ effect_unstable_rpc_RpcGroup = __toESM(effect_unstable_rpc_RpcGroup, 1);
 const BackendPane = effect.Schema.Struct({
 	/** Stable pane identity: the backend-native pane handle. */
 	id: effect.Schema.String,
+	/** Overdeck agent id: Herdr `agentId` token or live agent name; tmux session name (PAN-3920). */
+	agentId: effect.Schema.optional(effect.Schema.String),
 	/** Issue the pane belongs to; absent for operator conversations. */
 	issue: effect.Schema.optional(effect.Schema.String),
 	role: effect.Schema.Literals([
@@ -39,7 +41,8 @@ const BackendPane = effect.Schema.Struct({
 		"test",
 		"uat",
 		"strike",
-		"plan"
+		"plan",
+		"conversation"
 	]),
 	harness: effect.Schema.String,
 	model: effect.Schema.String,
@@ -170,9 +173,17 @@ const MEMBERSHIP_UNAVAILABLE_REASONS = [
 	"repo_unavailable",
 	"default_branch_unresolved",
 	"forge_unavailable",
+	"forge_transient",
 	"tracker_unconfigured",
 	"gather_failed"
 ];
+/**
+* PAN-3527 — the membership snapshot has not been gathered yet (a freshly
+* restarted server warming its cache). Sent with HTTP 503 and a `Retry-After`
+* header. Unlike `PipelineMembershipUnavailableBody` (a settled answer about
+* the project), this is a temporary state: callers retry it.
+*/
+const PIPELINE_MEMBERSHIP_LOADING_CODE = "snapshot_loading";
 const AgentId = effect.Schema.String;
 const SequenceNumber = effect.Schema.Number;
 const AgentStatus = effect.Schema.Literals([
@@ -191,7 +202,8 @@ const Role = effect.Schema.Literals([
 	"flywheel",
 	"strike",
 	"sequencer",
-	"knowledge"
+	"knowledge",
+	"worker"
 ]);
 const AgentResolution = effect.Schema.Literals([
 	"working",
@@ -350,6 +362,12 @@ const AgentSnapshot = effect.Schema.Struct({
 	phase: effect.Schema.optional(effect.Schema.String),
 	workType: effect.Schema.optional(effect.Schema.String),
 	roleRunHead: effect.Schema.optional(effect.Schema.String),
+	/** The agent has a live pane on its terminal backend (Herdr or tmux). */
+	hasLivePane: effect.Schema.optional(effect.Schema.Boolean),
+	/**
+	* @deprecated Misnamed alias of `hasLivePane`: true for a live pane on either
+	* backend, not only a tmux session. Still populated for compatibility (#4105).
+	*/
 	hasLiveTmuxSession: effect.Schema.optional(effect.Schema.Boolean),
 	stoppedByUser: effect.Schema.optional(effect.Schema.Boolean),
 	paused: effect.Schema.optional(effect.Schema.Boolean),
@@ -464,6 +482,39 @@ const ProjectCiSnapshot = effect.Schema.Struct({
 	/** Newest `observedAt` folded into this record. */
 	updatedAt: effect.Schema.String
 });
+/**
+* Where an in-flight dashboard self-deploy (`pan reload`) stands.
+*
+* `building` the reload holds the restart lock and is building from origin/main;
+* `awaiting-approval` the build is ready and the reload waits on the restart gate;
+* `restarting` the operator approved and the old dashboard is being replaced;
+* `failed` the last reload recorded a failure (visible for a short window).
+*/
+const ProjectDeployPhase = effect.Schema.Literals([
+	"building",
+	"awaiting-approval",
+	"restarting",
+	"failed"
+]);
+/**
+* One project's deploy, derived on the server from live runtime files: the
+* restart lock, the restart gate, the restart-status journal and the reload
+* process's own stdout. Nothing here is stored; a server restart re-derives it.
+*/
+const ProjectDeploySnapshot = effect.Schema.Struct({
+	projectKey: effect.Schema.String,
+	trigger: effect.Schema.String,
+	phase: ProjectDeployPhase,
+	/** The deploying process, while it is alive. */
+	pid: effect.Schema.optional(effect.Schema.Number),
+	/** When the server first observed this deploy (for `failed`, when it failed). */
+	startedAt: effect.Schema.String,
+	error: effect.Schema.optional(effect.Schema.String),
+	/** The reload's output file, when its stdout is a regular file. */
+	logPath: effect.Schema.optional(effect.Schema.String),
+	/** Last lines of `logPath`. */
+	logTail: effect.Schema.optional(effect.Schema.Array(effect.Schema.String))
+});
 /** What kind of process asked for the voluntary dashboard restart. */
 const RestartGateKind = effect.Schema.Literals([
 	"deploy",
@@ -533,6 +584,8 @@ const DashboardSnapshot = effect.Schema.Struct({
 	embedProgressBySessionId: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, EmbedProgressSnapshot)),
 	ciByProjectKey: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, ProjectCiSnapshot)),
 	restartGate: effect.Schema.optional(RestartGateSnapshot),
+	/** PAN-3751 — in-flight deploys keyed by project key. */
+	deployByProjectKey: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, ProjectDeploySnapshot)),
 	timestamp: effect.Schema.String
 });
 const ResourceStats = effect.Schema.Struct({ containers: effect.Schema.Array(effect.Schema.Struct({
@@ -787,6 +840,95 @@ const ScanResult = effect.Schema.Struct({
 	durationMs: effect.Schema.Number
 });
 //#endregion
+//#region src/pull-request-links.ts
+const PullRequestLinkSource = effect.Schema.Literals([
+	"manual",
+	"agent",
+	"created",
+	"branch"
+]);
+const PullRequestKey = effect.Schema.Struct({
+	host: effect.Schema.String,
+	repository: effect.Schema.String,
+	number: effect.Schema.Number
+});
+const PullRequestState = effect.Schema.Literals([
+	"open",
+	"merged",
+	"closed"
+]);
+const PullRequestSnapshot = effect.Schema.Struct({
+	state: PullRequestState,
+	isDraft: effect.Schema.Boolean,
+	title: effect.Schema.String,
+	headBranch: effect.Schema.NullOr(effect.Schema.String),
+	baseBranch: effect.Schema.NullOr(effect.Schema.String),
+	reviewState: PrReviewState,
+	checks: PrChecksState,
+	mergeable: effect.Schema.NullOr(effect.Schema.Boolean),
+	additions: effect.Schema.NullOr(effect.Schema.Number),
+	deletions: effect.Schema.NullOr(effect.Schema.Number),
+	changedFiles: effect.Schema.NullOr(effect.Schema.Number),
+	author: effect.Schema.NullOr(effect.Schema.String),
+	/** Forge timestamp, ISO. */
+	updatedAt: effect.Schema.NullOr(effect.Schema.String),
+	mergedAt: effect.Schema.NullOr(effect.Schema.String),
+	closedAt: effect.Schema.NullOr(effect.Schema.String),
+	/** When Overdeck last read the PR, ISO. */
+	syncedAt: effect.Schema.String
+});
+const PullRequestLink = effect.Schema.Struct({
+	...PullRequestKey.fields,
+	url: effect.Schema.String,
+	source: PullRequestLinkSource,
+	linkedAt: effect.Schema.String,
+	dismissedAt: effect.Schema.NullOr(effect.Schema.String),
+	snapshot: effect.Schema.NullOr(PullRequestSnapshot)
+});
+const ConversationPullRequests = effect.Schema.Struct({
+	links: effect.Schema.Array(PullRequestLink),
+	effective: effect.Schema.NullOr(PullRequestLink)
+});
+/** One conversation linked to a PR — the reverse index (PR → conversations). */
+const PullRequestLinkedConversation = effect.Schema.Struct({
+	/** The /conv/<id> number. */
+	id: effect.Schema.Number,
+	name: effect.Schema.String,
+	title: effect.Schema.NullOr(effect.Schema.String),
+	source: PullRequestLinkSource,
+	linkedAt: effect.Schema.String
+});
+/** One live link across all conversations, for the Pull requests list. */
+const PullRequestLinkListing = effect.Schema.Struct({
+	...PullRequestLink.fields,
+	conversationId: effect.Schema.Number,
+	conversationName: effect.Schema.String,
+	conversationTitle: effect.Schema.NullOr(effect.Schema.String),
+	/** The conversation's effective project, or null when none resolves. */
+	projectKey: effect.Schema.NullOr(effect.Schema.String)
+});
+function stateRank(link) {
+	if (link.snapshot === null) return 1;
+	if (link.snapshot.state === "open") return 0;
+	if (link.snapshot.state === "merged") return 2;
+	return 3;
+}
+function recency(link) {
+	return Date.parse(link.snapshot?.updatedAt ?? link.linkedAt) || 0;
+}
+/**
+* The one PR shown on a conversation: explicit links before branch links,
+* open before merged before closed, most recently updated among equals.
+* Dismissed links never count.
+*/
+function resolveEffectivePullRequest(links) {
+	const live = links.filter((link) => link.dismissedAt === null);
+	const explicit = live.filter((link) => link.source !== "branch");
+	const pool = explicit.length > 0 ? explicit : live;
+	if (pool.length === 0) return null;
+	return [...pool].sort((a, b) => stateRank(a) - stateRank(b) || recency(b) - recency(a))[0] ?? null;
+}
+//#endregion
 //#region src/memory.ts
 const MemoryAgentRole = effect.Schema.Union([Role, effect.Schema.Literal("conversation")]);
 const MemoryIdentity = effect.Schema.Struct({
@@ -1044,6 +1186,9 @@ const AgentHealthSnapshot = effect.Schema.Struct({
 	kind: effect.Schema.optional(AgentHealthKind),
 	status: AgentHealthStatus,
 	lifecycle: effect.Schema.optional(SpecialistLifecycle),
+	/** The agent has a live pane on the selected terminal backend (Herdr or tmux). */
+	hasLivePane: effect.Schema.optional(effect.Schema.Boolean),
+	/** @deprecated Alias of `hasLivePane` kept for existing readers; true on either backend, not only tmux. */
 	tmuxActive: effect.Schema.optional(effect.Schema.Boolean),
 	memoryBytes: effect.Schema.optional(effect.Schema.Number),
 	memoryGb: effect.Schema.optional(effect.Schema.Number),
@@ -1311,6 +1456,20 @@ const RestartGateChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: RestartGateSnapshot
 });
+/**
+* The set of in-flight project deploys changed (PAN-3751).
+*
+* The payload is the COMPLETE projection keyed by project key, so the reducer
+* is a plain replace. The server derives it from runtime files (restart lock,
+* restart gate, restart-status journal) and emits it in-memory only, like
+* `restart_gate.changed`: it is never persisted and never replayed at boot.
+*/
+const ProjectDeployChangedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("project.deploy_changed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({ deploys: effect.Schema.Record(effect.Schema.String, ProjectDeploySnapshot) })
+});
 /** Replaces socket.io `agents:changed` (event: 'started') */
 const AgentStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("agent.started"),
@@ -1400,6 +1559,9 @@ const AgentStatusChangedEvent = effect.Schema.Struct({
 		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: AgentStatus,
 		previousStatus: effect.Schema.optional(AgentStatus),
+		/** The agent has a live pane on its terminal backend (Herdr or tmux). */
+		hasLivePane: effect.Schema.optional(effect.Schema.Boolean),
+		/** @deprecated Alias of `hasLivePane`, kept for events written before it existed (#4105). */
 		hasLiveTmuxSession: effect.Schema.optional(effect.Schema.Boolean),
 		stoppedByUser: effect.Schema.optional(effect.Schema.Boolean),
 		stoppedByPause: effect.Schema.optional(effect.Schema.Boolean),
@@ -2466,6 +2628,17 @@ const ConversationTitleChangedEvent = effect.Schema.Struct({
 		titleSource: effect.Schema.String
 	})
 });
+/** Emitted (in-memory only) when a conversation's pull-request links or their
+* snapshots change (PAN-3822), so the list and open panel refresh the badge. */
+const ConversationPullRequestsChangedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("conversation.pull_requests_changed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		conversationName: effect.Schema.String,
+		effective: effect.Schema.NullOr(PullRequestLink)
+	})
+});
 /** Emitted (in-memory only) when a PermissionRequest hook fires or resolves for a conversation. */
 const ConversationPermissionChangedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("conversation.permission_changed"),
@@ -2600,6 +2773,7 @@ const DomainEvent = effect.Schema.Union([
 	ProjectCiSuiteObservedEvent,
 	ProjectCiHeadObservedEvent,
 	RestartGateChangedEvent,
+	ProjectDeployChangedEvent,
 	AgentCreatedEvent,
 	AgentEnrichmentChangedEvent,
 	AgentStartedEvent,
@@ -2690,6 +2864,7 @@ const DomainEvent = effect.Schema.Union([
 	ConversationCreatedEvent,
 	ConversationMovedEvent,
 	ConversationTitleChangedEvent,
+	ConversationPullRequestsChangedEvent,
 	ConversationPermissionChangedEvent,
 	ScanStartedEvent,
 	ScanProgressEvent,
@@ -3503,6 +3678,7 @@ const INITIAL_READ_MODEL_STATE = {
 	embedProgressBySessionId: {},
 	ciByProjectKey: {},
 	restartGate: null,
+	deployByProjectKey: {},
 	agentIdBySessionId: {},
 	dashboardLifecycle: {
 		active: false,
@@ -3633,14 +3809,29 @@ function syncSnapshot(state, snapshot) {
 		embedProgressBySessionId: snapshot.embedProgressBySessionId ?? {},
 		ciByProjectKey: snapshot.ciByProjectKey ?? state.ciByProjectKey,
 		restartGate: snapshot.restartGate ?? state.restartGate,
+		deployByProjectKey: snapshot.deployByProjectKey ?? state.deployByProjectKey,
 		agentIdBySessionId
 	};
 }
+/**
+* #4105 — `hasLivePane` and its deprecated alias `hasLiveTmuxSession` carry one
+* fact. An agent snapshot from a stored event may carry only the old name; fill
+* whichever one is missing so readers of either name agree.
+*/
+function withPaneLivenessAlias(agent) {
+	const pane = agent.hasLivePane ?? agent.hasLiveTmuxSession;
+	if (pane === void 0 || agent.hasLivePane === pane && agent.hasLiveTmuxSession === pane) return agent;
+	return {
+		...agent,
+		hasLivePane: pane,
+		hasLiveTmuxSession: pane
+	};
+}
 function applyEvent(state, event) {
 	switch (event.type) {
 		case "agent.created": {
 			const existing = state.agentsById[event.payload.agentId];
-			const agent = event.payload.agent;
+			const agent = withPaneLivenessAlias(event.payload.agent);
 			const nextAgentIdBySessionId = agent.sessionId ? {
 				...state.agentIdBySessionId,
 				[agent.sessionId]: agent.id
@@ -3659,7 +3850,7 @@ function applyEvent(state, event) {
 			};
 		}
 		case "agent.started": {
-			const agent = event.payload.agent;
+			const agent = withPaneLivenessAlias(event.payload.agent);
 			const nextAgentIdBySessionId = agent.sessionId ? {
 				...state.agentIdBySessionId,
 				[agent.sessionId]: agent.id
@@ -3709,6 +3900,7 @@ function applyEvent(state, event) {
 				[event.payload.agentId]: {
 					...stoppedAgent,
 					status: "stopped",
+					hasLivePane: false,
 					hasLiveTmuxSession: false,
 					lastActivity: event.timestamp
 				}
@@ -3770,6 +3962,7 @@ function applyEvent(state, event) {
 					status: event.payload.status
 				};
 				for (const field of [
+					"hasLivePane",
 					"hasLiveTmuxSession",
 					"stoppedByUser",
 					"stoppedByPause",
@@ -3814,7 +4007,15 @@ function applyEvent(state, event) {
 					if (value === null || value === void 0) delete base[field];
 					else base[field] = value;
 				}
-				const sessionAlive = event.payload.hasLiveTmuxSession === true;
+				const payloadPane = event.payload.hasLivePane ?? event.payload.hasLiveTmuxSession;
+				if ("hasLivePane" in event.payload || "hasLiveTmuxSession" in event.payload) if (payloadPane === null || payloadPane === void 0) {
+					delete base["hasLivePane"];
+					delete base["hasLiveTmuxSession"];
+				} else {
+					base["hasLivePane"] = payloadPane;
+					base["hasLiveTmuxSession"] = payloadPane;
+				}
+				const sessionAlive = payloadPane === true;
 				if (event.payload.status !== "running" && event.payload.status !== "starting" && !sessionAlive) {
 					delete base["hasPendingQuestion"];
 					delete base["pendingQuestionCount"];
@@ -4023,6 +4224,11 @@ function applyEvent(state, event) {
 				...event.payload.lastOutcome === void 0 ? {} : { lastOutcome: event.payload.lastOutcome }
 			}
 		};
+		case "project.deploy_changed": return {
+			...state,
+			sequence: Math.max(state.sequence, event.sequence),
+			deployByProjectKey: event.payload.deploys
+		};
 		case "resources.updated": return {
 			...state,
 			sequence: Math.max(state.sequence, event.sequence),
@@ -4735,6 +4941,10 @@ function applyEvent(state, event) {
 			...state,
 			conversationsListRevision: state.conversationsListRevision + 1
 		};
+		case "conversation.pull_requests_changed": return {
+			...state,
+			conversationsListRevision: state.conversationsListRevision + 1
+		};
 		case "conversation.permission_changed": {
 			const { conversationName, waiting } = event.payload;
 			if (!waiting) {
@@ -5091,34 +5301,142 @@ const FlywheelStatsTrend = effect.Schema.Literals([
 	"down",
 	"flat"
 ]);
-const FlywheelStatsCriterionValueObject = effect.Schema.Record(effect.Schema.String, effect.Schema.Json);
-const FlywheelStatsCriterionValue = effect.Schema.Union([effect.Schema.Number, FlywheelStatsCriterionValueObject]);
-const FlywheelStatsCriterion = effect.Schema.Struct({
-	label: effect.Schema.String,
-	value: FlywheelStatsCriterionValue,
-	target: FlywheelStatsCriterionValue,
+const FlywheelSubstrateSeverity = effect.Schema.Literals([
+	"P0",
+	"P1",
+	"P2",
+	"unknown"
+]);
+const FlywheelStatsWindow = effect.Schema.Struct({
+	days: effect.Schema.Number,
+	since: effect.Schema.String,
+	until: effect.Schema.String
+});
+/** c1: substrate bugs filed per merged PR in the window. */
+const FlywheelBugRateCriterion = effect.Schema.Struct({
+	/** `null` when no PR merged in the window (the rate is undefined). */
+	value: effect.Schema.NullOr(effect.Schema.Number),
+	count: effect.Schema.Number,
+	denominator: effect.Schema.Number,
+	status: FlywheelStatsCriterionStatus,
+	trend: FlywheelStatsTrend,
+	dataSufficient: effect.Schema.Boolean
+});
+/** c2: P0 substrate bugs filed in the window. */
+const FlywheelP0Criterion = effect.Schema.Struct({
+	value: effect.Schema.Number,
 	status: FlywheelStatsCriterionStatus,
-	trend: effect.Schema.optional(FlywheelStatsTrend),
-	sampleSize: effect.Schema.Number,
+	trend: FlywheelStatsTrend,
 	dataSufficient: effect.Schema.Boolean
 });
-const FlywheelStatsCriteria = effect.Schema.Struct({
-	c1_bugRate: FlywheelStatsCriterion,
-	c2_p0Bugs: FlywheelStatsCriterion,
-	c3_passRate: FlywheelStatsCriterion,
-	c4_mttr: FlywheelStatsCriterion,
-	c5_intervention: FlywheelStatsCriterion,
-	c6_timeConsistency: FlywheelStatsCriterion,
-	c7_flake: FlywheelStatsCriterion
+const FlywheelSubstrateBugRow = effect.Schema.Struct({
+	number: effect.Schema.Number,
+	title: effect.Schema.String,
+	createdAt: effect.Schema.String,
+	closedAt: effect.Schema.NullOr(effect.Schema.String),
+	severity: FlywheelSubstrateSeverity
 });
 const FlywheelStats = effect.Schema.Struct({
-	window: effect.Schema.String,
+	window: FlywheelStatsWindow,
 	generatedAt: effect.Schema.String,
-	criteria: FlywheelStatsCriteria
+	criteria: effect.Schema.Struct({
+		c1_bugRate: FlywheelBugRateCriterion,
+		c2_p0Bugs: FlywheelP0Criterion
+	}),
+	bugs: effect.Schema.Array(FlywheelSubstrateBugRow)
 });
 const decodeFlywheelStats = effect.Schema.decodeUnknownSync(FlywheelStats);
 const encodeFlywheelStats = effect.Schema.encodeSync(FlywheelStats);
 //#endregion
+//#region src/flywheel-derived.ts
+/** The loop's phases, as the skill reports them in its tick marker. */
+const TickMarkerPhase = effect.Schema.Literals([
+	"orient",
+	"pick",
+	"launch",
+	"watch",
+	"park",
+	"idle",
+	"stopping"
+]);
+/**
+* One parsed tick marker line:
+* `flywheel-tick: tick=<n> pick=<ID|none> phase=<phase> in-flight=<ID,…|none> needs-you=<text|none>`.
+*/
+const TickMarker = effect.Schema.Struct({
+	tick: effect.Schema.Number,
+	pick: effect.Schema.NullOr(effect.Schema.String),
+	phase: TickMarkerPhase,
+	inFlight: effect.Schema.Array(effect.Schema.String),
+	needsYou: effect.Schema.NullOr(effect.Schema.String)
+});
+/** `running` = row + live session; `paused` = row, no live session; `idle` = no row. */
+const FlywheelRunState = effect.Schema.Literals([
+	"running",
+	"paused",
+	"idle"
+]);
+/** Age of the last tick: ≤ 60 s live, ≤ 20 min breathing, older stalled. */
+const FlywheelFreshness = effect.Schema.Literals([
+	"live",
+	"breathing",
+	"stalled"
+]);
+const FlywheelConversationSummary = effect.Schema.Struct({
+	name: effect.Schema.String,
+	id: effect.Schema.Number,
+	title: effect.Schema.NullOr(effect.Schema.String),
+	model: effect.Schema.NullOr(effect.Schema.String),
+	harness: effect.Schema.NullOr(effect.Schema.String),
+	cwd: effect.Schema.String,
+	sessionAlive: effect.Schema.Boolean
+});
+const FlywheelLastTick = effect.Schema.Struct({
+	tick: effect.Schema.Number,
+	pick: effect.Schema.NullOr(effect.Schema.String),
+	phase: TickMarkerPhase,
+	inFlight: effect.Schema.Array(effect.Schema.String),
+	needsYou: effect.Schema.NullOr(effect.Schema.String),
+	/** The assistant message's `createdAt`. */
+	at: effect.Schema.String
+});
+const FlywheelPolicies = effect.Schema.Struct({
+	auto_pickup_backlog: effect.Schema.Boolean,
+	require_uat_before_merge: effect.Schema.Boolean,
+	merge_train_enabled: effect.Schema.Boolean
+});
+const FlywheelJournalSummary = effect.Schema.Struct({
+	at: effect.Schema.String,
+	type: effect.Schema.String,
+	source: effect.Schema.optional(effect.Schema.String)
+});
+const FlywheelInFlightRow = effect.Schema.Struct({
+	issueId: effect.Schema.String,
+	state: IssueState,
+	attention: effect.Schema.optional(IssueAttention),
+	pr: effect.Schema.optional(DerivedPrState),
+	lastJournal: effect.Schema.NullOr(FlywheelJournalSummary)
+});
+const FlywheelOrderBookSummary = effect.Schema.Struct({
+	id: effect.Schema.String,
+	name: effect.Schema.String,
+	status: effect.Schema.String,
+	landed: effect.Schema.Number,
+	total: effect.Schema.Number
+});
+const FlywheelDerivedStatus = effect.Schema.Struct({
+	run: FlywheelRunState,
+	conversation: effect.Schema.NullOr(FlywheelConversationSummary),
+	lastTick: effect.Schema.NullOr(FlywheelLastTick),
+	freshness: effect.Schema.NullOr(FlywheelFreshness),
+	policies: FlywheelPolicies,
+	inFlight: effect.Schema.Array(FlywheelInFlightRow),
+	orderBook: effect.Schema.NullOr(FlywheelOrderBookSummary),
+	projectRoot: effect.Schema.String,
+	generatedAt: effect.Schema.String
+});
+const decodeFlywheelDerivedStatus = effect.Schema.decodeUnknownSync(FlywheelDerivedStatus);
+//#endregion
 //#region src/orders.ts
 const OrderBookLane = effect.Schema.Literals(["A", "B"]);
 const OrderBookStatus = effect.Schema.Literals([
@@ -6676,6 +6994,20 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-untroubled",
+		"path": ["untroubled"],
+		"display": "/pan untroubled",
+		"description": "Clear an agent troubled gate without spawning it",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
 	{
 		"id": "pan-fork",
 		"path": ["fork"],
@@ -6756,10 +7088,16 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--issue <id>",
-				"description": "Issue ID to associate with the new conversation",
+				"description": "Issue ID to associate with the new conversation; without --cwd the new conversation starts in the issue workspace when it exists",
 				"required": true,
 				"valueHint": "id"
 			},
+			{
+				"flags": "--role <role>",
+				"description": "Pane role for the new conversation: conversation (default), work, review, test, plan. With --issue, review makes the handoff the issue's Review row",
+				"required": true,
+				"valueHint": "role"
+			},
 			{
 				"flags": "--title <title>",
 				"description": "Title for the new conversation; defaults to \"Handoff: <focus>\" (first ~70 chars) or \"Handoff: <source title>\" without focus",
@@ -7168,7 +7506,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--force",
-				"description": "Clear paused and pending-operator-decision gates and start anyway",
+				"description": "Clear paused, troubled, and pending-operator-decision gates and start anyway",
 				"required": false,
 				"valueHint": null
 			},
@@ -8123,7 +8461,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-workspace-reap",
 		"path": ["workspace", "reap"],
 		"display": "/pan workspace reap",
-		"description": "List or remove orphaned unhealthy workspace Docker stacks",
+		"description": "List or remove orphaned unhealthy workspace Docker stacks and orphaned workspace networks",
 		"args": [],
 		"options": [
 			{
@@ -8134,7 +8472,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--apply",
-				"description": "Run docker compose down -v --remove-orphans for candidates",
+				"description": "Run docker compose down -v --remove-orphans for stack candidates and remove orphaned workspace networks",
 				"required": false,
 				"valueHint": null
 			},
@@ -9680,6 +10018,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": false,
 				"valueHint": null
 			},
+			{
+				"flags": "--repair-ignore",
+				"description": "Only remove Overdeck's legacy .pan/ line from .gitignore and commit that file (no copy)",
+				"required": false,
+				"valueHint": null
+			},
 			{
 				"flags": "--state-root <dir>",
 				"description": "Override the state worktree root (tests / odd setups)",
@@ -9930,96 +10274,21 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"valueHint": "notes"
 			},
 			{
-				"flags": "--run-id <runId>",
-				"description": "Review cycle ID used to deduplicate review feedback",
+				"flags": "--tested-sha <sha>",
+				"description": "Test/UAT only: the commit the run exercised (git rev-parse HEAD before the gates)",
 				"required": true,
-				"valueHint": "runId"
-			}
-		],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-specialists-logs",
-		"path": [
-			"admin",
-			"specialists",
-			"logs"
-		],
-		"display": "/pan admin specialists logs",
-		"description": "View specialist run logs",
-		"args": [
-			{
-				"name": "project",
-				"required": false,
-				"variadic": false
-			},
-			{
-				"name": "type",
-				"required": false,
-				"variadic": false
-			},
-			{
-				"name": "runId",
-				"required": false,
-				"variadic": false
-			}
-		],
-		"options": [
-			{
-				"flags": "--json",
-				"description": "Output in JSON format",
-				"required": false,
-				"valueHint": null
+				"valueHint": "sha"
 			},
 			{
-				"flags": "--limit <count>",
-				"description": "Number of runs to show (default: 10)",
+				"flags": "--run-id <runId>",
+				"description": "Review cycle ID used to deduplicate review feedback",
 				"required": true,
-				"valueHint": "count"
-			},
-			{
-				"flags": "--tail",
-				"description": "Follow active run log in real-time",
-				"required": false,
-				"valueHint": null
+				"valueHint": "runId"
 			}
 		],
 		"aliases": [],
 		"category": "Admin"
 	},
-	{
-		"id": "pan-admin-specialists-cleanup-logs",
-		"path": [
-			"admin",
-			"specialists",
-			"cleanup-logs"
-		],
-		"display": "/pan admin specialists cleanup-logs",
-		"description": "Clean up old specialist logs",
-		"args": [{
-			"name": "project",
-			"required": false,
-			"variadic": false
-		}, {
-			"name": "type",
-			"required": false,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--force",
-			"description": "Skip confirmation prompt",
-			"required": false,
-			"valueHint": null
-		}, {
-			"flags": "--all",
-			"description": "Clean up logs for all projects",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-remote",
 		"path": ["admin", "remote"],
@@ -10910,6 +11179,80 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Conversation"
 	},
+	{
+		"id": "pan-conversations-link-pr",
+		"path": ["conversations", "link-pr"],
+		"display": "/pan conversations link-pr",
+		"description": "Link a pull request (URL, #42, or owner/repo#42) to a conversation",
+		"args": [{
+			"name": "query",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "ref",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--source <source>",
+			"description": "agent or manual (default: agent inside an agent, else manual)",
+			"required": true,
+			"valueHint": "source"
+		}],
+		"aliases": [],
+		"category": "Conversation"
+	},
+	{
+		"id": "pan-conversations-unlink-pr",
+		"path": ["conversations", "unlink-pr"],
+		"display": "/pan conversations unlink-pr",
+		"description": "Unlink a pull request from a conversation (the sweep will not re-add it)",
+		"args": [{
+			"name": "query",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "ref",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Conversation"
+	},
+	{
+		"id": "pan-conversations-prs",
+		"path": ["conversations", "prs"],
+		"display": "/pan conversations prs",
+		"description": "List the pull requests linked to a conversation (* = the one shown)",
+		"args": [{
+			"name": "query",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--json",
+			"description": "Output { links, effective } as JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Conversation"
+	},
+	{
+		"id": "pan-conversations-auto-archive-on-merge",
+		"path": ["conversations", "auto-archive-on-merge"],
+		"display": "/pan conversations auto-archive-on-merge",
+		"description": "Show or set (on|off) archiving operator conversations once all their linked PRs are merged or closed (default off)",
+		"args": [{
+			"name": "value",
+			"required": false,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Conversation"
+	},
 	{
 		"id": "pan-conversations-heal",
 		"path": ["conversations", "heal"],
@@ -11378,40 +11721,314 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"category": "CLI"
 	},
 	{
-		"id": "pan-flywheel",
-		"path": ["flywheel"],
-		"display": "/pan flywheel",
-		"description": "Start, stop, or check the flywheel conversation",
+		"id": "pan-worker",
+		"path": ["worker"],
+		"display": "/pan worker",
+		"description": "Registered workers: spawn an issue-linked agent and get its report back; register external agents",
 		"args": [],
 		"options": [],
 		"aliases": [],
-		"category": "Flywheel"
+		"category": "CLI"
 	},
 	{
-		"id": "pan-flywheel-start",
-		"path": ["flywheel", "start"],
-		"display": "/pan flywheel start",
-		"description": "Launch a conversation running /pan-flywheel",
+		"id": "pan-worker-run",
+		"path": ["worker", "run"],
+		"display": "/pan worker run",
+		"description": "Start a worker for an issue and wait for its report (exit 0 done, 4 blocked/failed, 2 no report, 3 timeout, 1 error)",
 		"args": [],
 		"options": [
 			{
-				"flags": "--model <model>",
-				"description": "Model for the flywheel conversation",
+				"flags": "--issue <id>",
+				"description": "Issue the worker belongs to (required)",
 				"required": true,
-				"valueHint": "model"
+				"valueHint": "id"
 			},
 			{
-				"flags": "--harness <harness>",
-				"description": "Harness for the flywheel conversation",
+				"flags": "--prompt <text>",
+				"description": "The brief, inline",
 				"required": true,
-				"valueHint": "harness"
+				"valueHint": "text"
 			},
 			{
-				"flags": "--cwd <path>",
-				"description": "Working directory (default: cwd)",
+				"flags": "--brief <file>",
+				"description": "The brief, from a file",
 				"required": true,
-				"valueHint": "path"
-			}
+				"valueHint": "file"
+			},
+			{
+				"flags": "--model <model>",
+				"description": "Model override (default: roles.worker.model)",
+				"required": true,
+				"valueHint": "model"
+			},
+			{
+				"flags": "--harness <harness>",
+				"description": "Harness override (default: routed from the model)",
+				"required": true,
+				"valueHint": "harness"
+			},
+			{
+				"flags": "--read-only",
+				"description": "Run in the issue workspace with git writes blocked",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--cwd <path>",
+				"description": "Working directory inside the issue workspace",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--parent <id>",
+				"description": "Spawning agent or conversation (default: $OVERDECK_AGENT_ID, then $OVERDECK_CONVERSATION)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--name <label>",
+				"description": "Label shown in the Agents Directory",
+				"required": true,
+				"valueHint": "label"
+			},
+			{
+				"flags": "--detach",
+				"description": "Print the worker id and return without waiting",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--timeout <seconds>",
+				"description": "Stop waiting after this many seconds (exit 3; the worker keeps running)",
+				"required": true,
+				"valueHint": "seconds"
+			},
+			{
+				"flags": "--stop-after-report",
+				"description": "Stop the worker after its first report",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-worker-wait",
+		"path": ["worker", "wait"],
+		"display": "/pan worker wait",
+		"description": "Wait for a worker's report (same exit codes as run); the status line names its seq",
+		"args": [{
+			"name": "worker-id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--after <seq>",
+			"description": "Return the next report after this seq (default: the newest report, whenever written)",
+			"required": true,
+			"valueHint": "seq"
+		}, {
+			"flags": "--timeout <seconds>",
+			"description": "Stop waiting after this many seconds (exit 3)",
+			"required": true,
+			"valueHint": "seconds"
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-worker-report",
+		"path": ["worker", "report"],
+		"display": "/pan worker report",
+		"description": "Record a worker's report (run by the worker itself)",
+		"args": [{
+			"name": "worker-id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--file <path>",
+				"description": "Read the Markdown report from a file",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--stdin",
+				"description": "Read the Markdown report from stdin",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--status <status>",
+				"description": "done | blocked | failed (default: done)",
+				"required": true,
+				"valueHint": "status"
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-worker-list",
+		"path": ["worker", "list"],
+		"display": "/pan worker list",
+		"description": "List workers with their parent, live state and newest report",
+		"args": [],
+		"options": [
+			{
+				"flags": "--issue <id>",
+				"description": "Only this issue's workers",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--parent <id>",
+				"description": "Only workers of this parent",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--json",
+				"description": "Print JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-worker-register",
+		"path": ["worker", "register"],
+		"display": "/pan worker register",
+		"description": "Record an agent another tool launched so the Agents Directory shows it (read-only; prints its id)",
+		"args": [],
+		"options": [
+			{
+				"flags": "--source <name>",
+				"description": "Who launched it ([a-z0-9-], not codex-plugin) (required)",
+				"required": true,
+				"valueHint": "name"
+			},
+			{
+				"flags": "--external-id <id>",
+				"description": "The launcher's id for it (required)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--harness <harness>",
+				"description": "codex, claude-code, … (required)",
+				"required": true,
+				"valueHint": "harness"
+			},
+			{
+				"flags": "--model <model>",
+				"description": "Model it runs",
+				"required": true,
+				"valueHint": "model"
+			},
+			{
+				"flags": "--cwd <path>",
+				"description": "Its working directory",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--issue <id>",
+				"description": "Issue it works on",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--parent <id>",
+				"description": "Spawning agent id, conversation tmux session, or claude-session:<uuid>",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--label <text>",
+				"description": "Label shown in the Agents Directory",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--pid <n>",
+				"description": "Its process id (liveness is read from it)",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--transcript <path>",
+				"description": "Its transcript file",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--session-id <id>",
+				"description": "Its session or thread id",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--json",
+				"description": "Print { id, created }",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-flywheel",
+		"path": ["flywheel"],
+		"display": "/pan flywheel",
+		"description": "Start, stop, pause, resume, or inspect the flywheel conversation",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-flywheel-start",
+		"path": ["flywheel", "start"],
+		"display": "/pan flywheel start",
+		"description": "Launch a conversation running /pan-flywheel",
+		"args": [],
+		"options": [
+			{
+				"flags": "--model <model>",
+				"description": "Model for the flywheel conversation",
+				"required": true,
+				"valueHint": "model"
+			},
+			{
+				"flags": "--harness <harness>",
+				"description": "Harness for the flywheel conversation",
+				"required": true,
+				"valueHint": "harness"
+			},
+			{
+				"flags": "--cwd <path>",
+				"description": "Working directory (default: cwd)",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--orders <book-id>",
+				"description": "Order book the flywheel works from",
+				"required": true,
+				"valueHint": "book-id"
+			},
+			{
+				"flags": "--fresh",
+				"description": "Replace a paused flywheel conversation instead of refusing",
+				"required": false,
+				"valueHint": null
+			}
 		],
 		"aliases": [],
 		"category": "Flywheel"
@@ -11420,7 +12037,52 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-flywheel-stop",
 		"path": ["flywheel", "stop"],
 		"display": "/pan flywheel stop",
-		"description": "Stop the flywheel conversation",
+		"description": "Ask the loop to write its report, wait for it, then pause",
+		"args": [],
+		"options": [{
+			"flags": "--timeout <ms>",
+			"description": "How long to wait for the report (default 120000)",
+			"required": true,
+			"valueHint": "ms"
+		}],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-flywheel-abort",
+		"path": ["flywheel", "abort"],
+		"display": "/pan flywheel abort",
+		"description": "Stop the flywheel conversation without a report",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-flywheel-pause",
+		"path": ["flywheel", "pause"],
+		"display": "/pan flywheel pause",
+		"description": "Stop the flywheel session, keeping its conversation and transcript",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-flywheel-resume",
+		"path": ["flywheel", "resume"],
+		"display": "/pan flywheel resume",
+		"description": "Respawn a paused flywheel and re-send /pan-flywheel",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-flywheel-report",
+		"path": ["flywheel", "report"],
+		"display": "/pan flywheel report",
+		"description": "Ask a running loop for its report, or print .pan/flywheel/report.md",
 		"args": [],
 		"options": [],
 		"aliases": [],
@@ -11430,7 +12092,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-flywheel-status",
 		"path": ["flywheel", "status"],
 		"display": "/pan flywheel status",
-		"description": "Say whether the flywheel conversation is running",
+		"description": "Show the derived flywheel status: run, last tick, policies, in-flight issues, order book",
 		"args": [],
 		"options": [{
 			"flags": "--json",
@@ -11441,6 +12103,26 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Flywheel"
 	},
+	{
+		"id": "pan-flywheel-stats",
+		"path": ["flywheel", "stats"],
+		"display": "/pan flywheel stats",
+		"description": "Substrate-bug discovery rate and P0 count, computed from the tracker and forge",
+		"args": [],
+		"options": [{
+			"flags": "--json",
+			"description": "Output as JSON",
+			"required": false,
+			"valueHint": null
+		}, {
+			"flags": "--window <days>",
+			"description": "Window in days (default 30)",
+			"required": true,
+			"valueHint": "days"
+		}],
+		"aliases": [],
+		"category": "Flywheel"
+	},
 	{
 		"id": "pan-merge",
 		"path": ["merge"],
@@ -11880,9 +12562,27 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "duration"
 			},
+			{
+				"flags": "--deacon",
+				"description": "Start Cloister/Deacon on the reloaded dashboard (always on after a reload)",
+				"required": false,
+				"valueHint": null
+			},
 			{
 				"flags": "--no-deacon",
-				"description": "Skip Cloister/Deacon auto-start after reload",
+				"description": "Refused: a Deacon-off dashboard is a peer and cannot hold the host dashboard port",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--resume",
+				"description": "Enable agent auto-resume on the reloaded dashboard (default: keep the running dashboard's resume gate)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--no-resume",
+				"description": "Disable agent auto-resume on the reloaded dashboard (default: keep the running dashboard's resume gate)",
 				"required": false,
 				"valueHint": null
 			}
@@ -12724,9 +13424,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 ];
 const COMPOSER_COMMAND_INSERT_OVERRIDES = {
 	"plan finalize": "/pan plan finalize ",
-	"admin specialists done": "/pan admin specialists done",
-	"admin specialists logs": "/pan admin specialists logs",
-	"admin specialists cleanup-logs": "/pan admin specialists cleanup-logs"
+	"admin specialists done": "/pan admin specialists done"
 };
 const COMPOSER_COMMAND_VARIANTS = [
 	{
@@ -12904,7 +13602,8 @@ const AGENT_ROLES = [
 	"test",
 	"uat",
 	"strike",
-	"plan"
+	"plan",
+	"conversation"
 ];
 function isTerminalBackendName(value) {
 	return typeof value === "string" && TERMINAL_BACKEND_NAMES.includes(value);
@@ -12913,6 +13612,182 @@ function isAgentRole(value) {
 	return typeof value === "string" && AGENT_ROLES.includes(value);
 }
 //#endregion
+//#region src/agent-directory.ts
+const DirectoryEntryKind = effect.Schema.Literals([
+	"agent",
+	"conversation",
+	"subagent",
+	"external"
+]);
+const DirectoryEntryState = effect.Schema.Literals([
+	"working",
+	"idle",
+	"blocked",
+	"done",
+	"stopped",
+	"unknown"
+]);
+const DirectoryEntrySource = effect.Schema.Literals([
+	"overdeck",
+	"pane",
+	"conversation",
+	"claude-subagent",
+	"codex-subagent",
+	"registered",
+	"codex-plugin"
+]);
+const DirectoryTranscriptRef = effect.Schema.Union([
+	effect.Schema.Struct({
+		route: effect.Schema.Literal("agent"),
+		agentId: effect.Schema.String
+	}),
+	effect.Schema.Struct({
+		route: effect.Schema.Literal("agent-subagent"),
+		agentId: effect.Schema.String,
+		subagentId: effect.Schema.String
+	}),
+	effect.Schema.Struct({
+		route: effect.Schema.Literal("conversation"),
+		conversationName: effect.Schema.String
+	}),
+	effect.Schema.Struct({
+		route: effect.Schema.Literal("conversation-subagent"),
+		conversationName: effect.Schema.String,
+		subagentId: effect.Schema.String
+	})
+]);
+const DirectoryEntryLocation = effect.Schema.Literals(["local", "remote"]);
+const DirectoryPauseBy = effect.Schema.Literals([
+	"operator",
+	"scheduler",
+	"machine"
+]);
+const DirectoryPause = effect.Schema.Struct({
+	by: DirectoryPauseBy,
+	reason: effect.Schema.NullOr(effect.Schema.String),
+	since: effect.Schema.NullOr(effect.Schema.String)
+});
+const DirectoryEntry = effect.Schema.Struct({
+	id: effect.Schema.String,
+	kind: DirectoryEntryKind,
+	label: effect.Schema.String,
+	location: DirectoryEntryLocation,
+	/** projects.yaml key; `unassigned` when none (D5). */
+	projectKey: effect.Schema.String,
+	/** Uppercase issue id, e.g. `PAN-3920`. */
+	issueId: effect.Schema.NullOr(effect.Schema.String),
+	/** The issue's title from the dashboard's tracker cache; null when unknown. */
+	issueTitle: effect.Schema.NullOr(effect.Schema.String),
+	parentId: effect.Schema.NullOr(effect.Schema.String),
+	role: effect.Schema.NullOr(effect.Schema.String),
+	/** `unknown` when not known. */
+	harness: effect.Schema.String,
+	/** `unknown` when not known. */
+	model: effect.Schema.String,
+	state: DirectoryEntryState,
+	startedAt: effect.Schema.NullOr(effect.Schema.String),
+	lastActivityAt: effect.Schema.NullOr(effect.Schema.String),
+	costUsd: effect.Schema.NullOr(effect.Schema.Number),
+	source: DirectoryEntrySource,
+	transcript: effect.Schema.NullOr(DirectoryTranscriptRef),
+	/** The pause gate from state.json, native agents only (PAN-4197). */
+	pause: effect.Schema.optional(DirectoryPause)
+});
+/**
+* `window`: live entries plus finished ones active inside `windowHours`.
+* `live` (PAN-4197): what is running or waiting now; `windowHours` is 0.
+*/
+const DirectoryScope = effect.Schema.Literals(["window", "live"]);
+const AgentDirectoryResponse = effect.Schema.Struct({
+	generatedAt: effect.Schema.String,
+	windowHours: effect.Schema.Number,
+	scope: effect.Schema.optional(DirectoryScope),
+	entries: effect.Schema.Array(DirectoryEntry)
+});
+//#endregion
+//#region src/companion-terminal.ts
+/**
+* Which companion terminal a conversation gets, or `null` for "keep the
+* owner pane as TERMINAL". A Codex conversation still on the legacy
+* `codex.transport: tui` runs the native TUI in its owner pane; the server
+* adapter reports that as `unsupported` and points at the runtime pane.
+*/
+function companionTerminalKindFor(conversation) {
+	if (conversation.harness === "opencode") return "opencode-attach";
+	if (conversation.harness === "codex") return "codex-resume-remote";
+	return null;
+}
+/** Body keys each mutation accepts. Anything else is rejected as target injection. */
+const COMPANION_TERMINAL_OPEN_BODY_KEYS = [];
+const COMPANION_TERMINAL_CLOSE_BODY_KEYS = ["generation"];
+//#endregion
+//#region src/pull-request-ref.ts
+const SCHEME = String.raw`(?:https?:\/\/)?`;
+const HOST = String.raw`([a-z0-9.-]+(?::\d+)?)`;
+const TAIL = String.raw`(?:\/[^?#]*)?(?:[?#].*)?$`;
+const GITLAB_MR = new RegExp(String.raw`^${SCHEME}${HOST}\/((?:[\w.-]+\/)+[\w.-]+)\/-\/merge_requests\/(\d+)${TAIL}`, "i");
+const GITHUB_PR = new RegExp(String.raw`^${SCHEME}${HOST}\/([\w.-]+\/[\w.-]+)\/pull\/(\d+)${TAIL}`, "i");
+const GITLAB_MR_LEGACY = new RegExp(String.raw`^${SCHEME}${HOST}\/((?:[\w.-]+\/)+[\w.-]+)\/merge_requests\/(\d+)${TAIL}`, "i");
+const SHORT_REF = /^(?:((?:[\w.-]+\/)+[\w.-]+))?[#!](\d+)$/;
+function canonicalPullRequestUrl(key, forge) {
+	return forge === "gitlab" ? `https://${key.host}/${key.repository}/-/merge_requests/${key.number}` : `https://${key.host}/${key.repository}/pull/${key.number}`;
+}
+function build(host, repository, number, forge) {
+	if (!Number.isSafeInteger(number) || number <= 0) return null;
+	const key = {
+		host: host.toLowerCase(),
+		repository: repository.toLowerCase().replace(/\.git$/, ""),
+		number
+	};
+	return {
+		...key,
+		forge,
+		url: canonicalPullRequestUrl(key, forge)
+	};
+}
+/**
+* Accepts a full PR/MR URL, `#42`, or `owner/repo#42` (`!42` for GitLab MRs).
+* The short forms need `defaultRepo` for host and forge (`#42` for the
+* repository too) and return null without it. Anything else returns null.
+*/
+function parsePullRequestRef(input, defaultRepo) {
+	const text = input.trim();
+	if (!text) return null;
+	for (const [pattern, forge] of [
+		[GITLAB_MR, "gitlab"],
+		[GITHUB_PR, "github"],
+		[GITLAB_MR_LEGACY, "gitlab"]
+	]) {
+		const match = pattern.exec(text);
+		if (match) return build(match[1], match[2], Number(match[3]), forge);
+	}
+	const short = SHORT_REF.exec(text);
+	if (!short || !defaultRepo) return null;
+	return build(defaultRepo.host, short[1] ?? defaultRepo.repository, Number(short[2]), defaultRepo.forge);
+}
+/**
+* The repository behind a git remote URL (https, ssh://, or scp-style), or null
+* when the host names neither GitHub nor GitLab.
+*/
+function repoFromRemoteUrl(remote) {
+	if (!remote) return null;
+	const text = remote.trim();
+	const match = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]*@)?([^/:]+)(?::\d+)?\/(.+?)(?:\.git)?\/?$/i.exec(text) ?? /^(?:[^@/]+@)?([^/:]+):(.+?)(?:\.git)?\/?$/i.exec(text);
+	if (!match) return null;
+	const host = match[1].toLowerCase();
+	const forge = host.includes("gitlab") ? "gitlab" : host.includes("github") ? "github" : null;
+	if (!forge) return null;
+	return {
+		host,
+		repository: match[2].toLowerCase(),
+		forge
+	};
+}
+/** True when the ref's host and repository match one of the configured repos. */
+function isConfiguredPullRequestRepo(ref, repos) {
+	return repos.some((repo) => repo.host === ref.host && repo.repository === ref.repository);
+}
+//#endregion
 exports.ACP_BEHAVIOR = ACP_BEHAVIOR;
 exports.AGENT_ROLES = AGENT_ROLES;
 exports.Activity = Activity;
@@ -12928,6 +13803,7 @@ exports.AgentCompletedEvent = AgentCompletedEvent;
 exports.AgentContextSaturationChangedEvent = AgentContextSaturationChangedEvent;
 exports.AgentCreatedEvent = AgentCreatedEvent;
 exports.AgentCurrentIssueSetEvent = AgentCurrentIssueSetEvent;
+exports.AgentDirectoryResponse = AgentDirectoryResponse;
 exports.AgentEnrichmentChangedEvent = AgentEnrichmentChangedEvent;
 exports.AgentHealthKind = AgentHealthKind;
 exports.AgentHealthSnapshot = AgentHealthSnapshot;
@@ -12980,6 +13856,8 @@ exports.BeadsFreshnessChangedEvent = BeadsFreshnessChangedEvent;
 exports.CHANNEL_REPLY_KIND_VALUES = CHANNEL_REPLY_KIND_VALUES;
 exports.CLAUDE_CODE_BEHAVIOR = CLAUDE_CODE_BEHAVIOR;
 exports.CODEX_BEHAVIOR = CODEX_BEHAVIOR;
+exports.COMPANION_TERMINAL_CLOSE_BODY_KEYS = COMPANION_TERMINAL_CLOSE_BODY_KEYS;
+exports.COMPANION_TERMINAL_OPEN_BODY_KEYS = COMPANION_TERMINAL_OPEN_BODY_KEYS;
 exports.COMPOSER_COMMAND_INSERT_OVERRIDES = COMPOSER_COMMAND_INSERT_OVERRIDES;
 exports.COMPOSER_COMMAND_MANIFEST = COMPOSER_COMMAND_MANIFEST;
 exports.COMPOSER_COMMAND_VARIANTS = COMPOSER_COMMAND_VARIANTS;
@@ -13016,6 +13894,8 @@ exports.ConversationEvent = ConversationEvent;
 exports.ConversationFilter = ConversationFilter;
 exports.ConversationMovedEvent = ConversationMovedEvent;
 exports.ConversationPermissionChangedEvent = ConversationPermissionChangedEvent;
+exports.ConversationPullRequests = ConversationPullRequests;
+exports.ConversationPullRequestsChangedEvent = ConversationPullRequestsChangedEvent;
 exports.ConversationResponse = ConversationResponse;
 exports.ConversationTitleChangedEvent = ConversationTitleChangedEvent;
 exports.CostEventRecordedEvent = CostEventRecordedEvent;
@@ -13030,6 +13910,15 @@ exports.DeployStalenessSnapshot = DeployStalenessSnapshot;
 exports.DerivedBranchState = DerivedBranchState;
 exports.DerivedIssueState = DerivedIssueState;
 exports.DerivedPrState = DerivedPrState;
+exports.DirectoryEntry = DirectoryEntry;
+exports.DirectoryEntryKind = DirectoryEntryKind;
+exports.DirectoryEntryLocation = DirectoryEntryLocation;
+exports.DirectoryEntrySource = DirectoryEntrySource;
+exports.DirectoryEntryState = DirectoryEntryState;
+exports.DirectoryPause = DirectoryPause;
+exports.DirectoryPauseBy = DirectoryPauseBy;
+exports.DirectoryScope = DirectoryScope;
+exports.DirectoryTranscriptRef = DirectoryTranscriptRef;
 exports.DiscoveredSessionSnapshot = DiscoveredSessionSnapshot;
 exports.DomainEvent = DomainEvent;
 exports.EDITORS = EDITORS;
@@ -13049,28 +13938,38 @@ exports.FeatureRegistryEntry = FeatureRegistryEntry;
 exports.FeatureRegistryStatus = FeatureRegistryStatus;
 exports.FlywheelAgent = FlywheelAgent;
 exports.FlywheelAgentStatus = FlywheelAgentStatus;
+exports.FlywheelBugRateCriterion = FlywheelBugRateCriterion;
+exports.FlywheelConversationSummary = FlywheelConversationSummary;
+exports.FlywheelDerivedStatus = FlywheelDerivedStatus;
 exports.FlywheelEffort = FlywheelEffort;
+exports.FlywheelFreshness = FlywheelFreshness;
 exports.FlywheelHarness = FlywheelHarness;
 exports.FlywheelHeadline = FlywheelHeadline;
 exports.FlywheelHttpUrl = FlywheelHttpUrl;
+exports.FlywheelInFlightRow = FlywheelInFlightRow;
+exports.FlywheelJournalSummary = FlywheelJournalSummary;
+exports.FlywheelLastTick = FlywheelLastTick;
 exports.FlywheelOrchestrator = FlywheelOrchestrator;
+exports.FlywheelOrderBookSummary = FlywheelOrderBookSummary;
 exports.FlywheelOrders = FlywheelOrders;
+exports.FlywheelP0Criterion = FlywheelP0Criterion;
 exports.FlywheelParkedItem = FlywheelParkedItem;
 exports.FlywheelPipelineItem = FlywheelPipelineItem;
 exports.FlywheelPipelineStatus = FlywheelPipelineStatus;
 exports.FlywheelPipelineVerb = FlywheelPipelineVerb;
+exports.FlywheelPolicies = FlywheelPolicies;
 exports.FlywheelRunId = FlywheelRunId;
+exports.FlywheelRunState = FlywheelRunState;
 exports.FlywheelScope = FlywheelScope;
 exports.FlywheelStats = FlywheelStats;
-exports.FlywheelStatsCriteria = FlywheelStatsCriteria;
-exports.FlywheelStatsCriterion = FlywheelStatsCriterion;
 exports.FlywheelStatsCriterionStatus = FlywheelStatsCriterionStatus;
-exports.FlywheelStatsCriterionValue = FlywheelStatsCriterionValue;
-exports.FlywheelStatsCriterionValueObject = FlywheelStatsCriterionValueObject;
 exports.FlywheelStatsTrend = FlywheelStatsTrend;
+exports.FlywheelStatsWindow = FlywheelStatsWindow;
 exports.FlywheelStatus = FlywheelStatus;
 exports.FlywheelSubstrateBug = FlywheelSubstrateBug;
+exports.FlywheelSubstrateBugRow = FlywheelSubstrateBugRow;
 exports.FlywheelSubstrateBugStatus = FlywheelSubstrateBugStatus;
+exports.FlywheelSubstrateSeverity = FlywheelSubstrateSeverity;
 exports.FlywheelSuggestion = FlywheelSuggestion;
 exports.FlywheelSuggestionAction = FlywheelSuggestionAction;
 exports.FlywheelSuggestionPriority = FlywheelSuggestionPriority;
@@ -13148,6 +14047,7 @@ exports.OrderBookLane = OrderBookLane;
 exports.OrderBookPosture = OrderBookPosture;
 exports.OrderBookSettings = OrderBookSettings;
 exports.OrderBookStatus = OrderBookStatus;
+exports.PIPELINE_MEMBERSHIP_LOADING_CODE = PIPELINE_MEMBERSHIP_LOADING_CODE;
 exports.PanRpcError = PanRpcError;
 exports.PanRpcGroup = PanRpcGroup;
 exports.PendingTurn = PendingTurn;
@@ -13171,8 +14071,18 @@ exports.ProjectCiSuite = ProjectCiSuite;
 exports.ProjectCiSuiteObservedEvent = ProjectCiSuiteObservedEvent;
 exports.ProjectContextLayerRecord = ProjectContextLayerRecord;
 exports.ProjectContextLayerTarget = ProjectContextLayerTarget;
+exports.ProjectDeployChangedEvent = ProjectDeployChangedEvent;
+exports.ProjectDeployPhase = ProjectDeployPhase;
+exports.ProjectDeploySnapshot = ProjectDeploySnapshot;
 exports.ProjectSessionTree = ProjectSessionTree;
 exports.ProposedPlan = ProposedPlan;
+exports.PullRequestKey = PullRequestKey;
+exports.PullRequestLink = PullRequestLink;
+exports.PullRequestLinkListing = PullRequestLinkListing;
+exports.PullRequestLinkSource = PullRequestLinkSource;
+exports.PullRequestLinkedConversation = PullRequestLinkedConversation;
+exports.PullRequestSnapshot = PullRequestSnapshot;
+exports.PullRequestState = PullRequestState;
 exports.RagDecision = RagDecision;
 exports.RagDecisionSource = RagDecisionSource;
 exports.ReadFileAtPathInput = ReadFileAtPathInput;
@@ -13260,6 +14170,8 @@ exports.TerminalResizeRpc = TerminalResizeRpc;
 exports.TerminalWriteRpc = TerminalWriteRpc;
 exports.TestPassedEvent = TestPassedEvent;
 exports.ThinkingState = ThinkingState;
+exports.TickMarker = TickMarker;
+exports.TickMarkerPhase = TickMarkerPhase;
 exports.TurnDiffFileChange = TurnDiffFileChange;
 exports.TurnDiffSummary = TurnDiffSummary;
 exports.WIRED_HOOK_INVENTORY = WIRED_HOOK_INVENTORY;
@@ -13283,8 +14195,11 @@ exports.WriteFileAtPathRpc = WriteFileAtPathRpc;
 exports.applyEvent = applyEvent;
 exports.applyEvents = applyEvents;
 exports.applyIssueDelta = applyIssueDelta;
+exports.canonicalPullRequestUrl = canonicalPullRequestUrl;
+exports.companionTerminalKindFor = companionTerminalKindFor;
 exports.compareIssueIds = compareIssueIds;
 exports.createIssueDelta = createIssueDelta;
+exports.decodeFlywheelDerivedStatus = decodeFlywheelDerivedStatus;
 exports.decodeFlywheelStats = decodeFlywheelStats;
 exports.deriveProjectCi = deriveProjectCi;
 exports.encodeFlywheelStats = encodeFlywheelStats;
@@ -13296,13 +14211,18 @@ exports.getRuntimeBehavior = getRuntimeBehavior;
 exports.isAgentRole = isAgentRole;
 exports.isAgentSessionName = isAgentSessionName;
 exports.isChannelReplyKind = isChannelReplyKind;
+exports.isConfiguredPullRequestRepo = isConfiguredPullRequestRepo;
 exports.isIssueAttention = isIssueAttention;
 exports.isIssueState = isIssueState;
 exports.isTerminalBackendName = isTerminalBackendName;
 exports.isTerminalTurnDiffSummaryStatus = isTerminalTurnDiffSummaryStatus;
 exports.normalizeChannelReplyPayload = normalizeChannelReplyPayload;
 exports.omitTurnDiffSummariesForAgent = omitTurnDiffSummariesForAgent;
+exports.parsePullRequestRef = parsePullRequestRef;
 exports.projectLegacySystemHealthSummary = projectLegacySystemHealthSummary;
+exports.repoFromRemoteUrl = repoFromRemoteUrl;
+exports.resolveEffectivePullRequest = resolveEffectivePullRequest;
 exports.syncSnapshot = syncSnapshot;
 exports.trimMemoryObservations = trimMemoryObservations;
 exports.trimTurnDiffSummaries = trimTurnDiffSummaries;
+exports.withPaneLivenessAlias = withPaneLivenessAlias;