@overdeck/contracts 0.64.0 → 0.65.0

package/dist/index.mjs

@@ -3195,6 +3195,30 @@ const OpenInEditorInput = 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 = 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",
@@ -3280,6 +3304,8 @@ const ContextUsage = Schema.Struct({
 	maxObservedInputTokens: Schema.optional(Schema.Number),
 	/** Model the most recent assistant turn ran under (from JSONL). */
 	lastModel: Schema.optional(Schema.NullOr(Schema.String)),
+	/** PAN-4255: effort observed in the transcript (assistant `effort` or an /effort confirmation). Claude Code only. */
+	lastEffort: Schema.optional(Schema.NullOr(Schema.String)),
 	/** ISO timestamp of the most recent assistant turn. */
 	lastTurnAt: Schema.optional(Schema.NullOr(Schema.String))
 });
@@ -3350,7 +3376,14 @@ const ConversationResponse = Schema.Struct({
 	proposedPlan: Schema.optional(ProposedPlan),
 	compactBoundaries: Schema.optional(Schema.Array(CompactBoundary)),
 	contextUsage: Schema.optional(Schema.NullOr(ContextUsage)),
-	subagents: Schema.optional(Schema.Array(SubagentSummary))
+	subagents: Schema.optional(Schema.Array(SubagentSummary)),
+	/** PAN-4255: effort read from the agent's transcript (claude-code only). */
+	observedEffort: Schema.optional(Schema.NullOr(EffortLevelSchema)),
+	/** PAN-4255: the effort the agent was launched/pinned with and its EffortSource layer. */
+	effortResolution: Schema.optional(Schema.NullOr(Schema.Struct({
+		effort: EffortLevelSchema,
+		source: Schema.String
+	})))
 });
 const ConversationEvent = Schema.Union([
 	Schema.Struct({
@@ -3791,6 +3824,39 @@ const GetConversationStatsRpc = Rpc.make(WS_METHODS.getConversationStats, {
 /** All Overdeck WebSocket RPC methods */
 const PanRpcGroup = 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 = [];
@@ -3906,14 +3972,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
@@ -3946,16 +4004,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: {},
@@ -5287,30 +5346,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 = 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 = Schema.String.check(Schema.isPattern(/^RUN-\d+$/));
 const FlywheelHttpUrl = Schema.String.check(Schema.isPattern(/^https?:\/\/\S+$/i));
@@ -6977,7 +7012,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--adapter <adapter>",
-				"description": "plain or claude-plugin",
+				"description": "plain, claude-plugin, or deft-readonly",
 				"required": true,
 				"valueHint": "adapter"
 			},
@@ -7098,6 +7133,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"],
@@ -7166,6 +7341,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"],
@@ -7300,6 +7538,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"],
@@ -7424,7 +7681,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"
 			},
@@ -7538,6 +7795,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"],
@@ -7686,6 +7980,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",
@@ -7735,6 +8035,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)",
@@ -7794,6 +8100,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": [],
@@ -8634,6 +8958,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"
@@ -10950,6 +11279,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"],
@@ -11824,29 +12271,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"],
@@ -12844,6 +13268,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)",
@@ -12901,6 +13331,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",
@@ -13878,26 +14314,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"
 	},
@@ -14061,7 +14488,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": [
 			{
@@ -14766,6 +15193,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"],
@@ -15171,6 +15618,10 @@ const DirectoryEntry = Schema.Struct({
 	harness: Schema.String,
 	/** `unknown` when not known. */
 	model: Schema.String,
+	/** The launch effort from state.json, native agents only (PAN-4259). */
+	effort: Schema.optional(EffortLevelSchema),
+	/** Where `effort` came from (an EffortSource), native agents only. */
+	effortSource: Schema.optional(Schema.String),
 	state: DirectoryEntryState,
 	startedAt: Schema.NullOr(Schema.String),
 	lastActivityAt: Schema.NullOr(Schema.String),