@overdeck/contracts 0.61.0 → 0.62.1

package/dist/index.cjs

@@ -41,7 +41,8 @@ const BackendPane = effect.Schema.Struct({
 		"test",
 		"uat",
 		"strike",
-		"plan"
+		"plan",
+		"conversation"
 	]),
 	harness: effect.Schema.String,
 	model: effect.Schema.String,
@@ -172,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([
@@ -353,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),
@@ -467,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",
@@ -536,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({
@@ -790,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({
@@ -1047,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),
@@ -1314,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"),
@@ -1403,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),
@@ -2469,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"),
@@ -2603,6 +2773,7 @@ const DomainEvent = effect.Schema.Union([
 	ProjectCiSuiteObservedEvent,
 	ProjectCiHeadObservedEvent,
 	RestartGateChangedEvent,
+	ProjectDeployChangedEvent,
 	AgentCreatedEvent,
 	AgentEnrichmentChangedEvent,
 	AgentStartedEvent,
@@ -2693,6 +2864,7 @@ const DomainEvent = effect.Schema.Union([
 	ConversationCreatedEvent,
 	ConversationMovedEvent,
 	ConversationTitleChangedEvent,
+	ConversationPullRequestsChangedEvent,
 	ConversationPermissionChangedEvent,
 	ScanStartedEvent,
 	ScanProgressEvent,
@@ -3506,6 +3678,7 @@ const INITIAL_READ_MODEL_STATE = {
 	embedProgressBySessionId: {},
 	ciByProjectKey: {},
 	restartGate: null,
+	deployByProjectKey: {},
 	agentIdBySessionId: {},
 	dashboardLifecycle: {
 		active: false,
@@ -3636,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
@@ -3662,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
@@ -3712,6 +3900,7 @@ function applyEvent(state, event) {
 				[event.payload.agentId]: {
 					...stoppedAgent,
 					status: "stopped",
+					hasLivePane: false,
 					hasLiveTmuxSession: false,
 					lastActivity: event.timestamp
 				}
@@ -3773,6 +3962,7 @@ function applyEvent(state, event) {
 					status: event.payload.status
 				};
 				for (const field of [
+					"hasLivePane",
 					"hasLiveTmuxSession",
 					"stoppedByUser",
 					"stoppedByPause",
@@ -3817,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"];
@@ -4026,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),
@@ -4738,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) {
@@ -6787,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"],
@@ -6867,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",
@@ -7279,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
 			},
@@ -8234,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": [
 			{
@@ -8245,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
 			},
@@ -10062,87 +10289,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"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
-			},
-			{
-				"flags": "--limit <count>",
-				"description": "Number of runs to show (default: 10)",
-				"required": true,
-				"valueHint": "count"
-			},
-			{
-				"flags": "--tail",
-				"description": "Follow active run log in real-time",
-				"required": false,
-				"valueHint": null
-			}
-		],
-		"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"],
@@ -11033,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"],
@@ -12342,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
 			}
@@ -13186,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 = [
 	{
@@ -13366,7 +13602,8 @@ const AGENT_ROLES = [
 	"test",
 	"uat",
 	"strike",
-	"plan"
+	"plan",
+	"conversation"
 ];
 function isTerminalBackendName(value) {
 	return typeof value === "string" && TERMINAL_BACKEND_NAMES.includes(value);
@@ -13420,6 +13657,16 @@ const DirectoryTranscriptRef = effect.Schema.Union([
 	})
 ]);
 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,
@@ -13442,11 +13689,19 @@ const DirectoryEntry = effect.Schema.Struct({
 	lastActivityAt: effect.Schema.NullOr(effect.Schema.String),
 	costUsd: effect.Schema.NullOr(effect.Schema.Number),
 	source: DirectoryEntrySource,
-	transcript: effect.Schema.NullOr(DirectoryTranscriptRef)
+	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
@@ -13466,6 +13721,73 @@ function companionTerminalKindFor(conversation) {
 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;
@@ -13572,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;
@@ -13591,6 +13915,9 @@ 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;
@@ -13720,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;
@@ -13743,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;
@@ -13857,6 +14195,7 @@ exports.WriteFileAtPathRpc = WriteFileAtPathRpc;
 exports.applyEvent = applyEvent;
 exports.applyEvents = applyEvents;
 exports.applyIssueDelta = applyIssueDelta;
+exports.canonicalPullRequestUrl = canonicalPullRequestUrl;
 exports.companionTerminalKindFor = companionTerminalKindFor;
 exports.compareIssueIds = compareIssueIds;
 exports.createIssueDelta = createIssueDelta;
@@ -13872,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;