@gencode/agents 0.0.11 → 0.0.13

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { S as AgentsConfig, _ as saveAgentsConfig, a as listAgents, b as AgentConfig, c as normalizeAgentId, d as resolveAgentDir, f as resolveAgentIdByBinding, g as resolveModelString, h as resolveModelFallbacks, i as getAgentConfig, l as removeAgent, m as resolveDefaultAgentId, n as addBinding, o as listBindings, p as resolveAgentsConfigPath, s as loadAgentsConfig, t as addAgent, u as removeBindings, v as updateAgentIdentity, x as AgentModelConfig, y as AgentBinding } from "./index-BdfpRxFA.js";
 import { AssistantMessage, Message } from "@mariozechner/pi-ai";
-import { AgentTool } from "@mariozechner/pi-agent-core";
-import { AgentProgressEvent, AgentProgressEvent as AgentProgressEvent$1, CallbackEventPayload, CallbackEventPayload as CallbackEventPayload$1, Channel, Channel as Channel$1, RunResultPayload, RunResultPayload as RunResultPayload$1 } from "@gencode/shared";
+import { AgentMessage, AgentTool } from "@mariozechner/pi-agent-core";
+import { AgentProgressEvent, AgentProgressEvent as AgentProgressEvent$1, CallbackEventPayload, CallbackEventPayload as CallbackEventPayload$1, Channel, Channel as Channel$1, CollapseSpan, ReadStateRecord, RunResultPayload, RunResultPayload as RunResultPayload$1, SessionContextSnapshot, SessionMemorySnapshot, SnipRecord, ToolResultReference } from "@gencode/shared";
 
 //#region src/loop-detection/tool-loop-detection.d.ts
 type ToolLoopDetectionConfig = {
@@ -212,6 +212,7 @@ type ToolResultEntry = {
   toolName: string; /** Text output of the tool */
   content: string;
   isError: boolean;
+  toolResultRef?: ToolResultReference;
   timestamp: string;
 };
 /**
@@ -546,6 +547,33 @@ type SessionSummary = {
   createdAt: string;
   updatedAt: string;
 };
+type SessionInspection = {
+  id: string;
+  metadata: SessionMetadata | 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 | null;
+  transcript: TranscriptEntry[];
+  context: SessionContextSnapshot;
+  paths: {
+    transcriptPath: string;
+    contextSnapshotPath: string;
+    sessionMemoryPath: string;
+    collapseLogPath: string;
+    toolResultsDir: string;
+  };
+};
 /** Resolves the sessions directory path within a data directory */
 declare function sessionsDir(dataDir: string): string;
 /** Resolves the directory for a specific session */
@@ -554,6 +582,12 @@ declare function sessionDir(dataDir: string, sessionId: string): string;
 declare function transcriptPath(dataDir: string, sessionId: string): string;
 /** Resolves the metadata file path for a session */
 declare function metadataPath(dataDir: string, sessionId: string): string;
+/** Resolves the persisted context snapshot path for a session */
+declare function contextSnapshotPath(dataDir: string, sessionId: string): string;
+declare function sessionMemoryPath(dataDir: string, sessionId: string): string;
+declare function collapseLogPath(dataDir: string, sessionId: string): string;
+/** Resolves the persisted tool-results directory for a session */
+declare function toolResultsDir(dataDir: string, sessionId: string): string;
 /** Creates a new session with a generated ID */
 declare function createSession(dataDir: string, channel: Channel): Promise<string>;
 /** Ensures a session directory exists (for resuming an existing session) */
@@ -574,6 +608,240 @@ declare function saveSessionMetadata(dataDir: string, metadata: SessionMetadata)
 declare function loadSessionMetadata(dataDir: string, sessionId: string): Promise<SessionMetadata | null>;
 /** Lists all sessions with their metadata summaries, optionally filtered by channel */
 declare function listSessionSummaries(dataDir: string, channel?: Channel): Promise<SessionSummary[]>;
+declare function loadSessionContextSnapshot(dataDir: string, sessionId: string): Promise<SessionContextSnapshot>;
+declare function inspectSession(dataDir: string, sessionId: string): Promise<SessionInspection>;
+declare function exportSession(dataDir: string, sessionId: string): Promise<SessionExport>;
+//#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" | "memory_changed";
+type PluginHookAgentContext = {
+  agentId?: string;
+  sessionId?: string;
+  workspaceDir?: string;
+  channel?: AgentRunParams["channel"];
+};
+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;
+  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 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 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) => void | Promise<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>;
+  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]): Promise<Array<Awaited<ReturnType<PluginHookHandlerMap[K]>>>>;
+}
+//#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>;
+  recordAutocompactResult(params: {
+    layer: "L6";
+    failed: boolean;
+    timestamp: string;
+  }): Promise<void>;
+  getSnapshot(): SessionContextSnapshot;
+};
+type SessionContextStoreOptions = {
+  dataDir: string;
+  sessionId: string;
+};
+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: {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+  };
+  historyLimit?: number;
+  compactionEnabled?: boolean;
+  signal?: AbortSignal;
+  hooks?: PluginHookRegistry;
+  hookCtx?: PluginHookAgentContext;
+  contextStore?: SessionContextStore;
+  dataDir?: string;
+  sessionId?: string;
+};
+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>;
+  manageHistory(params: Omit<ManageLayeredHistoryParams, "contextStore">): Promise<ManageLayeredHistoryResult>;
+  getSnapshot: SessionContextStore["getSnapshot"];
+};
+declare function createContextManager(params: {
+  dataDir: string;
+  sessionId: string;
+}): Promise<ContextManager>;
 //#endregion
 //#region src/bootstrap/bootstrap.d.ts
 /** Maximum characters per bootstrap file before truncation */
