pi-agents-switch 0.2.0

package/types.ts

@@ -0,0 +1,151 @@
+/** Key identifier string for keybindings like "f9" or "ctrl+shift+a" */
+export type KeyId = string;
+
+export type ThinkingLevel =
+	| "off"
+	| "minimal"
+	| "low"
+	| "medium"
+	| "high"
+	| "xhigh";
+
+// ─── YAML Frontmatter (parsed from AGENTS.md) ─────────────
+
+/**
+ * Metadata parsed from the YAML frontmatter block in an agent's AGENTS.md.
+ * The body of the markdown (after the closing `---`) is the system prompt.
+ */
+export interface AgentFrontmatter {
+	/** Display name (e.g. "📋 Plan", "🐛 Debug") */
+	name?: string;
+	/** Short description shown in picker */
+	description?: string;
+	/** Provider name (e.g. "anthropic", "openai") */
+	provider?: string;
+	/** Model ID (e.g. "claude-sonnet-4-5") */
+	model?: string;
+	/** Thinking level for this agent */
+	thinkingLevel?: ThinkingLevel;
+
+	// ── Inference parameters ──
+	/** Temperature (0-2). Controls randomness. Lower = more deterministic. */
+	temperature?: number;
+	/** Top-p sampling (0-1). Nucleus sampling threshold. */
+	topP?: number;
+
+	// ── Tool lists ──
+	/**
+	 * Tools to ADD (after inheritance from PI).
+	 * Last-write-wins: if `tools` and `excluded_tools` both declare
+	 * the same tool, the key that appears later in the YAML wins.
+	 * `"*"` wildcard in `excluded_tools` matches all tools.
+	 */
+	tools?: string[];
+	/**
+	 * Tools to REMOVE (from PI's inherited set). Supports `"*"` wildcard.
+	 */
+	excluded_tools?: string[];
+
+	// ── Extension lists ──
+	/** Extensions to ADD. */
+	extensions?: string[];
+	/**
+	 * Extensions to REMOVE (from PI's inherited set). Supports `"*"` wildcard.
+	 * Preferred over deprecated `noextensions`.
+	 */
+	excluded_extensions?: string[];
+	/** @deprecated Use `excluded_extensions` instead. Still recognized for backward compat. */
+	noextensions?: string[];
+
+	// ── Skill lists ──
+	/** Skills to ADD. */
+	skills?: string[];
+	/**
+	 * Skills to REMOVE (from PI's inherited set). Supports `"*"` wildcard.
+	 * Preferred over deprecated `noskills`.
+	 */
+	excluded_skills?: string[];
+	/** @deprecated Use `excluded_skills` instead. Still recognized for backward compat. */
+	noskills?: string[];
+}
+
+// ─── Frontmatter parse result ──────────────────────────────
+
+export interface FrontmatterResult {
+	frontmatter: AgentFrontmatter;
+	body: string;
+	/**
+	 * Ordered list of top-level YAML keys as they appear in the file.
+	 * Used for last-write-wins conflict resolution between `tools`/`excluded_tools`,
+	 * `extensions`/`excluded_extensions`/`noextensions`, etc.
+	 */
+	keyOrder: string[];
+}
+
+// ─── Resolved Agent Config (after inheritance + fallback) ─
+
+/**
+ * Fully resolved agent configuration after applying the fallback chain
+ * (agent → project → pi default) and inheritance rules.
+ */
+export interface ResolvedAgentConfig {
+	/** Agent name (directory name) */
+	name: string;
+	/** Display name */
+	label: string;
+	/** Short description */
+	description: string;
+	/** Provider/model string (e.g. "anthropic/claude-sonnet-4-5") or undefined */
+	model?: string;
+	/** Thinking level */
+	thinkingLevel?: ThinkingLevel;
+	/** Temperature for inference */
+	temperature?: number;
+	/** Top-p sampling */
+	topP?: number;
+	/** The system prompt (AGENTS.md body) */
+	systemPrompt: string;
+	/** Resolved tools for this agent */
+	tools: string[];
+	/** Resolved extensions for this agent (from agent-specific folder) */
+	extensionPaths: string[];
+	/** Resolved skills for this agent (from agent-specific folder) */
+	skillPaths: string[];
+	/** Source of this agent (path to AGENTS.md used) */
+	sourcePath: string;
+	/** Whether this agent exists on disk */
+	exists: boolean;
+}
+
+// ─── Simplified Global Config ──────────────────────────────
+
+/**
+ * Global config stored in ~/.pi/agent/agents-switch.json.
+ * Only tracks hotkey and which agent is active.
+ * Agent definitions are discovered from the filesystem.
+ */
+export interface AgentsConfig {
+	version: 1;
+	/** Key string like "f9" or "ctrl+shift+a" */
+	hotkey?: KeyId;
+	/** Which agent is currently active ("PI" or a custom agent name) */
+	active?: string;
+}
+
+// ─── Disk Profile ──────────────────────────────────────────
+
+/** Info about an agent profile directory discovered on disk. */
+export interface AgentDiskProfile {
+	/** Agent name (directory name) */
+	name: string;
+	/** Absolute path to the agent directory */
+	path: string;
+	/** Has an AGENTS.md file */
+	hasAgentsMd: boolean;
+	/** Has an extensions/ subdirectory */
+	hasExtensions: boolean;
+	/** Has a skills/ subdirectory */
+	hasSkills: boolean;
+	/** Agent source scope */
+	source: "user" | "project";
+}