@bradygaster/squad-sdk 0.6.2 → 0.8.0

package/dist/agents/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent Session Lifecycle (PRD 4)
+ *
+ * Manages the full agent lifecycle: spawn → active → idle → cleanup.
+ * Compiles charter.md files into SDK CustomAgentConfig objects.
+ * Injects dynamic context via session hooks instead of string templates.
+ */
+export { compileCharter, compileCharterFull, parseCharterMarkdown, type CharterCompileOptions, type CharterConfigOverrides, type ParsedCharter, type CompiledCharter, } from './charter-compiler.js';
+export { resolveModel, inferTierFromModel, isTierFallbackAllowed, ModelFallbackExecutor, type ModelResolutionOptions, type ResolvedModel, type TaskType, type ModelTier, type ModelResolutionSource, type FallbackExecutorConfig, type FallbackAttempt, type FallbackResult, } from './model-selector.js';
+export { AgentLifecycleManager, type AgentHandle, type AgentStatus, type SpawnAgentOptions, type LifecycleManagerConfig, } from './lifecycle.js';
+export { createHistoryShadow, appendToHistory, readHistory, shadowExists, deleteHistoryShadow, type HistorySection, type ParsedHistory, } from './history-shadow.js';
+export interface AgentCharter {
+    /** Agent name (e.g., 'fenster', 'verbal') */
+    name: string;
+    /** Display name (e.g., 'Fenster — Core Dev') */
+    displayName: string;
+    /** Role description */
+    role: string;
+    /** Expertise areas */
+    expertise: string[];
+    /** Working style */
+    style: string;
+    /** Full charter prompt content */
+    prompt: string;
+    /** Allowed tools for this agent */
+    allowedTools?: string[];
+    /** Excluded tools for this agent */
+    excludedTools?: string[];
+    /** Model preference from charter */
+    modelPreference?: string;
+}
+export type AgentLifecycleState = 'pending' | 'spawning' | 'active' | 'idle' | 'error' | 'destroyed';
+export interface AgentSessionInfo {
+    charter: AgentCharter;
+    sessionId: string | null;
+    state: AgentLifecycleState;
+    createdAt: Date | null;
+    lastActiveAt: Date | null;
+    /** Response mode: lightweight (no history), standard, full */
+    responseMode: 'lightweight' | 'standard' | 'full';
+}
+export declare class CharterCompiler {
+    /**
+     * Load and compile a charter.md file into an AgentCharter.
+     * Parses frontmatter and prompt content from markdown.
+     */
+    compile(charterPath: string): Promise<AgentCharter>;
+    /**
+     * Load all charters from the team directory.
+     * Scans .squad/agents/{name}/charter.md
+     */
+    compileAll(teamRoot: string): Promise<AgentCharter[]>;
+}
+export declare class AgentSessionManager {
+    private agents;
+    constructor();
+    /** Spawn a new agent session from a charter */
+    spawn(charter: AgentCharter, mode?: 'lightweight' | 'standard' | 'full'): Promise<AgentSessionInfo>;
+    /** Resume an existing agent session */
+    resume(agentName: string): Promise<AgentSessionInfo>;
+    /** Get info about a specific agent */
+    getAgent(name: string): AgentSessionInfo | undefined;
+    /** Get all agent session info */
+    getAllAgents(): AgentSessionInfo[];
+    /** Destroy an agent session */
+    destroy(agentName: string): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAErG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,YAAY,EAAE,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;CACnD;AAID,qBAAa,eAAe;IAC1B;;;OAGG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQzD;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAK5D;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA4C;;IAM1D,+CAA+C;IACzC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,GAAE,aAAa,GAAG,UAAU,GAAG,MAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQrH,uCAAuC;IACjC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM1D,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,iCAAiC;IACjC,YAAY,IAAI,gBAAgB,EAAE;IAIlC,+BAA+B;IACzB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}

package/dist/agents/index.js