@@ -631,6 +899,7 @@ type BootstrapEnsureResult = {
   performedBootstrap: boolean;
   result?: BootstrapMountResult;
 };
+declare function hasBootstrapSentinel(dataDir: string): Promise<boolean>;
 declare function inspectBootstrapMountLayout(dataDir: string): Promise<BootstrapMountStatus>;
 declare function isBootstrapMountLayoutReady(dataDir: string): Promise<boolean>;
 declare function ensureBootstrapMountLayout(dataDir: string): Promise<BootstrapEnsureResult>;
@@ -1064,6 +1333,8 @@ type ProcessSessionSnapshot = {
   exitCode?: number | null;
   exitSignal?: NodeJS.Signals | null;
   outputTail: string;
+  stdoutTail: string;
+  stderrTail: string;
   outputTruncated: boolean;
 };
 type ProcessLogSlice = {
@@ -1076,6 +1347,16 @@ type ProcessLogSlice = {
   exitCode?: number | null;
   exitSignal?: NodeJS.Signals | null;
 };
+type ProcessOutput = {
+  sessionId: string;
+  status: ProcessStatus;
+  stdout: string;
+  stderr: string;
+  combined: string;
+  truncated: boolean;
+  exitCode?: number | null;
+  exitSignal?: NodeJS.Signals | null;
+};
 type ProcessStartParams = {
   command: string;
   cwd: string;
@@ -1094,6 +1375,7 @@ type ProcessRegistry = {
     offset?: number;
     limit?: number;
   }): ProcessLogSlice | null;
+  readOutput(sessionId: string, scopeKey?: string): ProcessOutput | null;
   terminate(sessionId: string, scopeKey?: string): Promise<ProcessSessionSnapshot | null>;
 };
 //#endregion
@@ -1110,6 +1392,7 @@ type ExecToolOptions = {
   workspaceDir: string;
   registry: ProcessRegistry;
   scopeKey?: string;
+  contextManager?: ContextManager;
 };
 declare function createExecTool(options: ExecToolOptions): AgentTool<typeof execSchema, Record<string, unknown>>;
 //#endregion
@@ -1145,12 +1428,12 @@ type ReadFileResult = {
   lines: number;
   truncated: boolean;
 };
-declare function createReadFileTool(workspaceDir: string): AgentTool<typeof readFileSchema, ReadFileResult>;
+declare function createReadFileTool(workspaceDir: string, contextManager?: ContextManager): AgentTool<typeof readFileSchema, ReadFileResult>;
 declare const writeFileSchema: TObject<{
   path: TString;
   content: TString;
 }>;
