@gencode/agents 0.9.3 → 0.10.1

package/dist/index.d.ts

@@ -18,119 +18,6 @@ type ToolLoopDetectionConfig = {
   };
 };
 //#endregion
-//#region src/runner/turn-retry.d.ts
-type LlmTurnRetryConfig = {
-  enabled?: boolean;
-  maxAttempts?: number;
-  initialDelayMs?: number;
-  maxDelayMs?: number;
-};
-//#endregion
-//#region src/plugins/types.d.ts
-type PluginDiagnostic = {
-  level: "warn" | "error";
-  message: string;
-  pluginId?: string;
-  source?: string;
-};
-type PluginOrigin = "bundled" | "global" | "workspace" | "config";
-type PluginKind = "memory";
-type PluginConfigUiHint = {
-  label?: string;
-  help?: string;
-  tags?: string[];
-  advanced?: boolean;
-  sensitive?: boolean;
-  placeholder?: string;
-};
-type PluginManifest = {
-  id: string;
-  configSchema: Record<string, unknown>;
-  kind?: PluginKind;
-  skills?: string[];
-  name?: string;
-  description?: string;
-  version?: string;
-  uiHints?: Record<string, PluginConfigUiHint>;
-};
-type PluginManifestLoadResult = {
-  ok: true;
-  manifest: PluginManifest;
-  manifestPath: string;
-} | {
-  ok: false;
-  error: string;
-  manifestPath: string;
-};
-type PluginCandidate = {
-  idHint: string;
-  source: string;
-  rootDir: string;
-  origin: PluginOrigin;
-  workspaceDir?: string;
-  packageName?: string;
-  packageVersion?: string;
-  packageDescription?: string;
-  packageDir?: string;
-  packageManifest?: AIMaxPackageManifest;
-};
-type AIMaxPackageManifest = {
-  extensions?: string[];
-};
-type PluginDiscoveryResult = {
-  candidates: PluginCandidate[];
-  diagnostics: PluginDiagnostic[];
-};
-//#endregion
-//#region src/plugins/manifest-registry.d.ts
-type PluginManifestRecord = {
-  id: string;
-  rootDir: string;
-  source: string;
-  origin: PluginCandidate["origin"];
-  manifestPath: string;
-  manifest: PluginManifest;
-};
-type PluginManifestRegistry = {
-  manifests: Map<string, PluginManifestRecord>;
-  diagnostics: PluginDiagnostic[];
-};
-declare function loadPluginManifestRegistry(candidates: PluginCandidate[]): PluginManifestRegistry;
-//#endregion
-//#region src/plugins/config-state.d.ts
-type PluginEntryConfig = {
-  enabled?: boolean;
-  config?: Record<string, unknown>;
-};
-type PluginsConfig = {
-  enabled?: boolean;
-  allow?: string[];
-  deny?: string[];
-  llmAllowlist?: string[];
-  load?: {
-    paths?: string[];
-  };
-  entries?: Record<string, PluginEntryConfig>;
-  slots?: Partial<Record<PluginKind, string>>;
-};
-type NormalizedPluginsConfig = {
-  enabled: boolean;
-  allow: string[];
-  deny: string[];
-  loadPaths: string[];
-  entries: Record<string, PluginEntryConfig>;
-  slots: Partial<Record<PluginKind, string>>;
-};
-type PluginsConfigValidationResult = {
-  ok: boolean;
-  diagnostics: PluginDiagnostic[];
-};
-declare function normalizePluginsConfig(input?: PluginsConfig): NormalizedPluginsConfig;
-declare function validatePluginsConfig(params: {
-  config: NormalizedPluginsConfig;
-  registry: PluginManifestRegistry;
-}): PluginsConfigValidationResult;
-//#endregion
 //#region src/memory/config.d.ts
 type MemorySearchConfig = {
   chunkTokens: number;
@@ -377,97 +264,310 @@ type MemoryProvider = {
 };
 type MemoryProviderFactory = (ctx: MemoryProviderContext) => MemoryProvider;
 //#endregion
-//#region src/session/session.d.ts
-declare const DEFAULT_SESSION_STORE_NAME = "sessions";
-type SessionPathOptions = {
-  storeName?: string; /** Whether session data should be encrypted at rest. */
-  encryptSessions?: boolean;
-  subagent?: {
-    parentSessionId: string;
-    /**
-     * Absolute filesystem path of the parent session's directory.
-     * When set, the child path is resolved as `path.join(parentDir, "subagents", childSessionId)`
-     * rather than anchoring at `sessionsDir`. This is required for correctly nesting
-     * sub-subagents (depth ≥ 2) inside their parent subagent's own directory.
-     */
-    parentDir?: string;
+//#region src/plugins/hooks.d.ts
+type PluginHookName = "before_model_resolve" | "before_prompt_build" | "after_prompt_build" | "llm_input" | "assistant_message_end" | "llm_output" | "before_tool_call" | "after_tool_call" | "agent_end" | "before_compaction" | "after_compaction" | "session_start" | "session_end" | "session_reset" | "dream_gate" | "memory_changed";
+type PluginHookAgentContext = {
+  agentId?: string;
+  sessionId?: string;
+  workspaceDir?: string;
+  channel?: AgentRunParams["channel"];
+};
+type PluginExecutionRuntime = {
+  eventDispatcher: {
+    dispatchProgress: (sessionId: string, event: AgentProgressEvent$1) => Promise<void>;
   };
 };
-type SessionInspection = {
-  id: string;
-  metadata: SessionMetadata$1 | null;
-  transcriptPath: string;
-  contextSnapshotPath: string;
-  sessionMemoryPath: string;
-  collapseLogPath: string;
-  toolResultsDir: string;
-  transcriptEntryCount: number;
-  readStateCount: number;
-  toolResultRefCount: number;
-  transcriptEntries: TranscriptEntry[];
-  context: SessionContextSnapshot;
+type PluginHookBeforeModelResolveEvent = {
+  prompt: string;
 };
-type SessionExport = {
-  id: string;
-  metadata: SessionMetadata$1 | null;
-  transcript: TranscriptEntry[];
-  context: SessionContextSnapshot;
-  paths: {
-    transcriptPath: string;
-    contextSnapshotPath: string;
-    sessionMemoryPath: string;
-    collapseLogPath: string;
-    toolResultsDir: string;
+type PluginHookBeforeModelResolveResult = {
+  modelOverride?: string;
+};
+type PluginHookBeforePromptBuildEvent = {
+  prompt: string;
+};
+type PluginHookBeforePromptBuildResult = {
+  systemPrompt?: string;
+  prependContext?: string;
+};
+type PluginHookAfterPromptBuildEvent = {
+  prompt: string;
+  systemPrompt: string;
+};
+type PluginHookLlmInputEvent = {
+  sessionId: string;
+  model: string;
+  prompt: string;
+  historyMessages: unknown[];
+};
+type PluginHookAssistantMessageEndEvent = {
+  sessionId: string;
+  model: string;
+  assistantText: string;
+  assistantMessage: AssistantMessage;
+  hasToolCalls: boolean;
+  durationMs?: number;
+  usage?: {
+    input?: number;
+    output?: number;
+    total?: number;
   };
 };
-type CronExecutionRecord = {
-  task: string;
-  status: "done" | "error" | "killed";
-  content: string;
-  childSessionId?: string;
-  createdAt: string;
+type PluginHookLlmOutputEvent = {
+  sessionId: string;
+  model: string;
+  assistantTexts: string[];
+  lastAssistant?: AssistantMessage;
+  durationMs?: number;
+  usage?: {
+    input?: number;
+    output?: number;
+    total?: number;
+  };
 };
-declare const MAX_ARTIFACT_CONTENT_CHARS = 2000;
-type ArtifactOperationType = "write" | "edit" | "delete" | "move";
-type ArtifactOperationName = "write_file" | "edit_file" | "patch_add" | "patch_update" | "patch_delete" | "patch_move";
-type ArtifactOperationInput = {
-  type: ArtifactOperationType;
-  operation: ArtifactOperationName;
-  file: string;
-  sourceFile?: string;
-  content: string;
+type PluginHookBeforeToolCallEvent = {
   toolCallId: string;
-  toolName: string; /** Whether this operation was performed by the agent itself or a subagent */
-  source: "agent" | "subagent"; /** The session that actually performed this operation */
-  sessionId: string;
+  toolName: string;
+  params: Record<string, unknown>;
 };
-/** Operation shape that tool implementations provide before the recorder enriches it with source/sessionId. */
-type ArtifactOpInput = Omit<ArtifactOperationInput, "source" | "sessionId">;
-type ArtifactOperation = ArtifactOperationInput & {
-  timestamp: string;
-  truncated: boolean;
-  originalChars: number;
+type PluginHookBeforeToolCallResult = {
+  params?: Record<string, unknown>;
+  block?: boolean;
+  blockReason?: string;
 };
-/** Resolves the sessions directory path within a data directory */
-declare function normalizeSessionStoreName(storeName?: string): string;
-/** Resolves the sessions directory path within a data directory */
-declare function sessionsDir(dataDir: string, options?: SessionPathOptions): string;
-/** Resolves the directory for a specific session */
-declare function sessionDir(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Resolves the transcript file path for a session */
-declare function transcriptPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Resolves the artifact operation log path for a session */
-declare function artifactsPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Resolves the metadata file path for a session */
-declare function metadataPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Resolves the persisted context snapshot path for a session */
-declare function contextSnapshotPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-declare function sessionMemoryPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-declare function collapseLogPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Resolves the persisted tool-results directory for a session */
-declare function toolResultsDir(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-declare function cronExecutionsPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
-/** Creates a new session with a generated ID */
+type PluginHookAfterToolCallEvent = {
+  toolCallId: string;
+  toolName: string;
+  params: Record<string, unknown>;
+  result?: unknown;
+  error?: string;
+  durationMs?: number;
+};
+type PluginHookAgentEndEvent = {
+  success: boolean;
+  error?: string;
+  durationMs?: number;
+};
+type PluginHookBeforeCompactionEvent = {
+  messageCount: number;
+  compactingCount?: number;
+};
+type PluginHookBeforeCompactionResult = {
+  skipPersist?: boolean;
+  injectRecall?: string;
+};
+type PluginHookAfterCompactionEvent = {
+  messageCount: number;
+  compactedCount: number;
+};
+type PluginHookSessionStartEvent = {
+  sessionId: string;
+};
+type PluginHookSessionEndEvent = {
+  sessionId: string;
+  messageCount: number;
+  durationMs?: number;
+};
+type PluginHookSessionResetEvent = {
+  action: "new" | "reset";
+  sessionId: string;
+  previousSessionId?: string;
+  message: string;
+};
+type PluginHookDreamGateEvent = {
+  dataDir: string;
+  memoryDir: string;
+  providerId: string;
+  pluginId?: string;
+  trigger: "cli" | "cron";
+  dryRun?: boolean;
+};
+type PluginHookDreamGateResult = {
+  handled?: boolean;
+  status?: "noop" | "completed" | "queued" | "failed";
+  summary?: string;
+  details?: Record<string, unknown>;
+};
+type PluginHookMemoryChangedEvent = MemoryChangedEvent;
+type PluginHookHandlerMap = {
+  before_model_resolve: (event: PluginHookBeforeModelResolveEvent, ctx: PluginHookAgentContext) => PluginHookBeforeModelResolveResult | void | Promise<PluginHookBeforeModelResolveResult | void>;
+  before_prompt_build: (event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext) => PluginHookBeforePromptBuildResult | void | Promise<PluginHookBeforePromptBuildResult | void>;
+  after_prompt_build: (event: PluginHookAfterPromptBuildEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  llm_input: (event: PluginHookLlmInputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  assistant_message_end: (event: PluginHookAssistantMessageEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  llm_output: (event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  before_tool_call: (event: PluginHookBeforeToolCallEvent, ctx: PluginHookAgentContext) => PluginHookBeforeToolCallResult | void | Promise<PluginHookBeforeToolCallResult | void>;
+  after_tool_call: (event: PluginHookAfterToolCallEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  agent_end: (event: PluginHookAgentEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  before_compaction: (event: PluginHookBeforeCompactionEvent, ctx: PluginHookAgentContext) => PluginHookBeforeCompactionResult | void | Promise<PluginHookBeforeCompactionResult | void>;
+  after_compaction: (event: PluginHookAfterCompactionEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  session_start: (event: PluginHookSessionStartEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  session_end: (event: PluginHookSessionEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  session_reset: (event: PluginHookSessionResetEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+  dream_gate: (event: PluginHookDreamGateEvent, ctx: PluginHookAgentContext) => PluginHookDreamGateResult | void | Promise<PluginHookDreamGateResult | void>;
+  memory_changed: (event: PluginHookMemoryChangedEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+};
+type PluginHookRegistration<K extends PluginHookName = PluginHookName> = {
+  pluginId: string;
+  hookName: K;
+  handler: PluginHookHandlerMap[K];
+  priority?: number;
+  source: string;
+};
+declare class PluginHookRegistry {
+  private readonly hooks;
+  register<K extends PluginHookName>(registration: PluginHookRegistration<K>): void;
+  dispatch<K extends PluginHookName>(hookName: K, event: Parameters<PluginHookHandlerMap[K]>[0], ctx: Parameters<PluginHookHandlerMap[K]>[1], runtime?: PluginExecutionRuntime): Promise<Array<Awaited<ReturnType<PluginHookHandlerMap[K]>>>>;
+}
+//#endregion
+//#region src/runner/event-dispatcher.d.ts
+type EventDispatchParams = Pick<AgentRunParams, "onProgress" | "messageId" | "channel" | "subagentContext">;
+/**
+ * Emits runner events to in-process listeners.
+ */
+declare class RunEventDispatcher {
+  private readonly params;
+  constructor(params: EventDispatchParams);
+  dispatchProgress(sessionId: string, event: AgentProgressEvent$2): Promise<void>;
+  dispatchDiagnostic(sessionId: string, event: Omit<AgentDiagnosticEvent, keyof AgentProgressEventBase | "type">): Promise<void>;
+}
+//#endregion
+//#region src/runner/turn/retry.d.ts
+type LlmTurnRetryConfig = {
+  enabled?: boolean;
+  maxAttempts?: number;
+  initialDelayMs?: number;
+  maxDelayMs?: number;
+};
+//#endregion
+//#region src/bootstrap/bootstrap.d.ts
+/** Maximum characters per bootstrap file before truncation */
+declare const BOOTSTRAP_MAX_CHARS = 20000;
+/** Maximum total characters across all bootstrap files */
+declare const BOOTSTRAP_TOTAL_MAX_CHARS = 150000;
+/** Names of bootstrap identity files, in injection order */
+declare const BOOTSTRAP_FILE_NAMES: readonly ["AGENTS.md", "SOUL.md", "TOOLS.md", "IDENTITY.md", "USER.md", "MEMORY.md", "BOOTSTRAP.md"];
+/** A loaded (or missing) bootstrap file */
+type BootstrapFile = {
+  name: string;
+  path: string;
+  content: string | null;
+  missing: boolean;
+};
+/** A bootstrap file ready for system prompt injection */
+type BootstrapContextFile = {
+  path: string;
+  content: string;
+};
+/** Resolves the base .aimax directory within a data directory */
+declare function aimaxDir(dataDir: string): string;
+/**
+ * Loads all standard bootstrap identity files from the .aimax directory.
+ * Missing files are included as `missing: true` entries.
+ * BOOTSTRAP.md is deleted after loading (one-time use).
+ */
+declare function loadBootstrapFiles(dataDir: string): Promise<BootstrapFile[]>;
+/**
+ * Converts loaded bootstrap files into context file entries for system prompt injection.
+ * Applies per-file and total character budget limits.
+ */
+declare function buildBootstrapContextFiles(files: BootstrapFile[], opts?: {
+  maxChars?: number;
+  totalMaxChars?: number;
+  warn?: (message: string) => void;
+}): BootstrapContextFile[];
+//#endregion
+//#region src/session/session.d.ts
+declare const DEFAULT_SESSION_STORE_NAME = "sessions";
+type SessionPathOptions = {
+  storeName?: string; /** Whether session data should be encrypted at rest. */
+  encryptSessions?: boolean;
+  subagent?: {
+    parentSessionId: string;
+    /**
+     * Absolute filesystem path of the parent session's directory.
+     * When set, the child path is resolved as `path.join(parentDir, "subagents", childSessionId)`
+     * rather than anchoring at `sessionsDir`. This is required for correctly nesting
+     * sub-subagents (depth ≥ 2) inside their parent subagent's own directory.
+     */
+    parentDir?: string;
+  };
+};
+type SessionInspection = {
+  id: string;
+  metadata: SessionMetadata$1 | null;
+  transcriptPath: string;
+  contextSnapshotPath: string;
+  sessionMemoryPath: string;
+  collapseLogPath: string;
+  toolResultsDir: string;
+  transcriptEntryCount: number;
+  readStateCount: number;
+  toolResultRefCount: number;
+  transcriptEntries: TranscriptEntry[];
+  context: SessionContextSnapshot;
+};
+type SessionExport = {
+  id: string;
+  metadata: SessionMetadata$1 | null;
+  transcript: TranscriptEntry[];
+  context: SessionContextSnapshot;
+  paths: {
+    transcriptPath: string;
+    contextSnapshotPath: string;
+    sessionMemoryPath: string;
+    collapseLogPath: string;
+    toolResultsDir: string;
+  };
+};
+type CronExecutionRecord = {
+  task: string;
+  status: "done" | "error" | "killed";
+  content: string;
+  childSessionId?: string;
+  createdAt: string;
+};
+declare const MAX_ARTIFACT_CONTENT_CHARS = 2000;
+type ArtifactOperationType = "write" | "edit" | "delete" | "move";
+type ArtifactOperationName = "write_file" | "edit_file" | "patch_add" | "patch_update" | "patch_delete" | "patch_move";
+type ArtifactOperationInput = {
+  type: ArtifactOperationType;
+  operation: ArtifactOperationName;
+  file: string;
+  sourceFile?: string;
+  content: string;
+  toolCallId: string;
+  toolName: string; /** Whether this operation was performed by the agent itself or a subagent */
+  source: "agent" | "subagent"; /** The session that actually performed this operation */
+  sessionId: string;
+};
+/** Operation shape that tool implementations provide before the recorder enriches it with source/sessionId. */
+type ArtifactOpInput = Omit<ArtifactOperationInput, "source" | "sessionId">;
+type ArtifactOperation = ArtifactOperationInput & {
+  timestamp: string;
+  truncated: boolean;
+  originalChars: number;
+};
+/** Resolves the sessions directory path within a data directory */
+declare function normalizeSessionStoreName(storeName?: string): string;
+/** Resolves the sessions directory path within a data directory */
+declare function sessionsDir(dataDir: string, options?: SessionPathOptions): string;
+/** Resolves the directory for a specific session */
+declare function sessionDir(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Resolves the transcript file path for a session */
+declare function transcriptPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Resolves the artifact operation log path for a session */
+declare function artifactsPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Resolves the metadata file path for a session */
+declare function metadataPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Resolves the persisted context snapshot path for a session */
+declare function contextSnapshotPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+declare function sessionMemoryPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+declare function collapseLogPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Resolves the persisted tool-results directory for a session */
+declare function toolResultsDir(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+declare function cronExecutionsPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+/** Creates a new session with a generated ID */
 declare function createSession(dataDir: string, channel: Channel, options?: SessionPathOptions & {
   sessionId?: string;
 }): Promise<string>;
@@ -511,6 +611,7 @@ type LlmApiFormat = "openai-completions" | "anthropic-messages";
 //#region src/history/topic-segmentation.d.ts
 type TopicSegmentationConfig = {
   enabled?: boolean;
+  embeddingModelDir?: string;
   minUserTurns?: number;
   minEstimatedTokens?: number;
   recentProtectedTurnCount?: number;
@@ -524,29 +625,141 @@ type TopicSegmentationConfig = {
   maxTokens?: number;
 };
 //#endregion
-//#region src/skills/skills.d.ts
-/** Resolves the skills directory path within a data directory */
-declare function skillsDir(dataDir: string): string;
-/** Represents a loaded skill */
-type Skill = {
-  name: string;
-  description: string;
-  location: string;
-  version: string;
-  skillFileMtime: string;
-};
-type SkillDirectory = {
-  skill: Skill;
-  rootDir: string;
-};
-type SkillViewResult = {
-  skill: Skill;
+//#region src/context/session-context-store.d.ts
+type PersistedToolResult = {
   content: string;
+  reference?: ToolResultReference;
 };
-/**
- * Loads all installed skills from the skills directory.
- * Each skill is a directory containing a SKILL.md file.
- * Returns at most MAX_SKILLS_IN_PROMPT skills.
+type SessionContextStore = {
+  findReusableRead(path: string, offset?: number, limit?: number): Promise<ReadStateRecord | null>;
+  recordRead(params: {
+    path: string;
+    content: string;
+    lineCount: number;
+    offset?: number;
+    limit?: number;
+  }): Promise<ReadStateRecord>;
+  invalidatePath(path: string): Promise<void>;
+  persistToolResult(params: {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    thresholdChars?: number;
+    previewChars?: number;
+  }): Promise<PersistedToolResult>;
+  recordSnip(record: SnipRecord): Promise<void>;
+  recordCollapse(span: CollapseSpan): Promise<void>;
+  setSessionMemory(snapshot: SessionMemorySnapshot): Promise<void>;
+  recordModelUsage(checkpoint: ModelUsageCheckpoint): Promise<void>;
+  recordAutocompactResult(params: {
+    layer: "L6";
+    failed: boolean;
+    timestamp: string;
+  }): Promise<void>;
+  getSnapshot(): SessionContextSnapshot;
+};
+type SessionContextStoreOptions = {
+  dataDir: string;
+  sessionId: string;
+} & SessionPathOptions;
+declare function createSessionContextStore(options: SessionContextStoreOptions): Promise<SessionContextStore>;
+//#endregion
+//#region src/context/context-manager.d.ts
+type ManageLayeredHistoryParams = {
+  entries: TranscriptEntry[];
+  modelInfo: {
+    model: string;
+    api: string;
+  };
+  contextWindowTokens: number;
+  llm: Pick<AgentRunParams["llm"], "apiFormat" | "baseUrl" | "apiKey" | "model" | "flashModel">;
+  historyLimit?: number;
+  compactionEnabled?: boolean;
+  pendingUserMessage?: string;
+  topicSegmentation?: TopicSegmentationConfig;
+  signal?: AbortSignal;
+  hooks?: PluginHookRegistry;
+  hookCtx?: PluginHookAgentContext;
+  contextStore?: SessionContextStore;
+  dataDir?: string;
+  sessionId?: string;
+  sessionStoreName?: string;
+  sessionPathScope?: Pick<SessionPathOptions, "subagent">;
+  channel?: Channel$1;
+  isSubagent?: boolean;
+};
+type ManageLayeredHistoryResult = {
+  messages: AgentMessage[];
+  priorSummary: string | undefined;
+  compactionEntry: CompactionEntry | undefined;
+  stats: {
+    originalCount: number;
+    keptCount: number;
+    estimatedTokens: number;
+    compacted: boolean;
+  };
+  compactionEvents: AgentProgressEvent$1[];
+};
+type ContextManager = {
+  getReusableRead(path: string, offset?: number, limit?: number): Promise<{
+    reused: boolean;
+    lineCount?: number;
+  }>;
+  rememberRead(params: {
+    path: string;
+    content: string;
+    lineCount: number;
+    offset?: number;
+    limit?: number;
+  }): Promise<void>;
+  invalidateReadPath(path: string): Promise<void>;
+  persistToolResult(params: {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    thresholdChars?: number;
+    previewChars?: number;
+  }): Promise<PersistedToolResult>;
+  recordModelUsage(params: {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    coveredTranscriptEntryCount: number;
+  }): Promise<void>;
+  manageHistory(params: Omit<ManageLayeredHistoryParams, "contextStore">): Promise<ManageLayeredHistoryResult>;
+  getSnapshot: SessionContextStore["getSnapshot"];
+};
+declare function createContextManager(params: {
+  dataDir: string;
+  sessionId: string;
+  sessionStoreName?: string;
+  sessionPathScope?: Pick<SessionPathOptions, "subagent">;
+}): Promise<ContextManager>;
+//#endregion
+//#region src/skills/skills.d.ts
+/** Resolves the skills directory path within a data directory */
+declare function skillsDir(dataDir: string): string;
+/** Represents a loaded skill */
+type Skill = {
+  name: string;
+  description: string;
+  location: string;
+  version: string;
+  skillFileMtime: string;
+};
+type SkillDirectory = {
+  skill: Skill;
+  rootDir: string;
+};
+type SkillViewResult = {
+  skill: Skill;
+  content: string;
+};
+/**
+ * Loads all installed skills from the skills directory.
+ * Each skill is a directory containing a SKILL.md file.
+ * Returns at most MAX_SKILLS_IN_PROMPT skills.
  */
 declare function loadSkills(dataDir: string): Promise<Skill[]>;
 declare function loadSkillsWithPluginDirs(dataDir: string, pluginDirs: string[], skillsLoadPaths?: string[]): Promise<Skill[]>;
@@ -560,6 +773,258 @@ declare function loadSkillView(dirs: string[], requestedName: string, skillPath?
  */
 declare function buildSkillsPrompt(skills: Skill[]): string;
 //#endregion
+//#region src/auto-skills/types.d.ts
+type AutoSkillSource = "auto";
+type AutoSkillStatus = "active" | "archived";
+type AutoSkillCategory = {
+  path: string;
+  name: string;
+  description: string;
+  createdBy?: string;
+};
+type AutoSkillIndexEntry = {
+  skillId: string;
+  name: string;
+  description: string;
+  categoryPath: string;
+  source: AutoSkillSource;
+  status: AutoSkillStatus;
+  rootDir: string;
+  skillDir: string;
+  skillFile: string;
+  metadataFile?: string;
+  tags: string[];
+  relatedSkills: string[];
+  confidence?: number;
+  createdAt?: string;
+  updatedAt?: string;
+};
+type AutoSkillListItem = {
+  skillId: string;
+  name: string;
+  description: string;
+  categoryPath: string;
+  source: AutoSkillSource;
+};
+type AutoSkillSearchResult = AutoSkillListItem & {
+  score: number;
+};
+type AutoSkillViewResult = AutoSkillListItem & {
+  status: AutoSkillStatus;
+  content: string;
+  path: string;
+  skillDir: string;
+  filePath?: string;
+  tags?: string[];
+  relatedSkills?: string[];
+};
+type AutoSkillsLoaderOptions = {
+  dataDir?: string;
+  rootDir?: string;
+  includeArchived?: boolean;
+  maxSkillBytes?: number;
+  maxResourceBytes?: number;
+};
+type AutoSkillListOptions = {
+  categoryPath?: string;
+  recursive?: boolean;
+};
+type AutoSkillSearchOptions = {
+  query: string;
+  limit?: number;
+};
+type AutoSkillViewOptions = {
+  skillId: string;
+  filePath?: string;
+};
+//#endregion
+//#region src/subagent/types.d.ts
+/** Status of a spawned subagent run */
+type SubagentStatus = "running" | "done" | "error" | "killed";
+/** Record tracking a single subagent run */
+type SubagentRunRecord = {
+  runId: string;
+  childSessionId: string;
+  parentSessionId: string;
+  task: string;
+  label?: string; /** Nesting depth: parent is depth N, child is N+1 */
+  depth: number;
+  status: SubagentStatus;
+  result?: string;
+  error?: string;
+  startedAt: number;
+  endedAt?: number; /** Used to cancel the subagent run */
+  abortController: AbortController;
+};
+//#endregion
+//#region src/subagent/registry.d.ts
+declare const MAX_SUBAGENT_DEPTH = 2;
+declare const MAX_CHILDREN_PER_SESSION = 5;
+/**
+ * In-memory registry for subagent runs scoped to a single parent runAgent call.
+ * Child spawns create their own SubagentRegistry instances for their children.
+ */
+declare class SubagentRegistry {
+  private readonly entries;
+  /** RunIds whose terminal result has already been delivered to the parent. */
+  private readonly announced;
+  register(record: SubagentRunRecord, promise: Promise<void>): void;
+  complete(runId: string, result: string): void;
+  fail(runId: string, error: string): void;
+  /** Aborts and marks a specific run as killed. Returns false if not found or already ended. */
+  kill(runId: string): boolean;
+  /** Aborts all running subagents for the given parent session. Returns count killed. */
+  killAll(parentSessionId: string): number;
+  /** Lists all runs registered for the given parent session. */
+  list(parentSessionId: string): SubagentRunRecord[];
+  /** Returns true if any subagents for this session are still running. */
+  hasPending(parentSessionId: string): boolean;
+  /** Count of currently running children for a session. */
+  countActive(parentSessionId: string): number;
+  /**
+   * Waits until all currently-running subagents for the given session settle.
+   * Returns immediately if nothing is pending.
+   */
+  waitForAll(parentSessionId: string): Promise<void>;
+  /**
+   * Returns all finished runs whose terminal result has not yet been delivered.
+   * This is a read-only snapshot; callers must explicitly mark delivery after
+   * the result has been handed back to the parent.
+   */
+  peekCompleted(parentSessionId: string): SubagentRunRecord[];
+  /**
+   * Returns all finished runs that have not yet been returned by this method,
+   * and marks them as announced so they are not returned again.
+   */
+  consumeCompleted(parentSessionId: string): SubagentRunRecord[];
+  /** Marks a finished run as already delivered to its parent. */
+  markAnnounced(runId: string | string[]): void;
+  /** Returns whether a run's terminal result has already been delivered. */
+  isAnnounced(runId: string): boolean;
+  /** Returns true if there are completed runs not yet returned by consumeCompleted. */
+  hasUnannounced(parentSessionId: string): boolean;
+  /**
+   * Returns true if the announce loop should run another iteration:
+   * either subagents are still running, or completed runs await announcement.
+   */
+  needsAnnounce(parentSessionId: string): boolean;
+  /** Checks whether a new child can be spawned given depth and active-children limits. */
+  checkSpawnAllowed(parentSessionId: string, depth: number): {
+    allowed: true;
+  } | {
+    allowed: false;
+    reason: string;
+  };
+  /** Returns the current status snapshot for a single run, or null if not found. */
+  getStatus(runId: string): SubagentStatus | null;
+  private logTerminalStatus;
+}
+//#endregion
+//#region src/plugins/types.d.ts
+type PluginDiagnostic = {
+  level: "warn" | "error";
+  message: string;
+  pluginId?: string;
+  source?: string;
+};
+type PluginOrigin = "bundled" | "global" | "workspace" | "config";
+type PluginKind = "memory";
+type PluginConfigUiHint = {
+  label?: string;
+  help?: string;
+  tags?: string[];
+  advanced?: boolean;
+  sensitive?: boolean;
+  placeholder?: string;
+};
+type PluginManifest = {
+  id: string;
+  configSchema: Record<string, unknown>;
+  kind?: PluginKind;
+  skills?: string[];
+  name?: string;
+  description?: string;
+  version?: string;
+  uiHints?: Record<string, PluginConfigUiHint>;
+};
+type PluginManifestLoadResult = {
+  ok: true;
+  manifest: PluginManifest;
+  manifestPath: string;
+} | {
+  ok: false;
+  error: string;
+  manifestPath: string;
+};
+type PluginCandidate = {
+  idHint: string;
+  source: string;
+  rootDir: string;
+  origin: PluginOrigin;
+  workspaceDir?: string;
+  packageName?: string;
+  packageVersion?: string;
+  packageDescription?: string;
+  packageDir?: string;
+  packageManifest?: AIMaxPackageManifest;
+};
+type AIMaxPackageManifest = {
+  extensions?: string[];
+};
+type PluginDiscoveryResult = {
+  candidates: PluginCandidate[];
+  diagnostics: PluginDiagnostic[];
+};
+//#endregion
+//#region src/plugins/manifest-registry.d.ts
+type PluginManifestRecord = {
+  id: string;
+  rootDir: string;
+  source: string;
+  origin: PluginCandidate["origin"];
+  manifestPath: string;
+  manifest: PluginManifest;
+};
+type PluginManifestRegistry = {
+  manifests: Map<string, PluginManifestRecord>;
+  diagnostics: PluginDiagnostic[];
+};
+declare function loadPluginManifestRegistry(candidates: PluginCandidate[]): PluginManifestRegistry;
+//#endregion
+//#region src/plugins/config-state.d.ts
+type PluginEntryConfig = {
+  enabled?: boolean;
+  config?: Record<string, unknown>;
+};
+type PluginsConfig = {
+  enabled?: boolean;
+  allow?: string[];
+  deny?: string[];
+  llmAllowlist?: string[];
+  load?: {
+    paths?: string[];
+  };
+  entries?: Record<string, PluginEntryConfig>;
+  slots?: Partial<Record<PluginKind, string>>;
+};
+type NormalizedPluginsConfig = {
+  enabled: boolean;
+  allow: string[];
+  deny: string[];
+  loadPaths: string[];
+  entries: Record<string, PluginEntryConfig>;
+  slots: Partial<Record<PluginKind, string>>;
+};
+type PluginsConfigValidationResult = {
+  ok: boolean;
+  diagnostics: PluginDiagnostic[];
+};
+declare function normalizePluginsConfig(input?: PluginsConfig): NormalizedPluginsConfig;
+declare function validatePluginsConfig(params: {
+  config: NormalizedPluginsConfig;
+  registry: PluginManifestRegistry;
+}): PluginsConfigValidationResult;
+//#endregion
 //#region src/agents/definitions.d.ts
 declare const SYSTEM_AGENTS_DIR = "/aimax/agents";
 type AgentConfigSource = "system" | "user" | "project";
@@ -680,7 +1145,7 @@ type AgentRunParamsBase = {
     maxTokens?: number; /** Flash model for lightweight tasks (e.g. title generation) */
     flashModel?: string;
   }; /** In-process progress callback */
-  onProgress?: (event: AgentProgressEvent$1) => Promise<void>; /** Execution timeout in milliseconds; defaults to 600000 (10 min) */
+  onProgress?: (event: AgentProgressEvent$1) => Promise<void>; /** Execution timeout in milliseconds; omitted means no agent-loop timeout */
   timeoutMs?: number; /** Present when this run is itself a subagent; controls depth limits */
   subagentContext?: SubagentContext; /** AbortSignal to cancel this run from outside (used by parent kill) */
   abortSignal?: AbortSignal; /** Structured HITL resume state injected by CLI resume path. */
@@ -732,7 +1197,20 @@ type AgentRunParamsBase = {
    * Older turns are dropped before the history is sent to the LLM.
    * 0 or undefined means no limit.
    */
-  historyLimit?: number; /** Optional IM-style topic segmentation prefilter. Enabled by default unless enabled=false. */
+  historyLimit?: number;
+  /**
+   * Optional session-scoped environment variables to inject into child processes
+   * spawned by the `exec` / `process` tools and exposed to plugin scripts via
+   * the plugin runtime context.
+   *
+   * Merge order (later entries win):
+   *   process.env < run-level `env` < per-call `exec.env` params
+   *
+   * The values are kept in memory only for the duration of the run; they are
+   * never written to disk and never cross a session boundary. Subagent runs
+   * inherit this map via the standard `subagent_spawn` plumbing.
+   */
+  env?: Record<string, string>; /** Optional IM-style topic segmentation prefilter. Enabled by default unless enabled=false. */
   topicSegmentation?: TopicSegmentationConfig;
   /**
    * Goal to create when this run establishes a new session (CLI `run --goal` without --session-id).
@@ -807,254 +1285,16 @@ type ToolResultEntry = {
  * `content` holds the summary text so it is accessible via the common
  * `.content` property without narrowing on `role`.
  */
-type CompactionEntry = {
-  role: "compaction"; /** Summary of the dropped conversation history */
-  content: string;
-  keptCount: number;
-  droppedCount: number;
-  timestamp: string;
-  source?: "cron";
-};
-/** Union of all persisted transcript entry types */
-type TranscriptEntry = UserEntry | AssistantEntry | ToolResultEntry | CompactionEntry;
-//#endregion
-//#region src/subagent/types.d.ts
-/** Status of a spawned subagent run */
-type SubagentStatus = "running" | "done" | "error" | "killed";
-/** Record tracking a single subagent run */
-type SubagentRunRecord = {
-  runId: string;
-  childSessionId: string;
-  parentSessionId: string;
-  task: string;
-  label?: string; /** Nesting depth: parent is depth N, child is N+1 */
-  depth: number;
-  status: SubagentStatus;
-  result?: string;
-  error?: string;
-  startedAt: number;
-  endedAt?: number; /** Used to cancel the subagent run */
-  abortController: AbortController;
-};
-//#endregion
-//#region src/subagent/registry.d.ts
-declare const MAX_SUBAGENT_DEPTH = 2;
-declare const MAX_CHILDREN_PER_SESSION = 5;
-/**
- * In-memory registry for subagent runs scoped to a single parent runAgent call.
- * Child spawns create their own SubagentRegistry instances for their children.
- */
-declare class SubagentRegistry {
-  private readonly entries;
-  /** RunIds whose terminal result has already been delivered to the parent. */
-  private readonly announced;
-  register(record: SubagentRunRecord, promise: Promise<void>): void;
-  complete(runId: string, result: string): void;
-  fail(runId: string, error: string): void;
-  /** Aborts and marks a specific run as killed. Returns false if not found or already ended. */
-  kill(runId: string): boolean;
-  /** Aborts all running subagents for the given parent session. Returns count killed. */
-  killAll(parentSessionId: string): number;
-  /** Lists all runs registered for the given parent session. */
-  list(parentSessionId: string): SubagentRunRecord[];
-  /** Returns true if any subagents for this session are still running. */
-  hasPending(parentSessionId: string): boolean;
-  /** Count of currently running children for a session. */
-  countActive(parentSessionId: string): number;
-  /**
-   * Waits until all currently-running subagents for the given session settle.
-   * Returns immediately if nothing is pending.
-   */
-  waitForAll(parentSessionId: string): Promise<void>;
-  /**
-   * Returns all finished runs whose terminal result has not yet been delivered.
-   * This is a read-only snapshot; callers must explicitly mark delivery after
-   * the result has been handed back to the parent.
-   */
-  peekCompleted(parentSessionId: string): SubagentRunRecord[];
-  /**
-   * Returns all finished runs that have not yet been returned by this method,
-   * and marks them as announced so they are not returned again.
-   */
-  consumeCompleted(parentSessionId: string): SubagentRunRecord[];
-  /** Marks a finished run as already delivered to its parent. */
-  markAnnounced(runId: string | string[]): void;
-  /** Returns whether a run's terminal result has already been delivered. */
-  isAnnounced(runId: string): boolean;
-  /** Returns true if there are completed runs not yet returned by consumeCompleted. */
-  hasUnannounced(parentSessionId: string): boolean;
-  /**
-   * Returns true if the announce loop should run another iteration:
-   * either subagents are still running, or completed runs await announcement.
-   */
-  needsAnnounce(parentSessionId: string): boolean;
-  /** Checks whether a new child can be spawned given depth and active-children limits. */
-  checkSpawnAllowed(parentSessionId: string, depth: number): {
-    allowed: true;
-  } | {
-    allowed: false;
-    reason: string;
-  };
-  /** Returns the current status snapshot for a single run, or null if not found. */
-  getStatus(runId: string): SubagentStatus | null;
-  private logTerminalStatus;
-}
-//#endregion
-//#region src/plugins/hooks.d.ts
-type PluginHookName = "before_model_resolve" | "before_prompt_build" | "after_prompt_build" | "llm_input" | "assistant_message_end" | "llm_output" | "before_tool_call" | "after_tool_call" | "agent_end" | "before_compaction" | "after_compaction" | "session_start" | "session_end" | "session_reset" | "dream_gate" | "memory_changed";
-type PluginHookAgentContext = {
-  agentId?: string;
-  sessionId?: string;
-  workspaceDir?: string;
-  channel?: AgentRunParams["channel"];
-};
-type PluginExecutionRuntime = {
-  eventDispatcher: {
-    dispatchProgress: (sessionId: string, event: AgentProgressEvent$1) => Promise<void>;
-  };
-};
-type PluginHookBeforeModelResolveEvent = {
-  prompt: string;
-};
-type PluginHookBeforeModelResolveResult = {
-  modelOverride?: string;
-};
-type PluginHookBeforePromptBuildEvent = {
-  prompt: string;
-};
-type PluginHookBeforePromptBuildResult = {
-  systemPrompt?: string;
-  prependContext?: string;
-};
-type PluginHookAfterPromptBuildEvent = {
-  prompt: string;
-  systemPrompt: string;
-};
-type PluginHookLlmInputEvent = {
-  sessionId: string;
-  model: string;
-  prompt: string;
-  historyMessages: unknown[];
-};
-type PluginHookAssistantMessageEndEvent = {
-  sessionId: string;
-  model: string;
-  assistantText: string;
-  assistantMessage: AssistantMessage;
-  hasToolCalls: boolean;
-  durationMs?: number;
-  usage?: {
-    input?: number;
-    output?: number;
-    total?: number;
-  };
-};
-type PluginHookLlmOutputEvent = {
-  sessionId: string;
-  model: string;
-  assistantTexts: string[];
-  lastAssistant?: AssistantMessage;
-  durationMs?: number;
-  usage?: {
-    input?: number;
-    output?: number;
-    total?: number;
-  };
-};
-type PluginHookBeforeToolCallEvent = {
-  toolCallId: string;
-  toolName: string;
-  params: Record<string, unknown>;
-};
-type PluginHookBeforeToolCallResult = {
-  params?: Record<string, unknown>;
-  block?: boolean;
-  blockReason?: string;
-};
-type PluginHookAfterToolCallEvent = {
-  toolCallId: string;
-  toolName: string;
-  params: Record<string, unknown>;
-  result?: unknown;
-  error?: string;
-  durationMs?: number;
-};
-type PluginHookAgentEndEvent = {
-  success: boolean;
-  error?: string;
-  durationMs?: number;
-};
-type PluginHookBeforeCompactionEvent = {
-  messageCount: number;
-  compactingCount?: number;
-};
-type PluginHookBeforeCompactionResult = {
-  skipPersist?: boolean;
-  injectRecall?: string;
-};
-type PluginHookAfterCompactionEvent = {
-  messageCount: number;
-  compactedCount: number;
-};
-type PluginHookSessionStartEvent = {
-  sessionId: string;
-};
-type PluginHookSessionEndEvent = {
-  sessionId: string;
-  messageCount: number;
-  durationMs?: number;
-};
-type PluginHookSessionResetEvent = {
-  action: "new" | "reset";
-  sessionId: string;
-  previousSessionId?: string;
-  message: string;
-};
-type PluginHookDreamGateEvent = {
-  dataDir: string;
-  memoryDir: string;
-  providerId: string;
-  pluginId?: string;
-  trigger: "cli" | "cron";
-  dryRun?: boolean;
-};
-type PluginHookDreamGateResult = {
-  handled?: boolean;
-  status?: "noop" | "completed" | "queued" | "failed";
-  summary?: string;
-  details?: Record<string, unknown>;
-};
-type PluginHookMemoryChangedEvent = MemoryChangedEvent;
-type PluginHookHandlerMap = {
-  before_model_resolve: (event: PluginHookBeforeModelResolveEvent, ctx: PluginHookAgentContext) => PluginHookBeforeModelResolveResult | void | Promise<PluginHookBeforeModelResolveResult | void>;
-  before_prompt_build: (event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext) => PluginHookBeforePromptBuildResult | void | Promise<PluginHookBeforePromptBuildResult | void>;
-  after_prompt_build: (event: PluginHookAfterPromptBuildEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  llm_input: (event: PluginHookLlmInputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  assistant_message_end: (event: PluginHookAssistantMessageEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  llm_output: (event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  before_tool_call: (event: PluginHookBeforeToolCallEvent, ctx: PluginHookAgentContext) => PluginHookBeforeToolCallResult | void | Promise<PluginHookBeforeToolCallResult | void>;
-  after_tool_call: (event: PluginHookAfterToolCallEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  agent_end: (event: PluginHookAgentEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  before_compaction: (event: PluginHookBeforeCompactionEvent, ctx: PluginHookAgentContext) => PluginHookBeforeCompactionResult | void | Promise<PluginHookBeforeCompactionResult | void>;
-  after_compaction: (event: PluginHookAfterCompactionEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  session_start: (event: PluginHookSessionStartEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  session_end: (event: PluginHookSessionEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  session_reset: (event: PluginHookSessionResetEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-  dream_gate: (event: PluginHookDreamGateEvent, ctx: PluginHookAgentContext) => PluginHookDreamGateResult | void | Promise<PluginHookDreamGateResult | void>;
-  memory_changed: (event: PluginHookMemoryChangedEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
-};
-type PluginHookRegistration<K extends PluginHookName = PluginHookName> = {
-  pluginId: string;
-  hookName: K;
-  handler: PluginHookHandlerMap[K];
-  priority?: number;
-  source: string;
+type CompactionEntry = {
+  role: "compaction"; /** Summary of the dropped conversation history */
+  content: string;
+  keptCount: number;
+  droppedCount: number;
+  timestamp: string;
+  source?: "cron";
 };
-declare class PluginHookRegistry {
-  private readonly hooks;
-  register<K extends PluginHookName>(registration: PluginHookRegistration<K>): void;
-  dispatch<K extends PluginHookName>(hookName: K, event: Parameters<PluginHookHandlerMap[K]>[0], ctx: Parameters<PluginHookHandlerMap[K]>[1], runtime?: PluginExecutionRuntime): Promise<Array<Awaited<ReturnType<PluginHookHandlerMap[K]>>>>;
-}
+/** Union of all persisted transcript entry types */
+type TranscriptEntry = UserEntry | AssistantEntry | ToolResultEntry | CompactionEntry;
 //#endregion
 //#region src/runner/title.d.ts
 type GenerateTitleParams = {
@@ -1086,155 +1326,6 @@ declare function appendSessionFile(filePath: string, line: string, encrypt?: boo
 declare function atomicWriteSessionFile(filePath: string, content: string, encrypt?: boolean): Promise<void>;
 declare function readSessionFileContent(filePath: string): Promise<string | null>;
 //#endregion
-//#region src/context/session-context-store.d.ts
-type PersistedToolResult = {
-  content: string;
-  reference?: ToolResultReference;
-};
-type SessionContextStore = {
-  findReusableRead(path: string, offset?: number, limit?: number): Promise<ReadStateRecord | null>;
-  recordRead(params: {
-    path: string;
-    content: string;
-    lineCount: number;
-    offset?: number;
-    limit?: number;
-  }): Promise<ReadStateRecord>;
-  invalidatePath(path: string): Promise<void>;
-  persistToolResult(params: {
-    toolCallId: string;
-    toolName: string;
-    content: string;
-    thresholdChars?: number;
-    previewChars?: number;
-  }): Promise<PersistedToolResult>;
-  recordSnip(record: SnipRecord): Promise<void>;
-  recordCollapse(span: CollapseSpan): Promise<void>;
-  setSessionMemory(snapshot: SessionMemorySnapshot): Promise<void>;
-  recordModelUsage(checkpoint: ModelUsageCheckpoint): Promise<void>;
-  recordAutocompactResult(params: {
-    layer: "L6";
-    failed: boolean;
-    timestamp: string;
-  }): Promise<void>;
-  getSnapshot(): SessionContextSnapshot;
-};
-type SessionContextStoreOptions = {
-  dataDir: string;
-  sessionId: string;
-} & SessionPathOptions;
-declare function createSessionContextStore(options: SessionContextStoreOptions): Promise<SessionContextStore>;
-//#endregion
-//#region src/context/context-manager.d.ts
-type ManageLayeredHistoryParams = {
-  entries: TranscriptEntry[];
-  modelInfo: {
-    model: string;
-    api: string;
-  };
-  contextWindowTokens: number;
-  llm: Pick<AgentRunParams["llm"], "apiFormat" | "baseUrl" | "apiKey" | "model" | "flashModel">;
-  historyLimit?: number;
-  compactionEnabled?: boolean;
-  pendingUserMessage?: string;
-  topicSegmentation?: TopicSegmentationConfig;
-  signal?: AbortSignal;
-  hooks?: PluginHookRegistry;
-  hookCtx?: PluginHookAgentContext;
-  contextStore?: SessionContextStore;
-  dataDir?: string;
-  sessionId?: string;
-  sessionStoreName?: string;
-  sessionPathScope?: Pick<SessionPathOptions, "subagent">;
-  channel?: Channel$1;
-  isSubagent?: boolean;
-};
-type ManageLayeredHistoryResult = {
-  messages: AgentMessage[];
-  priorSummary: string | undefined;
-  compactionEntry: CompactionEntry | undefined;
-  stats: {
-    originalCount: number;
-    keptCount: number;
-    estimatedTokens: number;
-    compacted: boolean;
-  };
-  compactionEvents: AgentProgressEvent$1[];
-};
-type ContextManager = {
-  getReusableRead(path: string, offset?: number, limit?: number): Promise<{
-    reused: boolean;
-    lineCount?: number;
-  }>;
-  rememberRead(params: {
-    path: string;
-    content: string;
-    lineCount: number;
-    offset?: number;
-    limit?: number;
-  }): Promise<void>;
-  invalidateReadPath(path: string): Promise<void>;
-  persistToolResult(params: {
-    toolCallId: string;
-    toolName: string;
-    content: string;
-    thresholdChars?: number;
-    previewChars?: number;
-  }): Promise<PersistedToolResult>;
-  recordModelUsage(params: {
-    model: string;
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    coveredTranscriptEntryCount: number;
-  }): Promise<void>;
-  manageHistory(params: Omit<ManageLayeredHistoryParams, "contextStore">): Promise<ManageLayeredHistoryResult>;
-  getSnapshot: SessionContextStore["getSnapshot"];
-};
-declare function createContextManager(params: {
-  dataDir: string;
-  sessionId: string;
-  sessionStoreName?: string;
-  sessionPathScope?: Pick<SessionPathOptions, "subagent">;
-}): Promise<ContextManager>;
-//#endregion
-//#region src/bootstrap/bootstrap.d.ts
-/** Maximum characters per bootstrap file before truncation */
-declare const BOOTSTRAP_MAX_CHARS = 20000;
-/** Maximum total characters across all bootstrap files */
-declare const BOOTSTRAP_TOTAL_MAX_CHARS = 150000;
-/** Names of bootstrap identity files, in injection order */
-declare const BOOTSTRAP_FILE_NAMES: readonly ["AGENTS.md", "SOUL.md", "TOOLS.md", "IDENTITY.md", "USER.md", "MEMORY.md", "BOOTSTRAP.md"];
-/** A loaded (or missing) bootstrap file */
-type BootstrapFile = {
-  name: string;
-  path: string;
-  content: string | null;
-  missing: boolean;
-};
-/** A bootstrap file ready for system prompt injection */
-type BootstrapContextFile = {
-  path: string;
-  content: string;
-};
-/** Resolves the base .aimax directory within a data directory */
-declare function aimaxDir(dataDir: string): string;
-/**
- * Loads all standard bootstrap identity files from the .aimax directory.
- * Missing files are included as `missing: true` entries.
- * BOOTSTRAP.md is deleted after loading (one-time use).
- */
-declare function loadBootstrapFiles(dataDir: string): Promise<BootstrapFile[]>;
-/**
- * Converts loaded bootstrap files into context file entries for system prompt injection.
- * Applies per-file and total character budget limits.
- */
-declare function buildBootstrapContextFiles(files: BootstrapFile[], opts?: {
-  maxChars?: number;
-  totalMaxChars?: number;
-  warn?: (message: string) => void;
-}): BootstrapContextFile[];
-//#endregion
 //#region src/bootstrap/bootstrap-layout.d.ts
 type BootstrapMountResult = {
   dataDir: string;
@@ -1393,71 +1484,6 @@ declare function resetMemoryProviderRegistryForTests(): void;
 //#region src/auto-skills/paths.d.ts
 declare function autoSkillsDir(dataDir: string): string;
 //#endregion
-//#region src/auto-skills/types.d.ts
-type AutoSkillSource = "auto";
-type AutoSkillStatus = "active" | "archived";
-type AutoSkillCategory = {
-  path: string;
-  name: string;
-  description: string;
-  createdBy?: string;
-};
-type AutoSkillIndexEntry = {
-  skillId: string;
-  name: string;
-  description: string;
-  categoryPath: string;
-  source: AutoSkillSource;
-  status: AutoSkillStatus;
-  rootDir: string;
-  skillDir: string;
-  skillFile: string;
-  metadataFile?: string;
-  tags: string[];
-  relatedSkills: string[];
-  confidence?: number;
-  createdAt?: string;
-  updatedAt?: string;
-};
-type AutoSkillListItem = {
-  skillId: string;
-  name: string;
-  description: string;
-  categoryPath: string;
-  source: AutoSkillSource;
-};
-type AutoSkillSearchResult = AutoSkillListItem & {
-  score: number;
-};
-type AutoSkillViewResult = AutoSkillListItem & {
-  status: AutoSkillStatus;
-  content: string;
-  path: string;
-  skillDir: string;
-  filePath?: string;
-  tags?: string[];
-  relatedSkills?: string[];
-};
-type AutoSkillsLoaderOptions = {
-  dataDir?: string;
-  rootDir?: string;
-  includeArchived?: boolean;
-  maxSkillBytes?: number;
-  maxResourceBytes?: number;
-};
-type AutoSkillListOptions = {
-  categoryPath?: string;
-  recursive?: boolean;
-};
-type AutoSkillSearchOptions = {
-  query: string;
-  limit?: number;
-};
-type AutoSkillViewOptions = {
-  skillId: string;
-  filePath?: string;
-};
-//#endregion
 //#region src/auto-skills/loader.d.ts
 declare function createAutoSkillsLoader(options: AutoSkillsLoaderOptions): AutoSkillsLoader;
 declare class AutoSkillsLoader {
@@ -1835,18 +1861,6 @@ declare function createMemoryUpdateTool(dataDir: string, options?: MemoryToolOpt
   id: string;
 }>;
 //#endregion
-//#region src/runner/event-dispatcher.d.ts
-type EventDispatchParams = Pick<AgentRunParams, "onProgress" | "messageId" | "channel" | "subagentContext">;
-/**
- * Emits runner events to in-process listeners.
- */
-declare class RunEventDispatcher {
-  private readonly params;
-  constructor(params: EventDispatchParams);
-  dispatchProgress(sessionId: string, event: AgentProgressEvent$2): Promise<void>;
-  dispatchDiagnostic(sessionId: string, event: Omit<AgentDiagnosticEvent, keyof AgentProgressEventBase | "type">): Promise<void>;
-}
-//#endregion
 //#region src/tools/process-registry.d.ts
 type ProcessStatus = "running" | "completed" | "failed" | "killed" | "timeout";
 type ProcessSessionSnapshot = {
@@ -1889,6 +1903,12 @@ type ProcessStartParams = {
   command: string;
   cwd: string;
   env?: Record<string, string>;
+  /**
+   * Run-level baseline env, applied after `process.env` but before `env`.
+   * Used to carry session-scoped env from the AgentRunParams through to
+   * the spawned child process.
+   */
+  baseEnv?: Record<string, string>;
   timeoutSec: number;
   scopeKey?: string;
 };
@@ -1923,6 +1943,12 @@ type ExecToolOptions = {
   scopeKey?: string;
   contextManager?: ContextManager;
   hitlResume?: AgentRunParams["hitlResume"];
+  /**
+   * Run-level baseline environment variables, applied after `process.env`
+   * but before any per-call `params.env`. Used to carry session-scoped
+   * env from `AgentRunParams.env` to the spawned child process.
+   */
+  baseEnv?: Record<string, string>;
 };
 declare function createExecTool(options: ExecToolOptions): AgentTool<typeof execSchema, Record<string, unknown>>;
 //#endregion
@@ -2153,7 +2179,7 @@ type BatchSpawnResult = {
   status: "done" | "partial_error" | "error";
   results: BatchSpawnItemResult[];
 };
-type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy" | "projectDir" | "env">;
 /** Formats the announce message injected into the parent session when a subagent completes. */
 declare function buildSubagentAnnounceMessage(params: {
   task: string;
@@ -2300,7 +2326,7 @@ type SubagentToolsContext = {
   depth: number;
   channel: AgentRunParams["channel"];
   llm: AgentRunParams["llm"];
-  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy" | "projectDir" | "env">;
   loopDetection?: ToolLoopDetectionConfig;
   autoSkillsLoadEnabled?: boolean;
   memoryOptions?: MemoryToolOptions;
@@ -2313,6 +2339,11 @@ type SubagentToolsContext = {
   hitlResume?: AgentRunParams["hitlResume"];
   eventDispatcher?: RunEventDispatcher; /** Callback that runs a child agent; injected to avoid circular imports */
   spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>;
+  /**
+   * Run-level baseline env applied to every spawned child process. Sourced
+   * from `AgentRunParams.env` and inherited by subagent runs.
+   */
+  baseEnv?: Record<string, string>;
 };
 /**
  * Creates the full set of agent tools for a given data directory.
@@ -2448,9 +2479,22 @@ type PluginRuntime = {
       error: (message: string) => void;
     };
   };
+  /**
+   * Read-only view of session-scoped state. Exposed to plugins so they can
+   * discover per-run configuration (e.g. environment variables passed via
+   * `AgentRunParams.env`) without re-plumbing the data through config.
+   */
+  session: {
+    env: Record<string, string>;
+  };
 };
 type CreatePluginRuntimeOptions = {
   pluginId: string;
+  /**
+   * Session-scoped env map mirrored from the current run. Frozen to
+   * prevent plugins from mutating shared state.
+   */
+  env?: Record<string, string>;
 };
 declare function createPluginRuntime(options: CreatePluginRuntimeOptions): PluginRuntime;
 //#endregion
@@ -2501,6 +2545,16 @@ type PluginRuntimeContext = {
   };
   hookCtx?: PluginHookAgentContext;
   llmAllowlist?: string[];
+  /**
+   * Session-scoped environment variables supplied via `AgentRunParams.env`.
+   * Plugins that spawn child processes (e.g. via the `exec` tool) should
+   * merge this map into the child process environment. Plugins may also
+   * read values from this map to discover session-scoped configuration.
+   *
+   * The map is held in memory only for the duration of the run and is
+   * never written to disk; it does not cross session boundaries.
+   */
+  env?: Record<string, string>;
 };
 //#endregion
 //#region src/plugins/loader.d.ts