pi-legion 3.0.3 → 4.0.0

package/src/shared/types.ts

@@ -17,36 +17,19 @@ export type AgentScope = "user" | "project" | "both";
 
 export type SystemPromptMode = "replace" | "append";
 
-/** Agent kinds parsed from role files; the RPC supervisor accepts only `pi`. */
-export const AGENT_KINDS = [
-	"pi",
-	"claude",
-	"codex",
-	"gemini",
-	"cursor",
-	"devin",
-	"agy",
-	"cline",
-	"omp",
-	"mastracode",
-	"opencode",
-	"copilot",
-	"kimi",
-	"kiro",
-	"droid",
-	"amp",
-	"grok",
-	"hermes",
-	"kilo",
-	"qodercli",
-	"qwen",
-	"maki",
-	"muse",
-] as const;
+/**
+ * Agent kinds accepted from role files, presets and overrides.
+ *
+ * v4 runs `pi` only. The field and the type stay (plumbing and `run.json`
+ * records depend on them), but a non-`pi` value is ignored at parse time and
+ * the role launches as `pi` — see `parseAgentDocument` / `parsePreset` /
+ * `parseAgentOverride`, which report the ignored value once.
+ */
+export const AGENT_KINDS = ["pi"] as const;
 
 export type AgentKind = (typeof AGENT_KINDS)[number];
 
-/** How Legion launches a child session: omit → `inprocess` (with automatic rpc fallback when the agent needs a worktree or `kind !== "pi"`). */
+/** How Legion launches a child session: omit → `inprocess` (with automatic rpc fallback when the agent needs a worktree). */
 export const SPAWN_MODES = ["rpc", "inprocess"] as const;
 export type SpawnMode = (typeof SPAWN_MODES)[number];
 
