@overdeck/contracts 0.64.0 → 0.65.0

package/dist/index.cjs

@@ -3220,6 +3220,30 @@ const OpenInEditorInput = effect.Schema.Struct({
 	editor: EditorIdSchema
 });
 //#endregion
+//#region src/effort.ts
+/**
+* Canonical reasoning-effort levels, end to end. `xhigh` was added in Opus 4.7
+* (between `high` and `max`); `max` predates it (Opus 4.6+/Sonnet 4.6). This is
+* the single source of truth for the enum — every other copy in the codebase
+* derives from it.
+*/
+const EFFORT_LEVELS = [
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+const DEFAULT_EFFORT = "high";
+const EffortLevelSchema = effect.Schema.Literals(EFFORT_LEVELS);
+function isEffortLevel(value) {
+	return typeof value === "string" && EFFORT_LEVELS.includes(value);
+}
+/** Compares two effort levels by rank; negative when `a` is lower than `b`. */
+function compareEffort(a, b) {
+	return EFFORT_LEVELS.indexOf(a) - EFFORT_LEVELS.indexOf(b);
+}
+//#endregion
 //#region src/rpc.ts
 const WS_METHODS = {
 	scanConversations: "pan.scanConversations",
@@ -3305,6 +3329,8 @@ const ContextUsage = effect.Schema.Struct({
 	maxObservedInputTokens: effect.Schema.optional(effect.Schema.Number),
 	/** Model the most recent assistant turn ran under (from JSONL). */
 	lastModel: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.String)),
+	/** PAN-4255: effort observed in the transcript (assistant `effort` or an /effort confirmation). Claude Code only. */
+	lastEffort: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.String)),
 	/** ISO timestamp of the most recent assistant turn. */
 	lastTurnAt: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.String))
 });
