aemeathcli 1.0.10 → 1.0.12

package/dist/index.d.ts

@@ -51,6 +51,7 @@ interface IChatMessage {
     readonly model?: string | undefined;
     readonly provider?: ProviderName | undefined;
     readonly toolCalls?: readonly IToolCall[] | undefined;
+    readonly toolCallId?: string | undefined;
     readonly tokenUsage?: ITokenUsage | undefined;
     readonly createdAt: Date;
 }
@@ -94,7 +95,7 @@ interface IToolParameter {
     readonly type: string;
     readonly description: string;
     readonly required: boolean;
-    readonly default?: unknown | undefined;
+    readonly default?: unknown;
     readonly enum?: readonly string[] | undefined;
 }
 interface IToolDefinition {
@@ -123,8 +124,8 @@ type ToolCategory = "file" | "search" | "shell" | "web" | "git" | "mcp";
 interface IToolRegistration {
     readonly definition: IToolDefinition;
     readonly category: ToolCategory;
-    readonly requiresApproval: (mode: PermissionMode, args: Record<string, unknown>) => boolean;
-    readonly execute: (args: Record<string, unknown>) => Promise<IToolResult>;
+    readonly requiresApproval: (context: IToolExecutionContext, args: Record<string, unknown>) => boolean;
+    readonly execute: (args: Record<string, unknown>, context: IToolExecutionContext) => Promise<IToolResult>;
 }
 interface IToolExecutionContext {
     readonly workingDirectory: string;
@@ -189,7 +190,7 @@ interface IIPCMessage {
     readonly params: Record<string, unknown>;
     readonly id?: number | undefined;
 }
-type PaneLayout = "auto" | "horizontal" | "vertical" | "grid";
+type PaneLayout = "auto" | "horizontal" | "vertical" | "grid" | "hub-spoke";
 interface IPaneConfig {
     readonly paneId: string;
     readonly agentName: string;
@@ -203,6 +204,12 @@ interface ILayoutConfig {
     readonly maxPanes: number;
 }
 
+/**
+ * Orchestrator constants — shared across all orchestrator modules.
+ */
+
+type CliProviderType = "claude-code" | "codex" | "gemini-cli" | "kimi-cli" | "ollama";
+
 /**
  * Configuration types per PRD section 17.3
  */
@@ -216,13 +223,19 @@ interface IPermissionConfig {
     readonly allowedPaths: readonly string[];
     readonly blockedCommands: readonly string[];
 }
-type PaneBackend = "tmux" | "iterm2";
+type PaneBackend = "tmux" | "iterm2" | "ghostty" | "terminal-app";
 interface ISplitPanelConfig {
     readonly enabled: boolean;
     readonly backend: PaneBackend;
     readonly defaultLayout: PaneLayout;
     readonly maxPanes: number;
 }
+interface ISwarmConfig {
+    readonly onboardingComplete: boolean;
+    readonly detectedProviders: readonly CliProviderType[];
+    readonly primaryMasterProvider?: CliProviderType | undefined;
+    readonly fallbackMasterProviders: readonly CliProviderType[];
+}
 interface ICostConfig {
     readonly budgetWarning: number;
     readonly budgetHardStop: number;
@@ -252,6 +265,7 @@ interface IGlobalConfig {
     readonly providers: Partial<Record<ProviderName, IProviderConfig>>;
     readonly permissions: IPermissionConfig;
     readonly splitPanel: ISplitPanelConfig;
+    readonly swarm: ISwarmConfig;
     readonly cost: ICostConfig;
     readonly telemetry: ITelemetryConfig;
     readonly oauth?: IOAuthConfig | undefined;
@@ -801,6 +815,7 @@ declare class TaskOrchestrator {
 interface IModelProvider {
     readonly name: string;
     readonly supportedModels: readonly string[];
+    readonly supportsToolCalling: boolean;
     /** Send a non-streaming chat request. */
     chat(request: IChatRequest): Promise<IChatResponse>;
     /** Send a streaming chat request returning an async iterable of chunks. */
@@ -877,57 +892,6 @@ declare class ProviderRegistry {
     listAllAvailableModels(): Promise<Map<string, readonly string[]>>;
 }
 
-/**
- * Claude (Anthropic) adapter via Vercel AI SDK per PRD section 7.1
- * Supports Claude Opus 4.6, Sonnet 4.6, Haiku 4.5
- */
-
-declare class ClaudeAdapter implements IModelProvider {
-    readonly name: ProviderName;
-    readonly supportedModels: readonly string[];
-    private readonly anthropic;
-    constructor(options?: IProviderOptions);
-    chat(request: IChatRequest): Promise<IChatResponse>;
-    stream(request: IChatRequest): AsyncIterable<IStreamChunk>;
-    countTokens(text: string, _model: string): Promise<number>;
-    getModelInfo(model: string): IModelInfo;
-}
-
-/**
- * OpenAI adapter via Vercel AI SDK per PRD section 7.1
- * Supports GPT-5.3 Codex, GPT-5.2, GPT-5.1 Codex series
- */
-
-declare class OpenAIAdapter implements IModelProvider {
-    readonly name: ProviderName;
-    readonly supportedModels: readonly string[];
-    private readonly openai;
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(options?: IProviderOptions);
-    chat(request: IChatRequest): Promise<IChatResponse>;
-    stream(request: IChatRequest): AsyncIterable<IStreamChunk>;
-    countTokens(text: string, _model: string): Promise<number>;
-    getModelInfo(model: string): IModelInfo;
-    listAvailableModels(): Promise<readonly string[]>;
-}
-
-/**
- * Gemini (Google) adapter via Vercel AI SDK per PRD section 7.1
- * Supports Gemini 2.5 Pro, Gemini 2.5 Flash
- */
-
-declare class GeminiAdapter implements IModelProvider {
-    readonly name: ProviderName;
-    readonly supportedModels: readonly string[];
-    private readonly google;
-    constructor(options?: IProviderOptions);
-    chat(request: IChatRequest): Promise<IChatResponse>;
-    stream(request: IChatRequest): AsyncIterable<IStreamChunk>;
-    countTokens(text: string, _model: string): Promise<number>;
-    getModelInfo(model: string): IModelInfo;
-}
-
 /**
  * Kimi (Moonshot) adapter — custom HTTP per PRD section 7.1
  * Uses OpenAI-compatible API format via fetch().
@@ -937,6 +901,7 @@ declare class GeminiAdapter implements IModelProvider {
 declare class KimiAdapter implements IModelProvider {
     readonly name: ProviderName;
     readonly supportedModels: readonly string[];
+    readonly supportsToolCalling = true;
     private readonly baseUrl;
     private readonly apiKey;
     constructor(options?: IProviderOptions);
@@ -956,6 +921,7 @@ declare class KimiAdapter implements IModelProvider {
 
 declare class OllamaAdapter implements IModelProvider {
     readonly name: ProviderName;
+    readonly supportsToolCalling = true;
     private readonly baseUrl;
     private cachedModels;
     constructor(options?: IProviderOptions);
@@ -987,7 +953,8 @@ interface ICLIResult {
 declare abstract class BaseNativeCLIAdapter implements IModelProvider {
     abstract readonly name: ProviderName;
     abstract readonly supportedModels: readonly string[];
-    protected abstract runCLI(model: string, prompt: string): Promise<ICLIResult>;
+    readonly supportsToolCalling = false;
+    protected abstract runCLI(model: string, prompt: string, systemPrompt?: string): Promise<ICLIResult>;
     chat(request: IChatRequest): Promise<IChatResponse>;
     stream(request: IChatRequest): AsyncIterable<IStreamChunk>;
     countTokens(text: string, _model: string): Promise<number>;
@@ -997,22 +964,24 @@ declare abstract class BaseNativeCLIAdapter implements IModelProvider {
 declare class ClaudeNativeCLIAdapter extends BaseNativeCLIAdapter {
     readonly name: ProviderName;
     readonly supportedModels: readonly ["claude-opus-4-6", "claude-opus-4-6-1m", "claude-sonnet-4-6", "claude-sonnet-4-6-1m", "claude-haiku-4-5"];
-    protected runCLI(model: string, prompt: string): Promise<ICLIResult>;
+    /** Map internal model IDs to valid Claude CLI model IDs. */
+    private toCLIModelId;
+    protected runCLI(model: string, prompt: string, systemPrompt?: string): Promise<ICLIResult>;
 }
 declare class CodexNativeCLIAdapter extends BaseNativeCLIAdapter {
     readonly name: ProviderName;
     readonly supportedModels: readonly ["gpt-5.3-codex", "gpt-5.3-codex-spark", "gpt-5.2-codex", "gpt-5.1-codex-max", "gpt-5.2", "gpt-5.1-codex-mini"];
-    protected runCLI(model: string, prompt: string): Promise<ICLIResult>;
+    protected runCLI(model: string, prompt: string, systemPrompt?: string): Promise<ICLIResult>;
 }
 declare class GeminiNativeCLIAdapter extends BaseNativeCLIAdapter {
     readonly name: ProviderName;
     readonly supportedModels: readonly ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"];
-    protected runCLI(model: string, prompt: string): Promise<ICLIResult>;
+    protected runCLI(model: string, prompt: string, systemPrompt?: string): Promise<ICLIResult>;
 }
 declare class KimiNativeCLIAdapter extends BaseNativeCLIAdapter {
     readonly name: ProviderName;
     readonly supportedModels: readonly ["kimi-for-coding"];
-    protected runCLI(_model: string, prompt: string): Promise<ICLIResult>;
+    protected runCLI(_model: string, prompt: string, systemPrompt?: string): Promise<ICLIResult>;
 }
 
 /**
@@ -1036,7 +1005,7 @@ declare class ToolRegistry implements IToolRegistry {
  * Per PRD section 5.1
  */
 
-declare function createDefaultRegistry(context: IToolExecutionContext): ToolRegistry;
+declare function createDefaultRegistry(_context: IToolExecutionContext): ToolRegistry;
 
 /**
  * Credential storage per PRD section 13.6
@@ -1134,8 +1103,8 @@ declare class SqliteStore {
     private runMigrations;
     prepare(sql: string): Database.Statement;
     run(sql: string, ...params: readonly unknown[]): Database.RunResult;
-    get<T>(sql: string, ...params: readonly unknown[]): T | undefined;
-    all<T>(sql: string, ...params: readonly unknown[]): T[];
+    get(sql: string, ...params: unknown[]): unknown;
+    all(sql: string, ...params: unknown[]): unknown[];
     transaction<T>(fn: () => T): T;
     close(): void;
     private registerCleanupHandlers;
@@ -1436,11 +1405,12 @@ interface ITeamCreateOptions {
     readonly agents: readonly IAgentDefinition[];
     readonly sessionId?: string;
     readonly cliEntryPoint?: string;
+    readonly agentEnv?: Readonly<Record<string, string>>;
 }
 declare class TeamManager {
     private readonly activeTeams;
     /** Create a new team: config, directories, and agent process handles. */
-    createTeam(name: string, options: ITeamCreateOptions): Promise<ITeamConfig>;
+    createTeam(name: string, options: ITeamCreateOptions): ITeamConfig;
     /** Start all agent processes for a team. */
     startAgents(teamName: string): Promise<void>;
     /** Gracefully shutdown and remove a team. */
@@ -1506,6 +1476,7 @@ declare class AgentProcess {
     constructor(config: IAgentConfig, options: IAgentProcessOptions);
     /** Spawn the child process. Throws AgentSpawnError on failure. */
     start(): Promise<void>;
+    private buildChildEnv;
     /** Gracefully stop the agent. Falls back to SIGTERM after timeout. */
     stop(): Promise<void>;
     /** Kill and restart the agent process. */
@@ -1593,6 +1564,7 @@ declare class LayoutEngine {
      * Compute per-pane geometries based on layout type.
      */
     private computeGeometries;
+    private computeHubSpokeLayout;
     /**
      * Horizontal split: all panes side by side.
      */
@@ -1696,10 +1668,11 @@ declare class TmuxManager {
     getPanes(): ReadonlyMap<string, ITmuxPaneInfo>;
     private splitPane;
     private getFirstPaneId;
-    private equalizeLayout;
+    private applyLayoutPreset;
     private killSessionSilent;
     private assertNotDisposed;
     private assertSession;
+    private requireSessionName;
 }
 
 /**
@@ -1764,7 +1737,7 @@ declare class ITerm2Manager {
  * JSON-RPC 2.0 protocol with HMAC authentication per PRD section 9.4 & 14.5.
  */
 
-type MethodHandler = (clientId: string, params: Record<string, unknown>, id: number | undefined, socket: Socket) => Promise<unknown>;
+type MethodHandler = (clientId: string, params: Record<string, unknown>, id: number | undefined, socket: Socket) => unknown;
 declare class IPCHub {
     private readonly sessionId;
     private readonly hmacSecret;
@@ -1787,7 +1760,7 @@ declare class IPCHub {
     /** Register a custom method handler. */
     onMethod(method: string, handler: MethodHandler): void;
     /** Compute HMAC-SHA256 for a message. */
-    computeHmac(message: IIPCMessage): string;
+    computeHmac(message: unknown): string;
     /** Register a connected socket as a client (also called by agent.register). */
     registerClientSocket(agentId: string, agentName: string, socket: Socket): void;
     /** Gracefully shut down the hub and all connections. */
@@ -1797,6 +1770,8 @@ declare class IPCHub {
     private registerDefaultHandlers;
     private verifyHmac;
     private isAuthEnvelope;
+    private isIPCMessage;
+    private getRequestId;
     private write;
     private sendResult;
     private sendError;
@@ -1820,6 +1795,7 @@ interface IPaneProcessOptions {
 }
 type MessageHandler = (message: IIPCMessage) => void;
 declare class PaneProcess {
+    private static readonly resolvedPromise;
     private readonly agentId;
     private readonly agentName;
     private readonly socketPath;
@@ -1903,7 +1879,7 @@ declare class SkillLoader {
  * Progressive loading: only name + description loaded initially (~100 tokens each).
  */
 
-type SkillSource = "project" | "user" | "built-in";
+type SkillSource = "project" | "user" | "universal" | "built-in";
 interface ISkillSummary {
     readonly name: string;
     readonly description: string;
@@ -2207,4 +2183,4 @@ declare class MCPToolBridge {
     private createRegistration;
 }
 
-export { AemeathError, type AgentMessageType, AgentProcess, AgentSpawnError, AuthenticationError, ClaudeAdapter, ClaudeNativeCLIAdapter, CodexNativeCLIAdapter, ConfigStore, ContextManager, ContextOverflowError, ConversationStore, CostTracker, CredentialStore, DEFAULT_CONFIG, DEFAULT_MODEL_ID, ExecutionTimeoutError, FileNotFoundError, GeminiAdapter, GeminiNativeCLIAdapter, type IAgentConfig, type IAgentMessage, type IAgentState, type IChatMessage, type IChatRequest, type IChatResponse, type ICredential, type IGlobalConfig, type ILayoutConfig, type IMCPConfig, type IModelInfo, type IModelProvider, type IModelResolution, IPCError, IPCHub, type IPaneConfig, type IProviderOptions, type IRoleConfig, type ISkillDefinition, type IStreamChunk, type ITask, type ITeamConfig, ITerm2Manager, type ITokenUsage, type IToolCall, type IToolDefinition, type IToolExecutionContext, type IToolParameter, type IToolRegistration, type IToolRegistry, type IToolResult, InvalidConfigError, KimiAdapter, KimiNativeCLIAdapter, LayoutEngine, MCPClient, MCPServerManager, MCPToolBridge, MessageBus, type MessageRole, MissingConfigError, ModelNotFoundError, type ModelRole, ModelRouter, OllamaAdapter, OpenAIAdapter, type PaneLayout, PaneProcess, PermissionDeniedError, PermissionManager, type PermissionMode, PlanApproval, type ProviderName, ProviderRegistry, RateLimitError, SUPPORTED_MODELS, ServerConnectionError, SessionManager, SkillExecutor, SkillLoader, SkillRegistry, SqliteStore, TaskOrchestrator, type TaskStatus, TaskStore, TeamManager, TmuxManager, ToolCallError, type ToolCategory, ToolRegistry, createDefaultRegistry, createModelRouter, getEventBus };
+export { AemeathError, type AgentMessageType, AgentProcess, AgentSpawnError, AuthenticationError, ClaudeNativeCLIAdapter, CodexNativeCLIAdapter, ConfigStore, ContextManager, ContextOverflowError, ConversationStore, CostTracker, CredentialStore, DEFAULT_CONFIG, DEFAULT_MODEL_ID, ExecutionTimeoutError, FileNotFoundError, GeminiNativeCLIAdapter, type IAgentConfig, type IAgentMessage, type IAgentState, type IChatMessage, type IChatRequest, type IChatResponse, type ICredential, type IGlobalConfig, type ILayoutConfig, type IMCPConfig, type IModelInfo, type IModelProvider, type IModelResolution, IPCError, IPCHub, type IPaneConfig, type IProviderOptions, type IRoleConfig, type ISkillDefinition, type IStreamChunk, type ITask, type ITeamConfig, ITerm2Manager, type ITokenUsage, type IToolCall, type IToolDefinition, type IToolExecutionContext, type IToolParameter, type IToolRegistration, type IToolRegistry, type IToolResult, InvalidConfigError, KimiAdapter, KimiNativeCLIAdapter, LayoutEngine, MCPClient, MCPServerManager, MCPToolBridge, MessageBus, type MessageRole, MissingConfigError, ModelNotFoundError, type ModelRole, ModelRouter, OllamaAdapter, type PaneLayout, PaneProcess, PermissionDeniedError, PermissionManager, type PermissionMode, PlanApproval, type ProviderName, ProviderRegistry, RateLimitError, SUPPORTED_MODELS, ServerConnectionError, SessionManager, SkillExecutor, SkillLoader, SkillRegistry, SqliteStore, TaskOrchestrator, type TaskStatus, TaskStore, TeamManager, TmuxManager, ToolCallError, type ToolCategory, ToolRegistry, createDefaultRegistry, createModelRouter, getEventBus };