-declare function createWriteFileTool(workspaceDir: string): AgentTool<typeof writeFileSchema, {
+declare function createWriteFileTool(workspaceDir: string, contextManager?: ContextManager): AgentTool<typeof writeFileSchema, {
   path: string;
 }>;
 declare const editFileSchema: TObject<{
@@ -1158,7 +1441,7 @@ declare const editFileSchema: TObject<{
   old_string: TString;
   new_string: TString;
 }>;
-declare function createEditFileTool(workspaceDir: string): AgentTool<typeof editFileSchema, {
+declare function createEditFileTool(workspaceDir: string, contextManager?: ContextManager): AgentTool<typeof editFileSchema, {
   path: string;
   occurrences: number;
 }>;
@@ -1233,7 +1516,7 @@ declare function buildSubagentAnnounceMessage(params: {
  * @param loopDetection  Tool-loop detection config inherited from the parent.
  * @param spawnFn  Function that actually runs a child agent (injected to avoid circular imports).
  */
-declare function createSessionsSpawnTool(registry: SubagentRegistry, parentSessionId: string, depth: number, dataDir: string, channel: AgentRunParams["channel"], llm: AgentRunParams["llm"], loopDetection: ToolLoopDetectionConfig | undefined, inheritedRunParams: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "docs" | "historyLimit">, spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>): AgentTool<typeof spawnSchema, SpawnResult>;
+declare function createSessionsSpawnTool(registry: SubagentRegistry, parentSessionId: string, depth: number, dataDir: string, channel: AgentRunParams["channel"], llm: AgentRunParams["llm"], loopDetection: ToolLoopDetectionConfig | undefined, inheritedRunParams: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "docs" | "historyLimit" | "onProgress" | "messageId">, spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>): AgentTool<typeof spawnSchema, SpawnResult>;
 //#endregion
 //#region src/tools/subagents.d.ts
 declare const ACTIONS: readonly ["list", "kill"];
@@ -1270,9 +1553,10 @@ type SubagentToolsContext = {
   depth: number;
   channel: AgentRunParams["channel"];
   llm: AgentRunParams["llm"];
-  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "docs" | "historyLimit">;
+  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "docs" | "historyLimit" | "onProgress" | "messageId">;
   loopDetection?: ToolLoopDetectionConfig;
-  memoryOptions?: MemoryToolOptions; /** Callback that runs a child agent; injected to avoid circular imports */
+  memoryOptions?: MemoryToolOptions;
+  contextManager?: ContextManager; /** Callback that runs a child agent; injected to avoid circular imports */
   spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>;
 };
 /**
@@ -1327,137 +1611,6 @@ declare const PLUGIN_MANIFEST_FILENAMES: readonly ["aimax.plugin.json"];
 declare function resolvePluginManifestPath(rootDir: string): string;
 declare function loadPluginManifest(rootDir: string, rejectHardlinks?: boolean): PluginManifestLoadResult;
 //#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" | "memory_changed";
-type PluginHookAgentContext = {
-  agentId?: string;
-  sessionId?: string;
-  workspaceDir?: string;
-  channel?: AgentRunParams["channel"];
-};
-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;
-  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 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 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) => void | Promise<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>;
-  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]): Promise<Array<Awaited<ReturnType<PluginHookHandlerMap[K]>>>>;
-}
-//#endregion
 //#region src/plugins/tools.d.ts
 type PluginToolOptions = {
   optional?: boolean;
@@ -1602,4 +1755,4 @@ declare function initializePluginSystem(options?: PluginSystemOptions): PluginSy
 //#region src/plugins/tool-hooks.d.ts
 declare function wrapToolsWithHooks(tools: AgentTool[], hooks: PluginHookRegistry, ctx: PluginHookAgentContext): AgentTool[];
 //#endregion
-export { AgentBinding, AgentConfig, AgentModelConfig, type AgentProgressEvent, type AgentRunParams, type AgentRunResult, AgentsConfig, BOOTSTRAP_FILE_NAMES, BOOTSTRAP_MAX_CHARS, BOOTSTRAP_TOTAL_MAX_CHARS, type BootstrapContextFile, type BootstrapEnsureResult, type BootstrapFile, type BootstrapMountResult, type BootstrapMountStatus, type CallbackEventPayload, type CallbackPayload, type Channel, type EmbeddingProvider, type EmbeddingProviderContext, type EmbeddingProviderFactory, type EmbeddingProviderRegistration, MAX_CHILDREN_PER_SESSION, MAX_SUBAGENT_DEPTH, type MemoryCallOptions, type MemoryChangeSource, type MemoryChangedEvent, type MemoryChangedHandler, MemoryIndexManager, type MemoryProvider, type MemoryProviderContext, type MemoryProviderFactory, type MemoryProviderRegistration, type MemoryProviderStatus, type MemorySearchOptions, type MemorySearchResult, type NormalizedPluginsConfig, PLUGIN_MANIFEST_FILENAME, PLUGIN_MANIFEST_FILENAMES, type PersistedSubagentRunRecord, type PluginApi, type PluginCandidate, type PluginConfigUiHint, type PluginDiagnostic, type PluginDiscoveryOptions, type PluginDiscoveryResult, type PluginEntryConfig, type PluginHookAfterCompactionEvent, type PluginHookAfterPromptBuildEvent, type PluginHookAfterToolCallEvent, type PluginHookAgentContext, type PluginHookAgentEndEvent, type PluginHookAssistantMessageEndEvent, type PluginHookBeforeCompactionEvent, type PluginHookBeforeModelResolveEvent, type PluginHookBeforeModelResolveResult, type PluginHookBeforePromptBuildEvent, type PluginHookBeforePromptBuildResult, type PluginHookBeforeToolCallEvent, type PluginHookBeforeToolCallResult, type PluginHookHandlerMap, type PluginHookLlmInputEvent, type PluginHookLlmOutputEvent, type PluginHookMemoryChangedEvent, type PluginHookName, PluginHookRegistry, type PluginHookSessionEndEvent, type PluginHookSessionResetEvent, type PluginHookSessionStartEvent, type PluginKind, type PluginManifest, type PluginManifestLoadResult, type PluginManifestRegistry, type PluginOrigin, type PluginRecord, type PluginRegistry, type PluginRuntime, type PluginRuntimeContext, type PluginSystem, type PluginSystemOptions, type PluginToolOptions, PluginToolRegistry, type PluginsConfig, type PluginsConfigValidationResult, type RegisteredPluginTool, type RunResultPayload, type SessionMetadata, type SessionSummary, type Skill, type SlashCommandList, type SubagentContext, SubagentRegistry, type SubagentRunRecord, type SubagentStatus, type SubagentToolsContext, type SystemPromptParams, type ToolLoopDetectionConfig, type TranscriptEntry, addAgent, addBinding, aimaxDir, appendToMemory, appendTranscriptEntry, bootstrapMountLayout, buildBootstrapContextFiles, buildSkillsPrompt, buildSubagentAnnounceMessage, buildSystemPrompt, cleanupOldSubagentRecords, createAgentTools, createApplyPatchTool, createBashTool, createBuiltinMemoryProvider, createEditFileTool, createExecTool, createImageTool, createListDirTool, createMemoryAppendTool, createMemoryGetTool, createMemorySearchTool, createPluginRuntime, createProcessTool, createReadFileTool, createSession, createSessionsSpawnTool, createSubagentsTool, createWriteFileTool, deleteMemoryFile, discoverAIMaxPlugins, ensureBootstrapMountLayout, ensureSession, generateSessionTitle, getAgentConfig, getMemoryLines, initializePluginSystem, inspectBootstrapMountLayout, isBootstrapMountLayoutReady, listAgents, listAvailableSlashCommands, listBindings, listMemoryFiles, listSessionSummaries, listSessions, listSubagentRunsFromDisk, loadAgentsConfig, loadBootstrapFiles, loadPluginManifest, loadPluginManifestRegistry, loadPlugins, loadSessionMetadata, loadSkills, loadSkillsFromDirs, loadSkillsWithPluginDirs, loadSubagentRegistryFromDisk, loadTranscript, memoryDir, metadataPath, normalizeAgentId, normalizePluginsConfig, primaryMemoryPath, readMemoryFile, readPrimaryMemory, registerEmbeddingProvider, registerMemoryProvider, removeAgent, removeBindings, replaceMemoryFile, resetEmbeddingProviderRegistryForTests, resetMemoryProviderRegistryForTests, resolveAgentDir, resolveAgentIdByBinding, resolveAgentsConfigPath, resolveDefaultAgentId, resolveEmbeddingProvider, resolveMemoryProvider, resolveModelFallbacks, resolveModelString, resolvePluginManifestPath, runAgent, saveAgentsConfig, saveSessionMetadata, saveSubagentRegistryToDisk, searchMemory, sessionDir, sessionsDir, skillsDir, transcriptPath, updateAgentIdentity, validatePluginsConfig, wrapToolsWithHooks };
+export { AgentBinding, AgentConfig, AgentModelConfig, type AgentProgressEvent, type AgentRunParams, type AgentRunResult, AgentsConfig, BOOTSTRAP_FILE_NAMES, BOOTSTRAP_MAX_CHARS, BOOTSTRAP_TOTAL_MAX_CHARS, type BootstrapContextFile, type BootstrapEnsureResult, type BootstrapFile, type BootstrapMountResult, type BootstrapMountStatus, type CallbackEventPayload, type CallbackPayload, type Channel, type ContextManager, type EmbeddingProvider, type EmbeddingProviderContext, type EmbeddingProviderFactory, type EmbeddingProviderRegistration, MAX_CHILDREN_PER_SESSION, MAX_SUBAGENT_DEPTH, type MemoryCallOptions, type MemoryChangeSource, type MemoryChangedEvent, type MemoryChangedHandler, MemoryIndexManager, type MemoryProvider, type MemoryProviderContext, type MemoryProviderFactory, type MemoryProviderRegistration, type MemoryProviderStatus, type MemorySearchOptions, type MemorySearchResult, type NormalizedPluginsConfig, PLUGIN_MANIFEST_FILENAME, PLUGIN_MANIFEST_FILENAMES, type PersistedSubagentRunRecord, type PersistedToolResult, type PluginApi, type PluginCandidate, type PluginConfigUiHint, type PluginDiagnostic, type PluginDiscoveryOptions, type PluginDiscoveryResult, type PluginEntryConfig, type PluginHookAfterCompactionEvent, type PluginHookAfterPromptBuildEvent, type PluginHookAfterToolCallEvent, type PluginHookAgentContext, type PluginHookAgentEndEvent, type PluginHookAssistantMessageEndEvent, type PluginHookBeforeCompactionEvent, type PluginHookBeforeModelResolveEvent, type PluginHookBeforeModelResolveResult, type PluginHookBeforePromptBuildEvent, type PluginHookBeforePromptBuildResult, type PluginHookBeforeToolCallEvent, type PluginHookBeforeToolCallResult, type PluginHookHandlerMap, type PluginHookLlmInputEvent, type PluginHookLlmOutputEvent, type PluginHookMemoryChangedEvent, type PluginHookName, PluginHookRegistry, type PluginHookSessionEndEvent, type PluginHookSessionResetEvent, type PluginHookSessionStartEvent, type PluginKind, type PluginManifest, type PluginManifestLoadResult, type PluginManifestRegistry, type PluginOrigin, type PluginRecord, type PluginRegistry, type PluginRuntime, type PluginRuntimeContext, type PluginSystem, type PluginSystemOptions, type PluginToolOptions, PluginToolRegistry, type PluginsConfig, type PluginsConfigValidationResult, type RegisteredPluginTool, type RunResultPayload, type SessionContextStore, type SessionExport, type SessionInspection, type SessionMetadata, type SessionSummary, type Skill, type SlashCommandList, type SubagentContext, SubagentRegistry, type SubagentRunRecord, type SubagentStatus, type SubagentToolsContext, type SystemPromptParams, type ToolLoopDetectionConfig, type TranscriptEntry, addAgent, addBinding, aimaxDir, appendToMemory, appendTranscriptEntry, bootstrapMountLayout, buildBootstrapContextFiles, buildSkillsPrompt, buildSubagentAnnounceMessage, buildSystemPrompt, cleanupOldSubagentRecords, collapseLogPath, contextSnapshotPath, createAgentTools, createApplyPatchTool, createBashTool, createBuiltinMemoryProvider, createContextManager, createEditFileTool, createExecTool, createImageTool, createListDirTool, createMemoryAppendTool, createMemoryGetTool, createMemorySearchTool, createPluginRuntime, createProcessTool, createReadFileTool, createSession, createSessionContextStore, createSessionsSpawnTool, createSubagentsTool, createWriteFileTool, deleteMemoryFile, discoverAIMaxPlugins, ensureBootstrapMountLayout, ensureSession, exportSession, generateSessionTitle, getAgentConfig, getMemoryLines, hasBootstrapSentinel, initializePluginSystem, inspectBootstrapMountLayout, inspectSession, isBootstrapMountLayoutReady, listAgents, listAvailableSlashCommands, listBindings, listMemoryFiles, listSessionSummaries, listSessions, listSubagentRunsFromDisk, loadAgentsConfig, loadBootstrapFiles, loadPluginManifest, loadPluginManifestRegistry, loadPlugins, loadSessionContextSnapshot, loadSessionMetadata, loadSkills, loadSkillsFromDirs, loadSkillsWithPluginDirs, loadSubagentRegistryFromDisk, loadTranscript, memoryDir, metadataPath, normalizeAgentId, normalizePluginsConfig, primaryMemoryPath, readMemoryFile, readPrimaryMemory, registerEmbeddingProvider, registerMemoryProvider, removeAgent, removeBindings, replaceMemoryFile, resetEmbeddingProviderRegistryForTests, resetMemoryProviderRegistryForTests, resolveAgentDir, resolveAgentIdByBinding, resolveAgentsConfigPath, resolveDefaultAgentId, resolveEmbeddingProvider, resolveMemoryProvider, resolveModelFallbacks, resolveModelString, resolvePluginManifestPath, runAgent, saveAgentsConfig, saveSessionMetadata, saveSubagentRegistryToDisk, searchMemory, sessionDir, sessionMemoryPath, sessionsDir, skillsDir, toolResultsDir, transcriptPath, updateAgentIdentity, validatePluginsConfig, wrapToolsWithHooks };