@@ -3375,7 +3401,14 @@ const ConversationResponse = effect.Schema.Struct({
 	proposedPlan: effect.Schema.optional(ProposedPlan),
 	compactBoundaries: effect.Schema.optional(effect.Schema.Array(CompactBoundary)),
 	contextUsage: effect.Schema.optional(effect.Schema.NullOr(ContextUsage)),
-	subagents: effect.Schema.optional(effect.Schema.Array(SubagentSummary))
+	subagents: effect.Schema.optional(effect.Schema.Array(SubagentSummary)),
+	/** PAN-4255: effort read from the agent's transcript (claude-code only). */
+	observedEffort: effect.Schema.optional(effect.Schema.NullOr(EffortLevelSchema)),
+	/** PAN-4255: the effort the agent was launched/pinned with and its EffortSource layer. */
+	effortResolution: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Struct({
+		effort: EffortLevelSchema,
+		source: effect.Schema.String
+	})))
 });
 const ConversationEvent = effect.Schema.Union([
 	effect.Schema.Struct({
@@ -3816,6 +3849,39 @@ const GetConversationStatsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.getConve
 /** All Overdeck WebSocket RPC methods */
 const PanRpcGroup = effect_unstable_rpc_RpcGroup.make(SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeTerminalRpc, SubscribeAgentOutputRpc, GetSnapshotRpc, ReplayEventsRpc, ReadWorkspaceFileRpc, ReadFileAtPathRpc, WriteFileAtPathRpc, ResolveFilePathExistsRpc, TerminalOpenRpc, TerminalWriteRpc, TerminalResizeRpc, TerminalCloseRpc, StartPlanningRpc, StartAgentRpc, DeepWipeRpc, SendTerminalInputRpc, ResizeTerminalRpc, SubscribeConversationMessagesRpc, SubscribeProjectSessionTreeRpc, ShellOpenInEditorRpc, GetAvailableEditorsRpc, ScanConversationsRpc, SearchConversationsRpc, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, GetSessionsFeedFacetsRpc, GetDiscoveredSessionRpc, EnrichSessionsRpc, EmbedSessionsRpc, GetConversationCostRpc, GetConversationCostByWorkspaceRpc, GetConversationStatsRpc);
 //#endregion
+//#region src/agent-runtime-merge.ts
+function defaultRuntimeSnapshot(agentId, timestamp, sequence) {
+	return {
+		id: agentId,
+		activity: "idle",
+		lastActivity: timestamp,
+		updatedAtSequence: sequence
+	};
+}
+/**
+* Merge a snapshot's runtime map into the client's, per agent. A freshly booted
+* server may serve an older or missing entry; a client entry with a strictly
+* newer `lastActivity` (or an equal stamp with a higher `updatedAtSequence`)
+* survives, and an agent the snapshot omits keeps its entry.
+*/
+function mergeSnapshotRuntimeById(current, incoming) {
+	if (!incoming) return { ...current };
+	const merged = { ...current };
+	for (const [agentId, next] of Object.entries(incoming)) {
+		const held = current[agentId];
+		merged[agentId] = held && heldIsNewer(held, next) ? held : next;
+	}
+	return merged;
+}
+/** Newer `lastActivity` wins; equal stamps fall to the higher `updatedAtSequence`. */
+function heldIsNewer(held, next) {
+	const heldAt = Date.parse(held.lastActivity);
+	const nextAt = Date.parse(next.lastActivity);
+	if (heldAt > nextAt) return true;
+	if (heldAt !== nextAt) return false;
+	return Number.isFinite(held.updatedAtSequence) && Number.isFinite(next.updatedAtSequence) && held.updatedAtSequence > next.updatedAtSequence;
+}
+//#endregion
 //#region src/issue-delta.ts
 function createIssueDelta(previous, next) {
 	const changes = [];
@@ -3931,14 +3997,6 @@ function removeAgentFromSessionIndex(agentIdBySessionId, agentId) {
 	for (const [sessionId, id] of Object.entries(agentIdBySessionId ?? {})) if (id !== agentId) next[sessionId] = id;
 	return next;
 }
-function defaultRuntimeSnapshot(agentId, timestamp, sequence) {
-	return {
-		id: agentId,
-		activity: "idle",
-		lastActivity: timestamp,
-		updatedAtSequence: sequence
-	};
-}
 /**
 * Bump runtimeSnapshotSequence on the corresponding AgentSnapshot (if present)
 * so low-frequency subscribers can cheaply detect a runtime change. No-op if
@@ -3971,16 +4029,17 @@ function syncSnapshot(state, snapshot) {
 		channelPermissionRequestIdsByAgentId[request.agentId] = [...existing, request.requestId];
 	}
 	const memory = snapshot.memory;
+	const agentRuntimeById = mergeSnapshotRuntimeById(state.agentRuntimeById, snapshot.agentRuntimeById);
 	const agentIdBySessionId = {};
 	for (const agent of snapshot.agents) if (agent.sessionId) agentIdBySessionId[agent.sessionId] = agent.id;
-	for (const [agentId, runtime] of Object.entries(snapshot.agentRuntimeById ?? {})) if (runtime.claudeSessionId) agentIdBySessionId[runtime.claudeSessionId] = agentId;
+	for (const [agentId, runtime] of Object.entries(agentRuntimeById)) if (runtime.claudeSessionId) agentIdBySessionId[runtime.claudeSessionId] = agentId;
 	return {
 		...state,
 		sequence: snapshot.sequence,
 		agentsById,
 		derivedIssueStateByIssueId,
 		backendPanesById,
-		agentRuntimeById: snapshot.agentRuntimeById ?? state.agentRuntimeById,
+		agentRuntimeById,
 		channelPermissionRequestsById,
 		channelPermissionRequestIdsByAgentId,
 		resolvedChannelPermissionDecisionsById: {},
@@ -5312,30 +5371,6 @@ function deriveProjectCi(record) {
 	};
 }
 //#endregion
-//#region src/effort.ts
-/**
-* Canonical reasoning-effort levels, end to end. `xhigh` was added in Opus 4.7
-* (between `high` and `max`); `max` predates it (Opus 4.6+/Sonnet 4.6). This is
-* the single source of truth for the enum — every other copy in the codebase
-* derives from it.
-*/
-const EFFORT_LEVELS = [
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
-];
-const DEFAULT_EFFORT = "high";
-const EffortLevelSchema = effect.Schema.Literals(EFFORT_LEVELS);
-function isEffortLevel(value) {
-	return typeof value === "string" && EFFORT_LEVELS.includes(value);
-}
-/** Compares two effort levels by rank; negative when `a` is lower than `b`. */
-function compareEffort(a, b) {
-	return EFFORT_LEVELS.indexOf(a) - EFFORT_LEVELS.indexOf(b);
-}
-//#endregion
 //#region src/flywheel.ts
 const FlywheelRunId = effect.Schema.String.check(effect.Schema.isPattern(/^RUN-\d+$/));
 const FlywheelHttpUrl = effect.Schema.String.check(effect.Schema.isPattern(/^https?:\/\/\S+$/i));
@@ -7002,7 +7037,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--adapter <adapter>",
-				"description": "plain or claude-plugin",
+				"description": "plain, claude-plugin, or deft-readonly",
 				"required": true,
 				"valueHint": "adapter"
 			},
@@ -7123,6 +7158,146 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Core"
 	},
+	{
+		"id": "pan-skills-pack-sageox",
+		"path": [
+			"skills",
+			"pack",
+			"sageox"
+		],
+		"display": "/pan skills pack sageox",
+		"description": "SageOx pack state and per-project upload opt-in (PAN-2444)",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-pack-sageox-status",
+		"path": [
+			"skills",
+			"pack",
+			"sageox",
+			"status"
+		],
+		"display": "/pan skills pack sageox status",
+		"description": "Show, per project, the sageox pack state and the upload state",
+		"args": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Only this project",
+			"required": true,
+			"valueHint": "key"
+		}, {
+			"flags": "--json",
+			"description": "Output as JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-pack-sageox-upload",
+		"path": [
+			"skills",
+			"pack",
+			"sageox",
+			"upload"
+		],
+		"display": "/pan skills pack sageox upload",
+		"description": "Turn SageOx uploads on or off for a project (off by default)",
+		"args": [{
+			"name": "state",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Project key",
+			"required": true,
+			"valueHint": "key"
+		}],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-deft",
+		"path": ["skills", "deft"],
+		"display": "/pan skills deft",
+		"description": "Deft Directive detection, ownership report, and managed mode",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-deft-status",
+		"path": [
+			"skills",
+			"deft",
+			"status"
+		],
+		"display": "/pan skills deft status",
+		"description": "Show Directive detection, the deft pack, the skill map, managed mode, and the ownership report",
+		"args": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Registered project (default: the current repo)",
+			"required": true,
+			"valueHint": "key"
+		}, {
+			"flags": "--json",
+			"description": "Output as JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-deft-enable",
+		"path": [
+			"skills",
+			"deft",
+			"enable"
+		],
+		"display": "/pan skills deft enable",
+		"description": "Enable Deft managed mode for a Directive project after showing the ownership plan",
+		"args": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Registered project",
+			"required": true,
+			"valueHint": "key"
+		}, {
+			"flags": "--yes",
+			"description": "Accept the printed plan without asking",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Core"
+	},
+	{
+		"id": "pan-skills-deft-disable",
+		"path": [
+			"skills",
+			"deft",
+			"disable"
+		],
+		"display": "/pan skills deft disable",
+		"description": "Disable Deft managed mode; project files are untouched",
+		"args": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
+		"aliases": [],
+		"category": "Core"
+	},
 	{
 		"id": "pan-pair",
 		"path": ["pair"],
@@ -7191,6 +7366,69 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "CLI"
 	},
+	{
+		"id": "pan-token",
+		"path": ["token"],
+		"display": "/pan token",
+		"description": "Create, list or revoke scoped access tokens (see configuration/remote-access.mdx)",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-token-create",
+		"path": ["token", "create"],
+		"display": "/pan token create",
+		"description": "Create a scoped access token and print it once",
+		"args": [{
+			"name": "name",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--scopes <list>",
+			"description": "Comma-separated scopes: read:events, read:state, read:conversations, tell, operate, admin",
+			"required": true,
+			"valueHint": "list"
+		}, {
+			"flags": "--json",
+			"description": "Print { id, name, scopes, token } as JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-token-list",
+		"path": ["token", "list"],
+		"display": "/pan token list",
+		"description": "List access tokens with scopes and created, last-used and revoked times",
+		"args": [],
+		"options": [{
+			"flags": "--json",
+			"description": "Print the tokens as JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-token-revoke",
+		"path": ["token", "revoke"],
+		"display": "/pan token revoke",
+		"description": "Revoke an access token and close its live connections",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "CLI"
+	},
 	{
 		"id": "pan-issues",
 		"path": ["issues"],
@@ -7325,6 +7563,25 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Review"
 	},
+	{
+		"id": "pan-review-waive-test-removal",
+		"path": ["review", "waive-test-removal"],
+		"display": "/pan review waive-test-removal",
+		"description": "Operator-only: let a net test removal past the test-skip gate at the current head",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--reason <text>",
+			"description": "Why the removed tests are gone and nothing replaces them",
+			"required": true,
+			"valueHint": "text"
+		}],
+		"aliases": [],
+		"category": "Review"
+	},
 	{
 		"id": "pan-review-abort",
 		"path": ["review", "abort"],
@@ -7449,7 +7706,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--effort <level>",
-				"description": "Planning effort: low | medium | high",
+				"description": "Planning effort: low | medium | high | xhigh | max",
 				"required": true,
 				"valueHint": "level"
 			},
@@ -7563,6 +7820,43 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-ask",
+		"path": ["ask"],
+		"display": "/pan ask",
+		"description": "Ask the operator a blocking decision; it appears in the dashboard Needs-you",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "question",
+			"required": false,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--option <label>",
+				"description": "A choice the operator can pick (repeat 2-4 times)",
+				"required": true,
+				"valueHint": "label"
+			},
+			{
+				"flags": "--context <text>",
+				"description": "What you already tried or know, shown with the question",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--withdraw",
+				"description": "Close your open decision request (answered another way, or no longer needed)",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
 	{
 		"id": "pan-answer",
 		"path": ["answer"],
@@ -7711,6 +8005,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "model"
 			},
+			{
+				"flags": "--effort <level>",
+				"description": "Reasoning effort for the new conversation: low, medium, high, xhigh or max; defaults to the source conversation's effort",
+				"required": true,
+				"valueHint": "level"
+			},
 			{
 				"flags": "--cwd <path>",
 				"description": "Working directory for the summary-forked session",
@@ -7760,6 +8060,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "model"
 			},
+			{
+				"flags": "--effort <level>",
+				"description": "Reasoning effort for the new conversation: low, medium, high, xhigh or max; defaults to the source conversation's effort",
+				"required": true,
+				"valueHint": "level"
+			},
 			{
 				"flags": "--harness <harness>",
 				"description": "Ignored: harness is provider-default-only (PAN-1984)",
@@ -7819,6 +8125,24 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Ignored: author harness is provider-default-only (PAN-1984)",
 				"required": true,
 				"valueHint": "harness"
+			},
+			{
+				"flags": "--skill <name>",
+				"description": "Turn this skill on for the new conversation only (repeatable); a pack skill is <pack>/<skill>",
+				"required": true,
+				"valueHint": "name"
+			},
+			{
+				"flags": "--pack <id>",
+				"description": "Turn every skill of this cached skill pack on for the new conversation only (repeatable)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--hold",
+				"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
 			}
 		],
 		"aliases": [],
@@ -8659,6 +8983,11 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"description": "Print JSON",
 			"required": false,
 			"valueHint": null
+		}, {
+			"flags": "--on <refs...>",
+			"description": "Issues or PRs this item waits on (PAN-123, #45, owner/repo#45, PR URL); Overdeck wakes the agent when all have merged",
+			"required": true,
+			"valueHint": "refs..."
 		}],
 		"aliases": [],
 		"category": "Lifecycle"
@@ -10975,6 +11304,124 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Flywheel"
 	},
+	{
+		"id": "pan-models",
+		"path": ["models"],
+		"display": "/pan models",
+		"description": "Model settings: provider presets",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-models-preset",
+		"path": ["models", "preset"],
+		"display": "/pan models preset",
+		"description": "Apply eval-backed provider model presets (writes explicit values once; never auto-applies)",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-models-preset-list",
+		"path": [
+			"models",
+			"preset",
+			"list"
+		],
+		"display": "/pan models preset list",
+		"description": "List presets, their versions and what was last applied",
+		"args": [],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-models-preset-show",
+		"path": [
+			"models",
+			"preset",
+			"show"
+		],
+		"display": "/pan models preset show",
+		"description": "Show the per-setting diff a preset would make to config.yaml",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--json",
+			"description": "Print the plan JSON (same body as GET /api/model-presets/:id/plan)",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-models-preset-apply",
+		"path": [
+			"models",
+			"preset",
+			"apply"
+		],
+		"display": "/pan models preset apply",
+		"description": "Apply a preset: print the diff, confirm, then write only the changed settings",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--dry-run",
+				"description": "Print the diff and write nothing",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--yes",
+				"description": "Apply without the confirmation prompt",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Print JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
+	{
+		"id": "pan-models-preset-undo",
+		"path": [
+			"models",
+			"preset",
+			"undo"
+		],
+		"display": "/pan models preset undo",
+		"description": "Restore the values the last preset apply replaced",
+		"args": [],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "CLI"
+	},
 	{
 		"id": "pan-parked",
 		"path": ["parked"],
@@ -11849,29 +12296,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
-	{
-		"id": "pan-admin-tldr",
-		"path": ["admin", "tldr"],
-		"display": "/pan admin tldr",
-		"description": "TLDR daemon: status, start, stop, warm",
-		"args": [{
-			"name": "action",
-			"required": false,
-			"variadic": false
-		}, {
-			"name": "workspace",
-			"required": false,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--json",
-			"description": "Output as JSON",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-fpp",
 		"path": ["admin", "fpp"],
@@ -12869,6 +13293,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "harness"
 			},
+			{
+				"flags": "--effort <level>",
+				"description": "Reasoning effort: low | medium | high | xhigh | max (defaults to the item/plan metadata, then roles.worker.effort)",
+				"required": true,
+				"valueHint": "level"
+			},
 			{
 				"flags": "--shared",
 				"description": "Run the worker in the issue workspace instead of an item worktree (foreman/operator only; serial use)",
@@ -12926,6 +13356,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "harness"
 			},
+			{
+				"flags": "--effort <level>",
+				"description": "Reasoning effort: low | medium | high | xhigh | max (defaults to roles.worker.effort)",
+				"required": true,
+				"valueHint": "level"
+			},
 			{
 				"flags": "--read-only",
 				"description": "Run in the issue workspace with git writes blocked",
@@ -13903,26 +14339,17 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"display": "/pan status",
 		"description": "Show running agents",
 		"args": [],
-		"options": [
-			{
-				"flags": "--json",
-				"description": "Output as JSON",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--tldr",
-				"description": "Show TLDR index health across all workspaces",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--context",
-				"description": "Show context window usage % for each agent",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Output as JSON",
+			"required": false,
+			"valueHint": null
+		}, {
+			"flags": "--context",
+			"description": "Show context window usage % for each agent",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Core"
 	},
@@ -14086,7 +14513,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-restart",
 		"path": ["restart"],
 		"display": "/pan restart",
-		"description": "Restart a platform component (default: dashboard only — leaves CLIProxy, Traefik, TLDR running)",
+		"description": "Restart a platform component (default: dashboard only — leaves CLIProxy and Traefik running)",
 		"args": [],
 		"options": [
 			{
@@ -14791,6 +15218,26 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Data"
 	},
+	{
+		"id": "pan-cost-effort",
+		"path": ["cost", "effort"],
+		"display": "/pan cost effort",
+		"description": "Show costs grouped by reasoning effort",
+		"args": [],
+		"options": [{
+			"flags": "-i, --issue <issueId>",
+			"description": "Limit to one issue",
+			"required": true,
+			"valueHint": "issueId"
+		}, {
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Data"
+	},
 	{
 		"id": "pan-cost-budget",
 		"path": ["cost", "budget"],
@@ -15196,6 +15643,10 @@ const DirectoryEntry = effect.Schema.Struct({
 	harness: effect.Schema.String,
 	/** `unknown` when not known. */
 	model: effect.Schema.String,
+	/** The launch effort from state.json, native agents only (PAN-4259). */
+	effort: effect.Schema.optional(EffortLevelSchema),
+	/** Where `effort` came from (an EffortSource), native agents only. */
+	effortSource: effect.Schema.optional(effect.Schema.String),
 	state: DirectoryEntryState,
 	startedAt: effect.Schema.NullOr(effect.Schema.String),
 	lastActivityAt: effect.Schema.NullOr(effect.Schema.String),