@@ -0,0 +1,74 @@
+/**
+ * Agent Session Lifecycle (PRD 4)
+ *
+ * Manages the full agent lifecycle: spawn → active → idle → cleanup.
+ * Compiles charter.md files into SDK CustomAgentConfig objects.
+ * Injects dynamic context via session hooks instead of string templates.
+ */
+// --- M1-8 Charter Compilation + M2-9 Config-driven ---
+export { compileCharter, compileCharterFull, parseCharterMarkdown, } from './charter-compiler.js';
+// --- M1-9 Model Selection + M3-5 Model Fallback ---
+export { resolveModel, inferTierFromModel, isTierFallbackAllowed, ModelFallbackExecutor, } from './model-selector.js';
+// --- M1-7 Agent Lifecycle ---
+export { AgentLifecycleManager, } from './lifecycle.js';
+// --- M1-11 History Shadows ---
+export { createHistoryShadow, appendToHistory, readHistory, shadowExists, deleteHistoryShadow, } from './history-shadow.js';
+// --- Charter Compiler ---
+export class CharterCompiler {
+    /**
+     * Load and compile a charter.md file into an AgentCharter.
+     * Parses frontmatter and prompt content from markdown.
+     */
+    async compile(charterPath) {
+        // TODO: PRD 4 — Read charter.md from filesystem
+        // TODO: PRD 4 — Parse YAML frontmatter (name, role, expertise, style)
+        // TODO: PRD 4 — Extract prompt body
+        // TODO: PRD 4 — Map to CustomAgentConfig for SDK registration
+        throw new Error('Not implemented');
+    }
+    /**
+     * Load all charters from the team directory.
+     * Scans .squad/agents/{name}/charter.md
+     */
+    async compileAll(teamRoot) {
+        // TODO: PRD 4 — Glob for charter.md files
+        // TODO: PRD 4 — Compile each charter
+        throw new Error('Not implemented');
+    }
+}
+// --- Agent Session Manager ---
+export class AgentSessionManager {
+    agents = new Map();
+    constructor() {
+        // TODO: PRD 4 — Accept SquadClient and SessionPool references
+    }
+    /** Spawn a new agent session from a charter */
+    async spawn(charter, mode = 'standard') {
+        // TODO: PRD 4 — Create SDK session with compiled charter config
+        // TODO: PRD 4 — Inject history.md and decisions.md via onSessionStart
+        // TODO: PRD 4 — Register in session pool
+        // TODO: PRD 4 — Emit lifecycle events
+        throw new Error('Not implemented');
+    }
+    /** Resume an existing agent session */
+    async resume(agentName) {
+        // TODO: PRD 4 — Call SquadClient.resumeSession()
+        // TODO: PRD 4 — Restore context and state
+        throw new Error('Not implemented');
+    }
+    /** Get info about a specific agent */
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    /** Get all agent session info */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /** Destroy an agent session */
+    async destroy(agentName) {
+        // TODO: PRD 4 — Graceful shutdown with onSessionEnd hook
+        // TODO: PRD 4 — Persist final state to history.md
+        this.agents.delete(agentName);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wDAAwD;AACxD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GAKrB,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GAStB,MAAM,qBAAqB,CAAC;AAE7B,+BAA+B;AAC/B,OAAO,EACL,qBAAqB,GAKtB,MAAM,gBAAgB,CAAC;AAExB,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AA6C7B,2BAA2B;AAE3B,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,gDAAgD;QAChD,sEAAsE;QACtE,oCAAoC;QACpC,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,0CAA0C;QAC1C,qCAAqC;QACrC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAED,gCAAgC;AAEhC,MAAM,OAAO,mBAAmB;IACtB,MAAM,GAAkC,IAAI,GAAG,EAAE,CAAC;IAE1D;QACE,8DAA8D;IAChE,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,KAAK,CAAC,OAAqB,EAAE,OAA4C,UAAU;QACvF,gEAAgE;QAChE,sEAAsE;QACtE,yCAAyC;QACzC,sCAAsC;QACtC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,iDAAiD;QACjD,0CAA0C;QAC1C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,sCAAsC;IACtC,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,iCAAiC;IACjC,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,yDAAyD;QACzD,kDAAkD;QAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/agents/lifecycle.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Agent Session Lifecycle (M1-7)
+ *
+ * Orchestrates the complete lifecycle of agent sessions:
+ * - Spawning: charter compilation, model selection, session creation
+ * - Management: status tracking, message handling
+ * - Destruction: graceful shutdown and history saving
+ */
+import { SquadClientWithPool } from '../client/index.js';
+import { type TaskType } from './model-selector.js';
+/**
+ * Agent handle status.
+ */
+export type AgentStatus = 'spawning' | 'active' | 'idle' | 'error' | 'destroyed';
+/**
+ * Handle to a spawned agent session.
+ * Provides control and communication interface to the agent.
+ */
+export interface AgentHandle {
+    /** Agent name (e.g., 'verbal', 'fenster') */
+    agentName: string;
+    /** Underlying session ID from Squad Client */
+    sessionId: string;
+    /** Model being used for this agent */
+    model: string;
+    /** Current agent status */
+    status: AgentStatus;
+    /** Timestamp when agent was spawned */
+    createdAt: Date;
+    /** Last activity timestamp (for idle timeout) */
+    lastActivityAt: Date;
+    /**
+     * Send a message to the agent.
+     * @param prompt - User message or task prompt
+     */
+    sendMessage(prompt: string): Promise<void>;
+    /**
+     * Destroy the agent session gracefully.
+     * Saves history and cleans up resources.
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Options for spawning an agent.
+ */
+export interface SpawnAgentOptions {
+    /** Agent name (e.g., 'verbal', 'fenster') */
+    agentName: string;
+    /** Task prompt to send to the agent */
+    task: string;
+    /** Task type for model selection */
+    taskType?: TaskType;
+    /** User-specified model override */
+    modelOverride?: string;
+    /** Team context content (team.md) */
+    teamContext?: string;
+    /** Routing rules content */
+    routingRules?: string;
+    /** Relevant decision records */
+    decisions?: string;
+    /** Idle timeout in milliseconds (default: 5 minutes) */
+    idleTimeout?: number;
+}
+/**
+ * Configuration for the lifecycle manager.
+ */
+export interface LifecycleManagerConfig {
+    /** Squad client instance */
+    client: SquadClientWithPool;
+    /** Path to team root directory */
+    teamRoot: string;
+    /** Default idle timeout (default: 5 minutes) */
+    defaultIdleTimeout?: number;
+}
+/**
+ * Manages the full lifecycle of agent sessions.
+ *
+ * Coordinates charter compilation, model selection, session creation,
+ * and graceful shutdown with history persistence.
+ */
+export declare class AgentLifecycleManager {
+    private client;
+    private teamRoot;
+    private defaultIdleTimeout;
+    private agents;
+    private idleCheckTimer;
+    constructor(config: LifecycleManagerConfig);
+    /**
+     * Spawn a new agent with full lifecycle setup.
+     *
+     * Pipeline:
+     * 1. Read charter.md from team root
+     * 2. Compile charter with team context
+     * 3. Resolve model using 4-layer priority
+     * 4. Create session via Squad Client
+     * 5. Set up event handlers
+     * 6. Return AgentHandle
+     *
+     * @param options - Spawn options
+     * @returns Agent handle for control and communication
+     */
+    spawnAgent(options: SpawnAgentOptions): Promise<AgentHandle>;
+    /**
+     * Destroy an agent gracefully.
+     * Saves history and cleans up session.
+     *
+     * @param handle - Agent handle to destroy
+     */
+    destroyAgent(handle: AgentHandle): Promise<void>;
+    /**
+     * List all active agent sessions.
+     *
+     * @returns Array of active agent handles
+     */
+    listActive(): AgentHandle[];
+    /**
+     * Get agent handle by session ID.
+     *
+     * @param sessionId - Session ID to look up
+     * @returns Agent handle or undefined
+     */
+    getAgent(sessionId: string): AgentHandle | undefined;
+    /**
+     * Shutdown all agents gracefully.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Start periodic idle timeout checker.
+     * @private
+     */
+    private startIdleChecker;
+    /**
+     * Extract model preference from charter content.
+     * @private
+     */
+    private extractModelPreference;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/agents/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/agents/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAA6C,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAK/F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAC;IAChB,iDAAiD;IACjD,cAAc,EAAE,IAAI,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAE5B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,sBAAsB;IAS1C;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgGlE;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD;;;;OAIG;IACH,UAAU,IAAI,WAAW,EAAE;IAM3B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIpD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}

package/dist/agents/lifecycle.js

@@ -0,0 +1,258 @@
+/**
+ * Agent Session Lifecycle (M1-7)
+ *
+ * Orchestrates the complete lifecycle of agent sessions:
+ * - Spawning: charter compilation, model selection, session creation
+ * - Management: status tracking, message handling
+ * - Destruction: graceful shutdown and history saving
+ */
+import { compileCharter } from './charter-compiler.js';
+import { resolveModel } from './model-selector.js';
+import { ConfigurationError, SessionLifecycleError } from '../adapter/errors.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Manages the full lifecycle of agent sessions.
+ *
+ * Coordinates charter compilation, model selection, session creation,
+ * and graceful shutdown with history persistence.
+ */
+export class AgentLifecycleManager {
+    client;
+    teamRoot;
+    defaultIdleTimeout;
+    agents = new Map();
+    idleCheckTimer = null;
+    constructor(config) {
+        this.client = config.client;
+        this.teamRoot = config.teamRoot;
+        this.defaultIdleTimeout = config.defaultIdleTimeout ?? 300_000; // 5 minutes
+        // Start idle timeout checker
+        this.startIdleChecker();
+    }
+    /**
+     * Spawn a new agent with full lifecycle setup.
+     *
+     * Pipeline:
+     * 1. Read charter.md from team root
+     * 2. Compile charter with team context
+     * 3. Resolve model using 4-layer priority
+     * 4. Create session via Squad Client
+     * 5. Set up event handlers
+     * 6. Return AgentHandle
+     *
+     * @param options - Spawn options
+     * @returns Agent handle for control and communication
+     */
+    async spawnAgent(options) {
+        const { agentName, task, taskType = 'code', modelOverride, teamContext, routingRules, decisions, idleTimeout = this.defaultIdleTimeout, } = options;
+        try {
+            // Step 1: Read charter.md
+            const charterPath = path.join(this.teamRoot, '.ai-team', 'agents', agentName, 'charter.md');
+            let charterContent;
+            try {
+                charterContent = await fs.readFile(charterPath, 'utf-8');
+            }
+            catch (error) {
+                throw new ConfigurationError(`Charter not found for agent '${agentName}' at ${charterPath}`, {
+                    agentName,
+                    operation: 'spawnAgent',
+                    timestamp: new Date(),
+                    metadata: { charterPath },
+                }, error instanceof Error ? error : undefined);
+            }
+            // Step 2: Compile charter
+            const compileOptions = {
+                agentName,
+                charterPath,
+                teamContext,
+                routingRules,
+                decisions,
+            };
+            const agentConfig = compileCharter(compileOptions);
+            // Step 3: Resolve model
+            const modelOptions = {
+                userOverride: modelOverride,
+                charterPreference: agentConfig.prompt.includes('## Model')
+                    ? this.extractModelPreference(charterContent)
+                    : undefined,
+                taskType,
+                agentRole: agentName,
+            };
+            const resolvedModel = resolveModel(modelOptions);
+            // Step 4: Create session
+            const sessionConfig = {
+                model: resolvedModel.model,
+                systemMessage: {
+                    content: agentConfig.prompt,
+                },
+            };
+            const session = await this.client.createSession(sessionConfig);
+            // Step 5: Create handle with event handlers
+            const handle = new AgentHandleImpl({
+                agentName,
+                sessionId: session.sessionId,
+                model: resolvedModel.model,
+                session,
+                idleTimeout,
+                onDestroy: () => this.agents.delete(session.sessionId),
+            });
+            this.agents.set(session.sessionId, handle);
+            // Step 6: Send initial task
+            await handle.sendMessage(task);
+            return handle;
+        }
+        catch (error) {
+            throw new SessionLifecycleError(`Failed to spawn agent '${agentName}': ${error instanceof Error ? error.message : String(error)}`, {
+                agentName,
+                operation: 'spawnAgent',
+                timestamp: new Date(),
+            }, false, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Destroy an agent gracefully.
+     * Saves history and cleans up session.
+     *
+     * @param handle - Agent handle to destroy
+     */
+    async destroyAgent(handle) {
+        await handle.destroy();
+        this.agents.delete(handle.sessionId);
+    }
+    /**
+     * List all active agent sessions.
+     *
+     * @returns Array of active agent handles
+     */
+    listActive() {
+        return Array.from(this.agents.values()).filter(agent => agent.status !== 'destroyed');
+    }
+    /**
+     * Get agent handle by session ID.
+     *
+     * @param sessionId - Session ID to look up
+     * @returns Agent handle or undefined
+     */
+    getAgent(sessionId) {
+        return this.agents.get(sessionId);
+    }
+    /**
+     * Shutdown all agents gracefully.
+     */
+    async shutdown() {
+        if (this.idleCheckTimer) {
+            clearInterval(this.idleCheckTimer);
+            this.idleCheckTimer = null;
+        }
+        const destroyPromises = Array.from(this.agents.values()).map(agent => agent.destroy().catch(err => {
+            console.error(`Failed to destroy agent ${agent.agentName}:`, err);
+        }));
+        await Promise.all(destroyPromises);
+        this.agents.clear();
+    }
+    /**
+     * Start periodic idle timeout checker.
+     * @private
+     */
+    startIdleChecker() {
+        this.idleCheckTimer = setInterval(() => {
+            const now = Date.now();
+            for (const agent of this.agents.values()) {
+                const idleTimeMs = now - agent.lastActivityAt.getTime();
+                if (idleTimeMs > this.defaultIdleTimeout && agent.status === 'active') {
+                    agent.markIdle();
+                }
+            }
+        }, 30_000); // Check every 30 seconds
+    }
+    /**
+     * Extract model preference from charter content.
+     * @private
+     */
+    extractModelPreference(charterContent) {
+        const modelMatch = charterContent.match(/##\s+Model\s*\n[\s\S]*?\*\*Preferred:\*\*\s*(.+)/i);
+        return modelMatch ? modelMatch[1].trim() : undefined;
+    }
+}
+/**
+ * Internal implementation of AgentHandle.
+ * @private
+ */
+class AgentHandleImpl {
+    agentName;
+    sessionId;
+    model;
+    status;
+    createdAt;
+    lastActivityAt;
+    session;
+    idleTimeout;
+    onDestroy;
+    constructor(config) {
+        this.agentName = config.agentName;
+        this.sessionId = config.sessionId;
+        this.model = config.model;
+        this.session = config.session;
+        this.idleTimeout = config.idleTimeout;
+        this.onDestroy = config.onDestroy;
+        this.status = 'active';
+        this.createdAt = new Date();
+        this.lastActivityAt = new Date();
+    }
+    async sendMessage(prompt) {
+        if (this.status === 'destroyed') {
+            throw new SessionLifecycleError('Cannot send message to destroyed agent', {
+                agentName: this.agentName,
+                sessionId: this.sessionId,
+                operation: 'sendMessage',
+                timestamp: new Date(),
+            });
+        }
+        try {
+            this.status = 'active';
+            this.lastActivityAt = new Date();
+            // Send message via session
+            await this.session.sendMessage({ prompt });
+        }
+        catch (error) {
+            this.status = 'error';
+            throw new SessionLifecycleError(`Failed to send message to agent '${this.agentName}': ${error instanceof Error ? error.message : String(error)}`, {
+                agentName: this.agentName,
+                sessionId: this.sessionId,
+                operation: 'sendMessage',
+                timestamp: new Date(),
+            }, false, error instanceof Error ? error : undefined);
+        }
+    }
+    async destroy() {
+        if (this.status === 'destroyed') {
+            return;
+        }
+        try {
+            this.status = 'destroyed';
+            // Clean up session
+            await this.session.close();
+            // Notify lifecycle manager
+            this.onDestroy();
+        }
+        catch (error) {
+            throw new SessionLifecycleError(`Failed to destroy agent '${this.agentName}': ${error instanceof Error ? error.message : String(error)}`, {
+                agentName: this.agentName,
+                sessionId: this.sessionId,
+                operation: 'destroy',
+                timestamp: new Date(),
+            }, false, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Mark agent as idle (called by lifecycle manager).
+     * @internal
+     */
+    markIdle() {
+        if (this.status === 'active') {
+            this.status = 'idle';
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/agents/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/agents/lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/agents/model-selector.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Per-Agent Model Selection (M1-9) + Model Fallback (M3-5, Issue #145)
+ */
+import type { EventBus } from '../runtime/event-bus.js';
+/**
+ * Task types that influence model selection.
+ */
+export type TaskType = 'code' | 'prompt' | 'docs' | 'visual' | 'planning' | 'mechanical';
+/**
+ * Model tier classification.
+ */
+export type ModelTier = 'premium' | 'standard' | 'fast';
+/**
+ * Source of the model resolution.
+ */
+export type ModelResolutionSource = 'user-override' | 'charter' | 'task-auto' | 'default';
+/**
+ * Options for model resolution.
+ */
+export interface ModelResolutionOptions {
+    /** User-specified model override */
+    userOverride?: string;
+    /** Model preference from agent's charter (## Model section) */
+    charterPreference?: string;
+    /** Type of task being performed */
+    taskType: TaskType;
+    /** Agent role (for context) */
+    agentRole?: string;
+}
+/**
+ * Result of model resolution.
+ */
+export interface ResolvedModel {
+    /** Selected model identifier */
+    model: string;
+    /** Model tier classification */
+    tier: ModelTier;
+    /** Source that determined the model */
+    source: ModelResolutionSource;
+    /** Fallback chain for this tier */
+    fallbackChain: string[];
+}
+/**
+ * Resolve the appropriate model using the 4-layer priority system.
+ *
+ * @param options - Model resolution options
+ * @returns Resolved model with tier and fallback chain
+ */
+export declare function resolveModel(options: ModelResolutionOptions): ResolvedModel;
+export declare function inferTierFromModel(model: string): ModelTier;
+export declare function isTierFallbackAllowed(fromTier: ModelTier, toTier: ModelTier, allowCrossTier: boolean): boolean;
+export interface FallbackAttempt {
+    model: string;
+    tier: ModelTier;
+    error: string;
+    timestamp: Date;
+}
+export interface FallbackResult<T> {
+    value: T;
+    model: string;
+    tier: ModelTier;
+    attempts: FallbackAttempt[];
+    didFallback: boolean;
+}
+export interface FallbackExecutorConfig {
+    allowCrossTier?: boolean;
+    eventBus?: EventBus;
+}
+export declare class ModelFallbackExecutor {
+    private allowCrossTier;
+    private eventBus?;
+    private history;
+    constructor(config?: FallbackExecutorConfig);
+    execute<T>(resolved: ResolvedModel, agentName: string, fn: (model: string) => Promise<T>): Promise<FallbackResult<T>>;
+    getHistory(agentName: string): FallbackAttempt[];
+    clearHistory(): void;
+    private buildCandidateList;
+    private emitEvent;
+}
+//# sourceMappingURL=model-selector.d.ts.map

package/dist/agents/model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.d.ts","sourceRoot":"","sources":["../../src/agents/model-selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,mCAAmC;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAgCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAsC3E;AAiDD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAa3D;AAQD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,OAAO,CAA6C;gBAEhD,MAAM,GAAE,sBAA2B;IAKzC,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IA6B7B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhD,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,kBAAkB;YASZ,SAAS;CAIxB"}