@overdeck/contracts 0.67.0 → 0.69.0

package/dist/index.cjs

@@ -566,8 +566,7 @@ const AgentSnapshot = effect.Schema.Struct({
 	})),
 	resolution: effect.Schema.optional(AgentResolution),
 	resolutionCount: effect.Schema.optional(effect.Schema.Number),
-	turnEndAssessment: effect.Schema.optional(TurnEndAssessment),
-	runtimeSnapshotSequence: effect.Schema.optional(SequenceNumber)
+	turnEndAssessment: effect.Schema.optional(TurnEndAssessment)
 });
 /** PAN-3151: A recorded cycle in the review convergence tracking series */
 const TurnDiffFileChange = effect.Schema.Struct({
@@ -3366,7 +3365,11 @@ const WorkLogEntry = effect.Schema.Struct({
 	toolTitle: effect.Schema.optional(effect.Schema.String),
 	/** Raw tool_use input dict — drives per-tool expanded rendering (PAN-1459). */
 	toolInput: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, effect.Schema.Unknown)),
-	sequence: effect.Schema.optional(effect.Schema.Number)
+	sequence: effect.Schema.optional(effect.Schema.Number),
+	/** PAN-4558: UTF-8 byte length of a `result` the wire projection removed. */
+	resultBytes: effect.Schema.optional(effect.Schema.Number),
+	/** PAN-4558: the wire projection removed or cut a tool body; fetch the full entry on expand. */
+	bodyOmitted: effect.Schema.optional(effect.Schema.Boolean)
 });
 /** A human-origin message read from a subagent's own sidechain transcript (PAN-4247). */
 const SubagentHumanInput = effect.Schema.Struct({
@@ -3386,6 +3389,20 @@ const SubagentSummary = effect.Schema.Struct({
 	/** Recent human-origin sidechain inputs, most useful when a message routed into this subagent instead of the main conversation (PAN-4247). */
 	humanInputs: effect.Schema.optional(effect.Schema.Array(SubagentHumanInput))
 });
+/** PAN-4558: where a windowed response or page sits in the whole transcript. */
+const ConversationWindow = effect.Schema.Struct({
+	/** Encoded timeline key of the oldest contiguous entry; pass as `before=` for the next older page. */
+	cursor: effect.Schema.NullOr(effect.Schema.String),
+	hasOlder: effect.Schema.Boolean,
+	/** `"<dev>:<ino>"` of the transcript file the window was read from. */
+	transcript: effect.Schema.optional(effect.Schema.String)
+});
+/** PAN-4558: what a resubscribing client already holds. */
+const ConversationResume = effect.Schema.Struct({
+	afterSequence: effect.Schema.Number,
+	openIds: effect.Schema.Array(effect.Schema.String),
+	transcript: effect.Schema.String
+});
 /**
 * Response shape for GET /api/agents/:id/conversation.
 * Shared between the dashboard server route and the frontend TerminalPanel.
@@ -3408,7 +3425,9 @@ const ConversationResponse = effect.Schema.Struct({
 	effortResolution: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Struct({
 		effort: EffortLevelSchema,
 		source: effect.Schema.String
-	})))
+	}))),
+	/** PAN-4558: present on windowed and paged responses only. */
+	window: effect.Schema.optional(ConversationWindow)
 });
 const ConversationEvent = effect.Schema.Union([
 	effect.Schema.Struct({
@@ -3424,7 +3443,9 @@ const ConversationEvent = effect.Schema.Union([
 		totalCost: effect.Schema.optional(effect.Schema.Number),
 		proposedPlan: effect.Schema.optional(ProposedPlan),
 		compactBoundaries: effect.Schema.optional(effect.Schema.Array(CompactBoundary)),
-		contextUsage: effect.Schema.optional(effect.Schema.NullOr(ContextUsage))
+		contextUsage: effect.Schema.optional(effect.Schema.NullOr(ContextUsage)),
+		/** PAN-4558: set on windowed snapshots; older history is paged in by `window.cursor`. */
+		window: effect.Schema.optional(ConversationWindow)
 	}),
 	effect.Schema.Struct({ kind: effect.Schema.Literal("discovering") }),
 	effect.Schema.Struct({
@@ -3486,10 +3507,17 @@ const GetSnapshotRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.getSnapshot, {
 	success: DashboardSnapshot,
 	error: PanRpcError
 });
+/**
+* PAN-4559: the server answers this instead of events when the gap after
+* fromSequence exceeds its replay cap; the client re-bootstraps via getSnapshot.
+*/
+const ReplayTooFarBehind = effect.Schema.Struct({ tooFarBehind: effect.Schema.Literal(true) });
+/** Replay result: the missed events (unchanged array shape), or ReplayTooFarBehind. */
+const ReplayEventsResult = effect.Schema.Union([effect.Schema.Array(DomainEvent), ReplayTooFarBehind]);
 /** 5. Replay events since a given sequence number (unary) */
 const ReplayEventsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.replayEvents, {
 	payload: effect.Schema.Struct({ fromSequence: SequenceNumber }),
-	success: effect.Schema.Array(DomainEvent),
+	success: ReplayEventsResult,
 	error: PanRpcError
 });
 /** 6. Open a terminal session / attach PTY (unary) */
@@ -3657,7 +3685,9 @@ const ResizeTerminalRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.resizeTerminal
 const SubscribeConversationMessagesRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.subscribeConversationMessages, {
 	payload: effect.Schema.Struct({
 		conversationName: effect.Schema.String,
-		agentId: effect.Schema.optional(effect.Schema.String)
+		agentId: effect.Schema.optional(effect.Schema.String),
+		/** PAN-4558: what the client already holds; the server sends only newer or newly settled rows. */
+		resume: effect.Schema.optional(ConversationResume)
 	}),
 	success: ConversationEvent,
 	error: PanRpcError,
@@ -3997,23 +4027,6 @@ function removeAgentFromSessionIndex(agentIdBySessionId, agentId) {
 	for (const [sessionId, id] of Object.entries(agentIdBySessionId ?? {})) if (id !== agentId) next[sessionId] = id;
 	return next;
 }
-/**
-* Bump runtimeSnapshotSequence on the corresponding AgentSnapshot (if present)
-* so low-frequency subscribers can cheaply detect a runtime change. No-op if
-* the agent has no lifecycle snapshot yet (a runtime event arrived before
-* agent.created — unusual but defensive).
-*/
-function bumpRuntimeSnapshotSequence(agentsById, agentId, sequence) {
-	const agent = agentsById[agentId];
-	if (!agent) return agentsById;
-	return {
-		...agentsById,
-		[agentId]: {
-			...agent,
-			runtimeSnapshotSequence: sequence
-		}
-	};
-}
 function syncSnapshot(state, snapshot) {
 	const agentsById = {};
 	for (const agent of snapshot.agents) agentsById[agent.id] = agent;
@@ -4755,8 +4768,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.thinking_started": {
@@ -4781,8 +4793,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.thinking_stopped": {
@@ -4804,8 +4815,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.waiting_started": {
@@ -4830,8 +4840,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.waiting_cleared": {
@@ -4853,8 +4862,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.permission_requested": {
@@ -4931,8 +4939,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.channel_reply": {
@@ -4955,8 +4962,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.model_set": {
@@ -4990,7 +4996,6 @@ function applyEvent(state, event) {
 					...state.agentRuntimeById,
 					[agentId]: next
 				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence),
 				agentIdBySessionId: nextAgentIdBySessionId
 			};
 		}
@@ -5008,8 +5013,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.context_saturation_changed": {
@@ -5025,8 +5029,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.resolution_changed": {
@@ -5045,8 +5048,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "agent.state_restored": {
@@ -5061,8 +5063,7 @@ function applyEvent(state, event) {
 				agentRuntimeById: {
 					...state.agentRuntimeById,
 					[agentId]: next
-				},
-				agentsById: bumpRuntimeSnapshotSequence(state.agentsById, agentId, event.sequence)
+				}
 			};
 		}
 		case "activity.entry": {
@@ -6073,6 +6074,170 @@ const FeatureRegistryEntry = effect.Schema.Struct({
 	tags: effect.Schema.Array(effect.Schema.String)
 });
 //#endregion
+//#region src/harness-capabilities.ts
+const HARNESS_CAPABILITY_KEYS = [
+	"contextChannel",
+	"initialPromptMustLand",
+	"stopRuntimeOnStartFailure",
+	"resumeContractMustLand",
+	"reapsPrivateDaemonOnStop",
+	"attachmentDelivery",
+	"nativeManualCompact",
+	"paneInputGuard",
+	"transcriptDeliveryReceipt",
+	"hostEffortFlag",
+	"binaryLabel",
+	"installHint",
+	"binaryConfigKey",
+	"launchPreflight",
+	"workspaceResolution",
+	"correlatesBySessionId"
+];
+const CLAUDE_CODE_CAPABILITIES = {
+	contextChannel: "append-system-prompt-file",
+	initialPromptMustLand: false,
+	stopRuntimeOnStartFailure: false,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "native",
+	nativeManualCompact: true,
+	paneInputGuard: true,
+	transcriptDeliveryReceipt: true,
+	hostEffortFlag: false,
+	binaryLabel: "Claude Code",
+	installHint: "curl -fsSL https://claude.ai/install.sh | bash",
+	binaryConfigKey: null,
+	launchPreflight: "claude-code-model-minimum",
+	workspaceResolution: "claude-project-hash",
+	correlatesBySessionId: false
+};
+const OHMYPI_CAPABILITIES = {
+	contextChannel: "append-system-prompt",
+	initialPromptMustLand: false,
+	stopRuntimeOnStartFailure: false,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "OhMyPi",
+	installHint: null,
+	binaryConfigKey: null,
+	launchPreflight: null,
+	workspaceResolution: "first-message-only",
+	correlatesBySessionId: true
+};
+const CODEX_CAPABILITIES = {
+	contextChannel: "developer_instructions",
+	initialPromptMustLand: false,
+	stopRuntimeOnStartFailure: false,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "Codex CLI",
+	installHint: null,
+	binaryConfigKey: null,
+	launchPreflight: null,
+	workspaceResolution: "agent-dir",
+	correlatesBySessionId: true
+};
+const ACP_CAPABILITIES = {
+	contextChannel: "acp-initial-context",
+	initialPromptMustLand: true,
+	stopRuntimeOnStartFailure: true,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "Kimi Code CLI",
+	installHint: null,
+	binaryConfigKey: "acp.kimi.binaryPath",
+	launchPreflight: null,
+	workspaceResolution: "agent-dir",
+	correlatesBySessionId: true
+};
+const KIMI_CODE_CAPABILITIES = {
+	contextChannel: "initial-message-envelope",
+	initialPromptMustLand: true,
+	stopRuntimeOnStartFailure: true,
+	resumeContractMustLand: true,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "Kimi Code CLI",
+	installHint: null,
+	binaryConfigKey: "kimiCode.binaryPath",
+	launchPreflight: null,
+	workspaceResolution: "first-message-only",
+	correlatesBySessionId: true
+};
+const OPENCODE_CAPABILITIES = {
+	contextChannel: "acp-initial-context",
+	initialPromptMustLand: true,
+	stopRuntimeOnStartFailure: true,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: true,
+	binaryLabel: "OpenCode",
+	installHint: null,
+	binaryConfigKey: null,
+	launchPreflight: null,
+	workspaceResolution: "agent-dir",
+	correlatesBySessionId: true
+};
+const MUSE_CAPABILITIES = {
+	contextChannel: "append-system-prompt-file",
+	initialPromptMustLand: false,
+	stopRuntimeOnStartFailure: true,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: false,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "Muse Code",
+	installHint: null,
+	binaryConfigKey: null,
+	launchPreflight: null,
+	workspaceResolution: "first-message-only",
+	correlatesBySessionId: true
+};
+const PRIME_AGENT_CAPABILITIES = {
+	contextChannel: "prime-agent-append-system-prompt",
+	initialPromptMustLand: true,
+	stopRuntimeOnStartFailure: true,
+	resumeContractMustLand: false,
+	reapsPrivateDaemonOnStop: true,
+	attachmentDelivery: "inline-paths",
+	nativeManualCompact: false,
+	paneInputGuard: false,
+	transcriptDeliveryReceipt: false,
+	hostEffortFlag: false,
+	binaryLabel: "Prime Agent",
+	installHint: null,
+	binaryConfigKey: null,
+	launchPreflight: null,
+	workspaceResolution: "first-message-only",
+	correlatesBySessionId: true
+};
+//#endregion
 //#region src/harness-behavior.ts
 const AGENT_SESSION_PREFIXES = [
 	"agent-",
@@ -6088,6 +6253,7 @@ function isAgentSessionName(name) {
 }
 const CLAUDE_CODE_BEHAVIOR = {
 	displayName: "Claude Code",
+	capabilities: CLAUDE_CODE_CAPABILITIES,
 	nativeCommands: [
 		{
 			name: "/model",
@@ -6132,6 +6298,7 @@ const CLAUDE_CODE_BEHAVIOR = {
 };
 const OHMYPI_BEHAVIOR = {
 	displayName: "Pi",
+	capabilities: OHMYPI_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "omp",
 	processNames: ["omp"],
@@ -6161,6 +6328,7 @@ const OHMYPI_BEHAVIOR = {
 };
 const CODEX_BEHAVIOR = {
 	displayName: "Codex",
+	capabilities: CODEX_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "codex",
 	processNames: ["codex"],
@@ -6184,6 +6352,7 @@ const CODEX_BEHAVIOR = {
 };
 const ACP_BEHAVIOR = {
 	displayName: "ACP",
+	capabilities: ACP_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "acp-host",
 	processNames: ["acp-host", "kimi"],
@@ -6207,6 +6376,7 @@ const ACP_BEHAVIOR = {
 };
 const KIMI_CODE_BEHAVIOR = {
 	displayName: "Kimi Code",
+	capabilities: KIMI_CODE_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "kimi",
 	processNames: ["kimi"],
@@ -6231,12 +6401,14 @@ const KIMI_CODE_BEHAVIOR = {
 const OPENCODE_BEHAVIOR = {
 	...ACP_BEHAVIOR,
 	displayName: "OpenCode",
+	capabilities: OPENCODE_CAPABILITIES,
 	contextLayerKind: "opencode",
 	executableName: "opencode",
 	processNames: ["acp-host", "opencode"]
 };
 const MUSE_BEHAVIOR = {
 	displayName: "Muse Code",
+	capabilities: MUSE_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "muse",
 	processNames: ["muse", "muse-bin"],
@@ -6266,6 +6438,7 @@ const MUSE_BEHAVIOR = {
 };
 const PRIME_AGENT_BEHAVIOR = {
 	displayName: "Prime Agent",
+	capabilities: PRIME_AGENT_CAPABILITIES,
 	nativeCommands: [],
 	executableName: "prime-agent",
 	processNames: ["prime-agent"],
@@ -6297,15 +6470,18 @@ const BEHAVIORS = {
 	muse: MUSE_BEHAVIOR,
 	"prime-agent": PRIME_AGENT_BEHAVIOR
 };
+const LEGACY_PI_HARNESS = "pi";
+/** True for the legacy stored harness alias `pi` (PAN-1989), which now means ohmypi. */
+function isLegacyPiHarnessName(raw) {
+	return raw === LEGACY_PI_HARNESS;
+}
+/** Map a stored or requested harness string to a RuntimeName; legacy `pi` → `ohmypi`; anything else → null. */
+function normalizeHarnessName(raw) {
+	if (isLegacyPiHarnessName(raw)) return "ohmypi";
+	return typeof raw === "string" && KNOWN_HARNESSES.has(raw) ? raw : null;
+}
 function getHarnessBehavior(harness) {
-	if (harness === "ohmypi" || harness === "pi") return OHMYPI_BEHAVIOR;
-	if (harness === "codex") return CODEX_BEHAVIOR;
-	if (harness === "opencode") return OPENCODE_BEHAVIOR;
-	if (harness === "acp") return ACP_BEHAVIOR;
-	if (harness === "kimi-code") return KIMI_CODE_BEHAVIOR;
-	if (harness === "muse") return MUSE_BEHAVIOR;
-	if (harness === "prime-agent") return PRIME_AGENT_BEHAVIOR;
-	return CLAUDE_CODE_BEHAVIOR;
+	return BEHAVIORS[normalizeHarnessName(harness) ?? "claude-code"];
 }
 function getRuntimeBehavior(runtime) {
 	return BEHAVIORS[runtime];
@@ -6624,7 +6800,8 @@ const TELEMETRY_EVENT_CATALOG = {
 		fork_intent: "fork_kind",
 		fork_mode: "fork_kind",
 		fast_summary: "boolean",
-		launch_harness: "harness"
+		launch_harness: "harness",
+		fresh_start: "boolean"
 	},
 	plan_approved: { subject_kind: "decision_subject" },
 	plan_changes_requested: { subject_kind: "decision_subject" },
@@ -8143,6 +8320,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Create and launch the new conversation without sending the kickoff; start it with Send in the dashboard or pan handoff start <conv>",
 				"required": false,
 				"valueHint": null
+			},
+			{
+				"flags": "--fresh",
+				"description": "Start a clean conversation: no handoff document, no summary, no parent link; the focus is its first message. Project, cwd, model and effort still default from the source",
+				"required": false,
+				"valueHint": null
 			}
 		],
 		"aliases": [],
@@ -10897,6 +11080,328 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Observation"
 	},
+	{
+		"id": "pan-memory-show",
+		"path": ["memory", "show"],
+		"display": "/pan memory show",
+		"description": "Print a curated memory fact",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--project <key>",
+				"description": "Project key (defaults to the project owning the cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--user",
+				"description": "Read from the operator store (travels with you; synced when set up)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--machine",
+				"description": "Read from the machine store (this machine only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--here",
+				"description": "Read from the cwd checkout's store instead of the primary checkout",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-list",
+		"path": ["memory", "list"],
+		"display": "/pan memory list",
+		"description": "List curated memory facts",
+		"args": [],
+		"options": [
+			{
+				"flags": "--type <type>",
+				"description": "Filter by fact type (feedback|project|reference|user)",
+				"required": true,
+				"valueHint": "type"
+			},
+			{
+				"flags": "--query <q>",
+				"description": "Filter by a fact-matching query (see pan memory search)",
+				"required": true,
+				"valueHint": "q"
+			},
+			{
+				"flags": "--review",
+				"description": "Show only facts carrying a review marker (default: active facts only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--project <key>",
+				"description": "Project key (defaults to the project owning the cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--user",
+				"description": "List the operator store (travels with you; synced when set up)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--machine",
+				"description": "List the machine store (this machine only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--here",
+				"description": "List the cwd checkout's store instead of the primary checkout",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-add",
+		"path": ["memory", "add"],
+		"display": "/pan memory add",
+		"description": "Add a curated memory fact",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--type <type>",
+				"description": "Fact type (feedback|project|reference|user)",
+				"required": true,
+				"valueHint": "type"
+			},
+			{
+				"flags": "--description <text>",
+				"description": "One-line index description (<= 200 chars)",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--title <text>",
+				"description": "Fact title (defaults to the id, dashes as spaces, capitalized)",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--body <text>",
+				"description": "Fact body",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--body-file <path>",
+				"description": "Read the fact body from a file",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--tags <a,b>",
+				"description": "Comma-separated tags",
+				"required": true,
+				"valueHint": "a,b"
+			},
+			{
+				"flags": "--project <key>",
+				"description": "Project key (defaults to the project owning the cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--user",
+				"description": "Write to the operator store (travels with you; synced when set up)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--machine",
+				"description": "Write to the machine store (this machine only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-edit",
+		"path": ["memory", "edit"],
+		"display": "/pan memory edit",
+		"description": "Edit a curated memory fact",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--type <type>",
+				"description": "Fact type (feedback|project|reference|user)",
+				"required": true,
+				"valueHint": "type"
+			},
+			{
+				"flags": "--title <text>",
+				"description": "Fact title",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--description <text>",
+				"description": "One-line index description (<= 200 chars)",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--body <text>",
+				"description": "Fact body",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--body-file <path>",
+				"description": "Read the fact body from a file",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--tags <a,b>",
+				"description": "Comma-separated tags",
+				"required": true,
+				"valueHint": "a,b"
+			},
+			{
+				"flags": "--clear-review",
+				"description": "Remove the review marker, re-activating the fact",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--project <key>",
+				"description": "Project key (defaults to the project owning the cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--user",
+				"description": "Edit the operator store (travels with you; synced when set up)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--machine",
+				"description": "Edit the machine store (this machine only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-retire",
+		"path": ["memory", "retire"],
+		"display": "/pan memory retire",
+		"description": "Remove a curated memory fact (git history is the archive)",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--project <key>",
+				"description": "Project key (defaults to the project owning the cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--user",
+				"description": "Retire from the operator store (travels with you; synced when set up)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--machine",
+				"description": "Retire from the machine store (this machine only)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-sync",
+		"path": ["memory", "sync"],
+		"display": "/pan memory sync",
+		"description": "Sync the operator memory store with your private git remote",
+		"args": [],
+		"options": [
+			{
+				"flags": "--setup <git-url>",
+				"description": "Turn on sync: use this private git repository as the remote, then sync",
+				"required": true,
+				"valueHint": "git-url"
+			},
+			{
+				"flags": "--status",
+				"description": "Show sync state without touching the network",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
 	{
 		"id": "pan-briefing",
 		"path": ["briefing"],
@@ -15799,6 +16304,83 @@ function laneActivityOf(row, now) {
 	return "stopped";
 }
 //#endregion
+//#region src/conversation-window.ts
+/**
+* Conversation window contract shared by the dashboard server and the
+* frontend (PAN-4558). A cold open carries only the newest slice of a
+* transcript; older history is paged in by cursor. The constants bound every
+* open, and the timeline key gives entries one total order on both sides.
+*/
+/** Most timeline rows a window or page carries. */
+const CONVERSATION_WINDOW_MAX_ROWS = 75;
+/** Most encoded entry bytes a window carries (960 KiB, leaving 64 KiB for metadata). */
+const CONVERSATION_WINDOW_MAX_BYTES = 983040;
+/** Whole-payload ceiling for an initial HTTP body or first WS event. */
+const CONVERSATION_PAYLOAD_BUDGET_BYTES = 1048576;
+/** Default `limit` for a paged read. */
+const CONVERSATION_PAGE_DEFAULT_LIMIT = 75;
+/** Largest `limit` a paged read accepts; larger values clamp to it. */
+const CONVERSATION_PAGE_MAX_LIMIT = 200;
+/** A tool `result` (or `detail`/`toolInput` string) above this many UTF-8 bytes leaves the wire. */
+const TOOL_BODY_INLINE_MAX_BYTES = 4096;
+/** Characters kept from an oversized `detail`/`toolInput` string. */
+const TOOL_BODY_PREVIEW_CHARS = 512;
+/** Most open entry ids a resume may name. */
+const RESUME_OPEN_IDS_MAX = 200;
+/** Most open tool calls pinned into a window beyond its contiguous slice. */
+const WINDOW_PINNED_OPEN_TOOLS_MAX = 10;
+function timelineKeyOfMessage(m) {
+	return [
+		m.createdAt,
+		m.sequence ?? 0,
+		0,
+		m.id
+	];
+}
+function timelineKeyOfWork(e) {
+	return [
+		e.createdAt,
+		e.sequence ?? 0,
+		1,
+		e.id
+	];
+}
+function compareStrings(a, b) {
+	return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Total order: createdAt (string compare), then sequence, then message before work, then id. */
+function compareTimelineKeys(a, b) {
+	return compareStrings(a[0], b[0]) || a[1] - b[1] || a[2] - b[2] || compareStrings(a[3], b[3]);
+}
+function encodeTimelineCursor(key) {
+	return JSON.stringify(key);
+}
+/** Returns null for anything that is not an encoded 4-tuple of string, finite number, 0|1, string. */
+function decodeTimelineCursor(cursor) {
+	let value;
+	try {
+		value = JSON.parse(cursor);
+	} catch {
+		return null;
+	}
+	if (!Array.isArray(value) || value.length !== 4) return null;
+	const [createdAt, sequence, kindRank, id] = value;
+	if (typeof createdAt !== "string") return null;
+	if (typeof sequence !== "number" || !Number.isFinite(sequence)) return null;
+	if (kindRank !== 0 && kindRank !== 1) return null;
+	if (typeof id !== "string") return null;
+	return [
+		createdAt,
+		sequence,
+		kindRank,
+		id
+	];
+}
+/** A tool entry has a result when it carries one inline or the wire projection elided it. */
+function hasToolResult(e) {
+	return !!e.result || (e.resultBytes ?? 0) > 0;
+}
+//#endregion
 //#region src/environment.ts
 /** Wire protocol version a client and server must agree on. */
 const ENVIRONMENT_PROTOCOL_VERSION = 1;
@@ -15841,6 +16423,7 @@ function isProtocolCompatible(descriptor, clientProtocolVersion) {
 }
 //#endregion
 exports.ACP_BEHAVIOR = ACP_BEHAVIOR;
+exports.ACP_CAPABILITIES = ACP_CAPABILITIES;
 exports.AGENT_ROLES = AGENT_ROLES;
 exports.Activity = Activity;
 exports.ActivityDetailedEvent = ActivityDetailedEvent;
@@ -15907,7 +16490,9 @@ exports.BackendPaneRemovedEvent = BackendPaneRemovedEvent;
 exports.BeadsFreshnessChangedEvent = BeadsFreshnessChangedEvent;
 exports.CHANNEL_REPLY_KIND_VALUES = CHANNEL_REPLY_KIND_VALUES;
 exports.CLAUDE_CODE_BEHAVIOR = CLAUDE_CODE_BEHAVIOR;
+exports.CLAUDE_CODE_CAPABILITIES = CLAUDE_CODE_CAPABILITIES;
 exports.CODEX_BEHAVIOR = CODEX_BEHAVIOR;
+exports.CODEX_CAPABILITIES = CODEX_CAPABILITIES;
 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;
@@ -15915,6 +16500,11 @@ exports.COMPOSER_COMMAND_MANIFEST = COMPOSER_COMMAND_MANIFEST;
 exports.COMPOSER_COMMAND_VARIANTS = COMPOSER_COMMAND_VARIANTS;
 exports.CONTEXT_LAYER_KINDS = CONTEXT_LAYER_KINDS;
 exports.CONTEXT_PREVIEW_HARNESSES = CONTEXT_PREVIEW_HARNESSES;
+exports.CONVERSATION_PAGE_DEFAULT_LIMIT = CONVERSATION_PAGE_DEFAULT_LIMIT;
+exports.CONVERSATION_PAGE_MAX_LIMIT = CONVERSATION_PAGE_MAX_LIMIT;
+exports.CONVERSATION_PAYLOAD_BUDGET_BYTES = CONVERSATION_PAYLOAD_BUDGET_BYTES;
+exports.CONVERSATION_WINDOW_MAX_BYTES = CONVERSATION_WINDOW_MAX_BYTES;
+exports.CONVERSATION_WINDOW_MAX_ROWS = CONVERSATION_WINDOW_MAX_ROWS;
 exports.ChannelPermissionRequestSnapshot = ChannelPermissionRequestSnapshot;
 exports.ChannelReplyArtifactRef = ChannelReplyArtifactRef;
 exports.ChannelReplyKind = ChannelReplyKind;
@@ -15949,7 +16539,9 @@ exports.ConversationPermissionChangedEvent = ConversationPermissionChangedEvent;
 exports.ConversationPullRequests = ConversationPullRequests;
 exports.ConversationPullRequestsChangedEvent = ConversationPullRequestsChangedEvent;
 exports.ConversationResponse = ConversationResponse;
+exports.ConversationResume = ConversationResume;
 exports.ConversationTitleChangedEvent = ConversationTitleChangedEvent;
+exports.ConversationWindow = ConversationWindow;
 exports.CostEventRecordedEvent = CostEventRecordedEvent;
 exports.DEFAULT_EFFORT = DEFAULT_EFFORT;
 exports.DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE = DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE;
@@ -16058,6 +16650,7 @@ exports.GitHubQuotaUsage = GitHubQuotaUsage;
 exports.GitHubRateLimitKind = GitHubRateLimitKind;
 exports.GlobalContextLayerRecord = GlobalContextLayerRecord;
 exports.GlobalContextLayerTarget = GlobalContextLayerTarget;
+exports.HARNESS_CAPABILITY_KEYS = HARNESS_CAPABILITY_KEYS;
 exports.HOOK_INVENTORY = HOOK_INVENTORY;
 exports.HealthReason = HealthReason;
 exports.HealthState = HealthState;
@@ -16080,6 +16673,7 @@ exports.IssuesDeltaEvent = IssuesDeltaEvent;
 exports.IssuesSnapshotEvent = IssuesSnapshotEvent;
 exports.IssuesUpdatedEvent = IssuesUpdatedEvent;
 exports.KIMI_CODE_BEHAVIOR = KIMI_CODE_BEHAVIOR;
+exports.KIMI_CODE_CAPABILITIES = KIMI_CODE_CAPABILITIES;
 exports.KNOWN_HARNESSES = KNOWN_HARNESSES;
 exports.LANE_STARTING_GRACE_MS = LANE_STARTING_GRACE_MS;
 exports.LegacySystemHealthSummary = LegacySystemHealthSummary;
@@ -16096,6 +16690,7 @@ exports.MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH = MAX_CHANNEL_REPLY_ARTIFACT_URI_L
 exports.MAX_CHANNEL_REPLY_SUMMARY_LENGTH = MAX_CHANNEL_REPLY_SUMMARY_LENGTH;
 exports.MEMBERSHIP_UNAVAILABLE_REASONS = MEMBERSHIP_UNAVAILABLE_REASONS;
 exports.MUSE_BEHAVIOR = MUSE_BEHAVIOR;
+exports.MUSE_CAPABILITIES = MUSE_CAPABILITIES;
 exports.MemoryAgentRole = MemoryAgentRole;
 exports.MemoryHealthChangedEvent = MemoryHealthChangedEvent;
 exports.MemoryIdentity = MemoryIdentity;
@@ -16112,7 +16707,9 @@ exports.ModelOrigin = ModelOrigin;
 exports.ModelOriginEntry = ModelOriginEntry;
 exports.NON_ESSENTIAL_GITHUB_CALLERS = NON_ESSENTIAL_GITHUB_CALLERS;
 exports.OHMYPI_BEHAVIOR = OHMYPI_BEHAVIOR;
+exports.OHMYPI_CAPABILITIES = OHMYPI_CAPABILITIES;
 exports.OPENCODE_BEHAVIOR = OPENCODE_BEHAVIOR;
+exports.OPENCODE_CAPABILITIES = OPENCODE_CAPABILITIES;
 exports.OVERDECK_AGENT_PROTOCOL_VERSION = OVERDECK_AGENT_PROTOCOL_VERSION;
 exports.OVERDECK_DASHBOARD_PROTOCOL_VERSION = OVERDECK_DASHBOARD_PROTOCOL_VERSION;
 exports.OpenInEditorInput = OpenInEditorInput;
@@ -16126,6 +16723,7 @@ exports.OrderBookSettings = OrderBookSettings;
 exports.OrderBookStatus = OrderBookStatus;
 exports.PIPELINE_MEMBERSHIP_LOADING_CODE = PIPELINE_MEMBERSHIP_LOADING_CODE;
 exports.PRIME_AGENT_BEHAVIOR = PRIME_AGENT_BEHAVIOR;
+exports.PRIME_AGENT_CAPABILITIES = PRIME_AGENT_CAPABILITIES;
 exports.PanRpcError = PanRpcError;
 exports.PanRpcGroup = PanRpcGroup;
 exports.PendingTurn = PendingTurn;
@@ -16161,6 +16759,7 @@ exports.PullRequestLinkSource = PullRequestLinkSource;
 exports.PullRequestLinkedConversation = PullRequestLinkedConversation;
 exports.PullRequestSnapshot = PullRequestSnapshot;
 exports.PullRequestState = PullRequestState;
+exports.RESUME_OPEN_IDS_MAX = RESUME_OPEN_IDS_MAX;
 exports.RagDecision = RagDecision;
 exports.RagDecisionSource = RagDecisionSource;
 exports.ReadFileAtPathInput = ReadFileAtPathInput;
@@ -16169,7 +16768,9 @@ exports.ReadFileAtPathRpc = ReadFileAtPathRpc;
 exports.ReadWorkspaceFileInput = ReadWorkspaceFileInput;
 exports.ReadWorkspaceFileResult = ReadWorkspaceFileResult;
 exports.ReadWorkspaceFileRpc = ReadWorkspaceFileRpc;
+exports.ReplayEventsResult = ReplayEventsResult;
 exports.ReplayEventsRpc = ReplayEventsRpc;
+exports.ReplayTooFarBehind = ReplayTooFarBehind;
 exports.ResetMarker = ResetMarker;
 exports.ResetMarkerScope = ResetMarkerScope;
 exports.ResizeTerminalRpc = ResizeTerminalRpc;
@@ -16249,6 +16850,8 @@ exports.TELEMETRY_EVENT_CATALOG = TELEMETRY_EVENT_CATALOG;
 exports.TELEMETRY_EVENT_NAMES = TELEMETRY_EVENT_NAMES;
 exports.TELEMETRY_PROPERTY_DOMAINS = TELEMETRY_PROPERTY_DOMAINS;
 exports.TERMINAL_BACKEND_NAMES = TERMINAL_BACKEND_NAMES;
+exports.TOOL_BODY_INLINE_MAX_BYTES = TOOL_BODY_INLINE_MAX_BYTES;
+exports.TOOL_BODY_PREVIEW_CHARS = TOOL_BODY_PREVIEW_CHARS;
 exports.TerminalCloseRpc = TerminalCloseRpc;
 exports.TerminalOpenRpc = TerminalOpenRpc;
 exports.TerminalOutput = TerminalOutput;
@@ -16261,6 +16864,7 @@ exports.TickMarkerPhase = TickMarkerPhase;
 exports.TurnDiffFileChange = TurnDiffFileChange;
 exports.TurnDiffSummary = TurnDiffSummary;
 exports.TurnEndAssessment = TurnEndAssessment;
+exports.WINDOW_PINNED_OPEN_TOOLS_MAX = WINDOW_PINNED_OPEN_TOOLS_MAX;
 exports.WIRED_HOOK_INVENTORY = WIRED_HOOK_INVENTORY;
 exports.WIRED_HOOK_NAMES = WIRED_HOOK_NAMES;
 exports.WS_METHODS = WS_METHODS;
@@ -16288,16 +16892,20 @@ exports.canonicalPullRequestUrl = canonicalPullRequestUrl;
 exports.companionTerminalKindFor = companionTerminalKindFor;
 exports.compareEffort = compareEffort;
 exports.compareIssueIds = compareIssueIds;
+exports.compareTimelineKeys = compareTimelineKeys;
 exports.createIssueDelta = createIssueDelta;
 exports.decodeFlywheelDerivedStatus = decodeFlywheelDerivedStatus;
 exports.decodeFlywheelStats = decodeFlywheelStats;
+exports.decodeTimelineCursor = decodeTimelineCursor;
 exports.deriveProjectCi = deriveProjectCi;
 exports.encodeFlywheelStats = encodeFlywheelStats;
+exports.encodeTimelineCursor = encodeTimelineCursor;
 exports.getHarness = getHarness;
 exports.getHarnessBehavior = getHarnessBehavior;
 exports.getMaxMemoryObservationsPerIssue = getMaxMemoryObservationsPerIssue;
 exports.getMaxTurnDiffSummariesPerAgent = getMaxTurnDiffSummariesPerAgent;
 exports.getRuntimeBehavior = getRuntimeBehavior;
+exports.hasToolResult = hasToolResult;
 exports.indexPanesByAgentKey = indexPanesByAgentKey;
 exports.isAgentRole = isAgentRole;
 exports.isAgentSessionName = isAgentSessionName;
@@ -16306,12 +16914,14 @@ exports.isConfiguredPullRequestRepo = isConfiguredPullRequestRepo;
 exports.isEffortLevel = isEffortLevel;
 exports.isIssueAttention = isIssueAttention;
 exports.isIssueState = isIssueState;
+exports.isLegacyPiHarnessName = isLegacyPiHarnessName;
 exports.isProtocolCompatible = isProtocolCompatible;
 exports.isSingletonConversation = isSingletonConversation;
 exports.isTerminalBackendName = isTerminalBackendName;
 exports.isTerminalTurnDiffSummaryStatus = isTerminalTurnDiffSummaryStatus;
 exports.laneActivityOf = laneActivityOf;
 exports.normalizeChannelReplyPayload = normalizeChannelReplyPayload;
+exports.normalizeHarnessName = normalizeHarnessName;
 exports.omitTurnDiffSummariesForAgent = omitTurnDiffSummariesForAgent;
 exports.paneAgentKey = paneAgentKey;
 exports.parsePullRequestRef = parsePullRequestRef;
@@ -16319,6 +16929,8 @@ exports.projectLegacySystemHealthSummary = projectLegacySystemHealthSummary;
 exports.repoFromRemoteUrl = repoFromRemoteUrl;
 exports.resolveEffectivePullRequest = resolveEffectivePullRequest;
 exports.syncSnapshot = syncSnapshot;
+exports.timelineKeyOfMessage = timelineKeyOfMessage;
+exports.timelineKeyOfWork = timelineKeyOfWork;
 exports.trimMemoryObservations = trimMemoryObservations;
 exports.trimTurnDiffSummaries = trimTurnDiffSummaries;
 exports.withPaneLivenessAlias = withPaneLivenessAlias;