@@ -226,6 +209,8 @@ export interface ModelScopeViolation {
 
 /** Lifecycle state. Independent of execution outcome. */
 export type TaskState =
+	/** D3: name allocated, no ledger row and no session file yet (launch queue). */
+	| "queued"
 	| "launching"
 	| "working"
 	| "awaiting"
@@ -362,8 +347,6 @@ export interface ChildRecord {
 	/** Model actually started with (resolved + fallback). */
 	model?: string;
 	thinking?: string | false;
-	/** Models that were requested but cannot be represented by the RPC child. */
-	modelDropped?: string[];
 	/**
 	 * Backend this child was actually spawned on, as arbitrated by
 	 * `Orchestrator.launch` (#209). Optional because run.json records written
@@ -371,6 +354,10 @@ export interface ChildRecord {
 	 * unknown, never guess a backend.
 	 */
 	spawnMode?: SpawnMode;
+	/** D4: 1-based queue position at the moment of enqueue; cleared once admitted. */
+	queuePosition?: number;
+	/** D6/D8: actual queue wait in ms (written on admission; absent when never queued). */
+	queueWaitedMs?: number;
 }
 
 export interface RunRecord {
@@ -430,6 +417,16 @@ export interface ParsedSession {
 	/** True when the last user prompt has no assistant reply (F29 abort signal). */
 	lastTurnMissing: boolean;
 	tornLines: number;
+	/**
+	 * Context size of the FINAL assistant message of the session: its
+	 * `input + cacheRead + cacheWrite`, i.e. the prompt the model actually saw.
+	 *
+	 * Unlike `usage` (a cumulative total across every message) this is a current
+	 * value, so it stops growing when the session stops. Optional because a
+	 * session with no assistant message has no context yet — and there is no
+	 * percentage to derive: session JSONL carries no `contextWindow`.
+	 */
+	lastContextTokens?: number;
 	/**
 	 * Cumulative model-generation wall time in ms: each completed assistant
 	 * message timestamp minus the preceding user or toolResult timestamp when
@@ -497,6 +494,23 @@ export interface Handle {
 	 * result, #209). Callers render this instead of assuming `rpc`.
 	 */
 	spawnMode: SpawnMode;
+	/**
+	 * OS process of an `rpc` child, when the supervisor reported one.
+	 *
+	 * Deliberately not persisted (no `run.json` / `legion.db` field): a pid is
+	 * only meaningful inside the host that spawned it, so a later session would
+	 * read a number that now belongs to some unrelated process. `inprocess`
+	 * children have no pid of their own — they share this process.
+	 */
+	pid?: number;
+	/**
+	 * D4: this launch is still in the queue and has not spawned.
+	 * `child.state === "queued"`, `sessionFile` is a placeholder path, and
+	 * `pid` is necessarily absent.
+	 */
+	queued?: boolean;
+	/** D4: 1-based queue position at enqueue time (always set when `queued === true`). */
+	queuePosition?: number;
 }
 
 // =============================================================================
@@ -504,11 +518,10 @@ export interface Handle {
 // =============================================================================
 
 /**
- * One named kind+model+thinking bundle in `subagents.presets`.
+ * One named (`kind`) model+thinking bundle in `subagents.presets`.
  *
- * `kind` and `model` travel together — a preset whose model does not fit the
- * target kind is rejected at expansion time (see `assertKindModelCoherent`),
- * because `nativeModelFor()` would otherwise silently drop the model.
+ * `kind` is kept for shape compatibility but only `pi` is accepted; any other
+ * value is ignored (reported once) and the preset applies as `pi`.
  */
 export interface PresetConfig {
 	kind?: AgentKind;
@@ -516,22 +529,6 @@ export interface PresetConfig {
 	thinking?: string | false;
 }
 
-/** @deprecated Transitional herdr.* settings retained until v3. */
-export interface HerdrSettings {
-	/** @deprecated Parsed for transition compatibility; ignored by RPC v2. */
-	defaultPlacement?: "split-down" | "split-right" | "new-tab";
-	/** @deprecated Legacy concurrency hint; ignored by RPC v2. */
-	maxConcurrentAgents?: number;
-	/** @deprecated Legacy Herdr launch retry setting. */
-	startRetries?: number;
-	/** @deprecated Legacy Herdr launch retry setting. */
-	startRetryBackoffMs?: number;
-	/** @deprecated Legacy session retention setting. */
-	sessionRetentionDays?: number;
-	/** @deprecated Legacy session retention setting. */
-	sessionRetentionMaxBytesPerRun?: number;
-}
-
 export interface LegionPhaseTimeouts {
 	planning?: number;
 	implementing?: number;
@@ -630,6 +627,10 @@ export interface InProcessLimits {
 	maxActive?: number;
 	maxChildrenPerNode?: number;
 	waitTimeoutMs?: number;
+	/** D10: queued-launch cap (`positiveInt`, default 32; 0 is invalid). */
+	maxQueuedLaunches?: number;
+	/** D10: longest wait for one queued launch in ms (`positiveInt`, default 900000). */
+	launchQueueTimeoutMs?: number;
 }
 
 /**
@@ -699,8 +700,6 @@ export interface SubagentsSettings {
 	disableBuiltins?: boolean;
 	disableThinking?: boolean;
 	maxSubagentSpawnsPerSession?: number;
-	/** @deprecated Transitional herdr.* keys are parsed and ignored by RPC v2. */
-	herdr?: HerdrSettings;
 	legion?: LegionSettings;
 	/** Completion-notice merge mode. Default "smart". */
 	joinMode?: "each" | "smart";
@@ -766,10 +765,7 @@ export class SubagentError extends Error {
 }
 
 export const ErrorCodes = {
-	HERDR_UNAVAILABLE: "HERDR_UNAVAILABLE",
 	DISABLED: "DISABLED",
-	/** @deprecated Legacy Herdr client error retained for API compatibility. */
-	PANE_BUSY: "PANE_BUSY",
 	START_FAILED: "START_FAILED",
 	START_TIMEOUT: "START_TIMEOUT",
 	NAME_TAKEN: "NAME_TAKEN",
@@ -788,20 +784,8 @@ export const ErrorCodes = {
 // =============================================================================
 
 export const DEFAULTS = {
-	/** @deprecated Legacy Herdr start-retry settings retained by the archived backend. */
-	startRetries: 40,
-	startRetryBackoffMs: 150,
 	/** F8: agent wait covers a turn; generous default. */
 	turnTimeoutMs: 900_000,
 	/** jsonl quiet window before declaring a turn settled. */
 	settleQuietMs: 2_500,
-	/** @deprecated Legacy Herdr concurrency hint retained during migration. */
-	maxConcurrentAgents: 6,
-	/** @deprecated Legacy Herdr session retention setting. */
-	sessionRetentionDays: 7,
-	/** @deprecated Legacy Herdr probe settings; retained for the archived backend. */
-	startTimeoutMs: 45_000,
-	binaryProbeTimeoutMs: 3_000,
-	/** @deprecated Legacy Herdr command timeout retained for the archived backend. */
-	commandTimeoutMs: 15_000,
 } as const;