@gencode/agents 0.0.39 → 0.0.40

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { S as AgentsConfig, _ as saveAgentsConfig, a as listAgents, b as AgentCo
 import { AssistantMessage, Message } from "@mariozechner/pi-ai";
 import { AgentMessage, AgentTool } from "@mariozechner/pi-agent-core";
 import * as _gencode_shared0 from "@gencode/shared";
-import { AgentCustomProgressEvent, AgentProgressEvent, AgentProgressEvent as AgentProgressEvent$1, CallbackEventPayload, CallbackEventPayload as CallbackEventPayload$1, Channel, Channel as Channel$1, CollapseSpan, HitlCheckpoint, HitlCheckpoint as HitlCheckpoint$1, HitlHistoryEntry, HitlRequest, HitlRequest as HitlRequest$1, HitlResolution, HitlResolution as HitlResolution$1, HitlStatus, HitlToolContext, HitlToolContext as HitlToolContext$1, PausedRunState, PausedRunState as PausedRunState$1, ReadStateRecord, RunResultPayload, RunResultPayload as RunResultPayload$1, SessionContextSnapshot, SessionMemorySnapshot, SnipRecord, ToolResultReference } from "@gencode/shared";
+import { AgentCustomProgressEvent, AgentProgressEvent, AgentProgressEvent as AgentProgressEvent$1, CallbackEventPayload, CallbackEventPayload as CallbackEventPayload$1, Channel, Channel as Channel$1, CollapseSpan, HitlCheckpoint, HitlCheckpoint as HitlCheckpoint$1, HitlHistoryEntry, HitlRequest, HitlRequest as HitlRequest$1, HitlResolution, HitlResolution as HitlResolution$1, HitlStatus, HitlToolContext, HitlToolContext as HitlToolContext$1, PausedRunState, PausedRunState as PausedRunState$1, ReadStateRecord, RunResultPayload, RunResultPayload as RunResultPayload$1, SessionContextSnapshot, SessionMemorySnapshot, SnipRecord, ToolResultReference, UiToolPausedState, UiToolRequest, UiToolResult, UiToolSchema, UiToolValidationResult } from "@gencode/shared";
 
 //#region src/loop-detection/tool-loop-detection.d.ts
 type ToolLoopDetectionConfig = {
@@ -151,7 +151,8 @@ type AgentRunParamsBase = {
     resolution: HitlResolution;
     checkpoint: HitlCheckpoint;
     toolContext?: HitlToolContext$1;
-  }; /** Tool-loop detection guardrails (disabled by default) */
+  }; /** UI tool resume state injected when the user submits a UI tool form. */
+  uiToolResume?: UiToolResult; /** Tool-loop detection guardrails (disabled by default) */
   loopDetection?: ToolLoopDetectionConfig; /** Plugin system options (optional) */
   plugins?: {
     /** Plugin config structure (allow/deny/entries/slots/load.paths) */config?: PluginsConfig; /** Data dir used to resolve .aimax extensions */
@@ -198,6 +199,12 @@ type AgentRunResult = RunResultPayload$1 & {
     requestId: string;
     kind: _gencode_shared0.HitlKind;
     title: string;
+  }; /** Present when the run was paused for a UI tool awaiting user input. */
+  uiToolPending?: {
+    requestId: string;
+    toolName: string;
+    toolCallId: string;
+    schema: _gencode_shared0.UiToolSchema;
   };
 };
 /** HTTP callback body formats */
@@ -1638,9 +1645,11 @@ type ClarifyResult = {
  * Creates the `clarify` tool that the agent can call to ask the user a question.
  *
  * @param sessionId - Current session ID for the HITL request.
- * @param turnId - Current turn ID for checkpoint tracking.
+ * @param hitlResume - When present, contains the user's resolution for a
+ *                     previously paused clarify request. The tool returns the
+ *                     user's answer instead of throwing again.
  */
-declare function createClarifyTool(sessionId: string): AgentTool<typeof clarifySchema, ClarifyResult>;
+declare function createClarifyTool(sessionId: string, hitlResume?: AgentRunParams["hitlResume"]): AgentTool<typeof clarifySchema, ClarifyResult>;
 //#endregion
 //#region src/tools/request-approval.d.ts
 declare const approvalSchema: TObject<{
@@ -1674,9 +1683,72 @@ type ReviewResult = {
  * Creates the `request_review` tool.
  *
  * @param sessionId - Current session ID.
- * @param turnId - Current turn ID for checkpoint tracking.
+ * @param hitlResume - When present, contains the user's resolution for a
+ *                     previously paused review request. The tool returns the
+ *                     reviewer's verdict instead of throwing again.
+ */
+declare function createRequestReviewTool(sessionId: string, hitlResume?: AgentRunParams["hitlResume"]): AgentTool<typeof reviewSchema, ReviewResult>;
+//#endregion
+//#region src/tools/ui-tool.d.ts
+type UiToolOptions = {
+  /** Unique tool name (must be valid identifier, e.g. "collect_feedback"). */name: string; /** Human-readable label shown in tool listings. */
+  label: string; /** Description used in the LLM system prompt. */
+  description: string; /** Current session ID. */
+  sessionId: string; /** The UI form schema that the front-end should render. */
+  schema: UiToolSchema;
+  /**
+   * Optional custom validator. Called after built-in schema validation passes.
+   * Return `{ valid: true }` to accept, or `{ valid: false, errors: [...] }`
+   * to reject.
+   */
+  validate?: (values: Record<string, unknown>) => UiToolValidationResult | Promise<UiToolValidationResult>;
+  /**
+   * Optional resume state. When the CLI re-invokes the agent with a
+   * `uiToolResume`, this field is populated so the tool can return the
+   * user's values instead of throwing a pause signal.
+   */
+  resume?: UiToolResult;
+};
+/**
+ * The LLM sees a thin schema: `reason` explains why input is needed.
+ * The actual form fields are defined in UiToolSchema and are NOT exposed
+ * to the LLM — they are only used by the front-end renderer.
+ */
+declare const uiToolLlmSchema: TObject<{
+  reason: TString;
+}>;
+/**
+ * Creates a UI tool that pauses the agent for front-end input collection.
+ */
+declare function createUiTool(options: UiToolOptions): AgentTool<typeof uiToolLlmSchema>;
+//#endregion
+//#region src/tools/ui-tool-signal.d.ts
+declare class UiToolPauseSignal extends Error {
+  /** The original tool arguments from the LLM. */
+  readonly toolArgs: Record<string, unknown>;
+  /** Discriminator to reliably identify the signal in catch blocks. */
+  readonly isUiToolPause: true;
+  /** The fully formed request to emit through events. */
+  readonly request: UiToolRequest;
+  constructor(/** Unique request identifier. */
+
+  requestId: string, /** Session identifier. */
+
+  sessionId: string, /** The tool name that produced this signal. */
+
+  toolName: string, /** The LLM-generated tool call ID. */
+
+  toolCallId: string, /** The UI form schema. */
+
+  schema: UiToolSchema, /** The original tool arguments from the LLM. */
+
+  toolArgs: Record<string, unknown>);
+}
+/**
+ * Type-guard that checks if an unknown error is a UiToolPauseSignal.
+ * Handles both `instanceof` and duck-typing for cross-module boundaries.
  */
-declare function createRequestReviewTool(sessionId: string): AgentTool<typeof reviewSchema, ReviewResult>;
+declare function isUiToolPauseSignal(error: unknown): error is UiToolPauseSignal;
 //#endregion
 //#region src/tools/index.d.ts
 /** Optional context for enabling subagent tools */
@@ -1703,6 +1775,13 @@ type SubagentToolsContext = {
  */
 declare function createAgentTools(dataDir: string, ctx?: SubagentToolsContext): AgentTool[];
 //#endregion
+//#region src/tools/ui-tool-session-store.d.ts
+declare function pendingUiToolPath(dataDir: string, sessionId: string, options?: SessionPathOptions): string;
+declare function readPendingUiTool(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<UiToolPausedState | null>;
+declare function createPendingUiTool(dataDir: string, sessionId: string, request: UiToolRequest, options?: SessionPathOptions): Promise<UiToolPausedState>;
+declare function resolvePendingUiTool(dataDir: string, sessionId: string, requestId: string, result: UiToolResult, options?: SessionPathOptions): Promise<UiToolPausedState | null>;
+declare function clearPendingUiTool(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<void>;
+//#endregion
 //#region src/subagent/registry-persist.d.ts
 /** Persistable subagent run record (without AbortController) */
 type PersistedSubagentRunRecord = Omit<SubagentRunRecord, "abortController"> & {
@@ -1758,12 +1837,51 @@ type RegisteredPluginTool = {
   optional: boolean;
   names: string[];
 };
+/**
+ * Simplified descriptor for registering a UI tool from a plugin.
+ *
+ * Plugin authors only need to provide the form schema and basic metadata.
+ * The framework handles session binding, pause/resume control flow, and
+ * result validation automatically.
+ */
+type PluginUiToolDescriptor = {
+  /** Unique tool name (must be a valid identifier, e.g. "collect_feedback"). */name: string; /** Human-readable label shown in tool listings. */
+  label: string; /** Description used in the LLM system prompt. */
+  description: string; /** The UI form schema that the front-end should render. */
+  schema: UiToolSchema;
+  /**
+   * Optional custom validator. Called after built-in schema validation passes.
+   * Return `{ valid: true }` to accept, or `{ valid: false, errors: [...] }`
+   * to reject.
+   */
+  validate?: (values: Record<string, unknown>) => UiToolValidationResult | Promise<UiToolValidationResult>;
+};
+type PluginUiToolOptions = {
+  optional?: boolean;
+};
+type RegisteredPluginUiTool = {
+  pluginId: string;
+  descriptor: PluginUiToolDescriptor;
+  optional: boolean;
+};
 declare class PluginToolRegistry {
   private readonly tools;
+  private readonly uiTools;
   register(pluginId: string, tool: AgentTool, opts?: PluginToolOptions): void;
+  /**
+   * Register a UI tool descriptor. The actual `AgentTool` is created lazily
+   * at runtime via {@link resolveUiTools} once the session context is known.
+   */
+  registerUiTool(pluginId: string, descriptor: PluginUiToolDescriptor, opts?: PluginUiToolOptions): void;
   list(): RegisteredPluginTool[];
+  listUiTools(): RegisteredPluginUiTool[];
   namesForPlugin(pluginId: string): string[];
   resolveEnabled(allowlist?: string[]): AgentTool[];
+  /**
+   * Materialise registered UI tool descriptors into real `AgentTool` instances
+   * by binding session-level context that is unavailable at plugin load time.
+   */
+  resolveUiTools(sessionId: string, resume?: UiToolResult, allowlist?: string[]): AgentTool[];
 }
 //#endregion
 //#region src/plugins/runtime.d.ts
@@ -1866,6 +1984,15 @@ type PluginApi = {
     chat: (params: LlmChatParams) => Promise<LlmChatResult>;
   };
   registerTool: (tool: Parameters<PluginToolRegistry["register"]>[1], opts?: Parameters<PluginToolRegistry["register"]>[2]) => void;
+  /**
+   * Register a UI tool that pauses the agent and collects structured user
+   * input through a front-end form.
+   *
+   * Unlike `registerTool`, the plugin only provides the form schema and
+   * metadata — session binding, pause/resume control flow, and result
+   * validation are handled automatically by the framework.
+   */
+  registerUiTool: (descriptor: PluginUiToolDescriptor, opts?: PluginUiToolOptions) => void;
   registerEmbeddingProvider: (params: {
     id?: string;
     create: EmbeddingProviderFactory;
@@ -1939,6 +2066,18 @@ declare class HitlPauseSignal extends Error {
   readonly checkpoint: HitlCheckpoint$1;
   /** Optional tool call context. */
   readonly toolContext?: HitlToolContext;
+  /**
+   * When `true`, this pause is a transparent safety gate (e.g. exec approval
+   * for `rm -rf`). Transparent pauses do NOT leave entries in the transcript
+   * — the tool's real result is recorded only after the user approves and
+   * the tool re-executes.
+   *
+   * When `false` (default), the pause IS the interaction record (e.g.
+   * clarify, request_approval, request_review, and plugin-provided HITL
+   * tools). Plugin tools should leave this as `false` so their tool-call /
+   * tool-result pairs are persisted normally in the transcript.
+   */
+  readonly transparentPause: boolean;
   /** Discriminator to reliably identify the signal in catch blocks. */
   readonly isHitlPause: true;
   constructor(/** The HITL request to present to the user. */
@@ -1947,7 +2086,20 @@ declare class HitlPauseSignal extends Error {
 
   checkpoint: HitlCheckpoint$1, /** Optional tool call context. */
 
-  toolContext?: HitlToolContext);
+  toolContext?: HitlToolContext,
+  /**
+   * When `true`, this pause is a transparent safety gate (e.g. exec approval
+   * for `rm -rf`). Transparent pauses do NOT leave entries in the transcript
+   * — the tool's real result is recorded only after the user approves and
+   * the tool re-executes.
+   *
+   * When `false` (default), the pause IS the interaction record (e.g.
+   * clarify, request_approval, request_review, and plugin-provided HITL
+   * tools). Plugin tools should leave this as `false` so their tool-call /
+   * tool-result pairs are persisted normally in the transcript.
+   */
+
+  transparentPause?: boolean);
 }
 /**
  * Type-guard that checks if an unknown error is a HitlPauseSignal.
@@ -2051,6 +2203,18 @@ declare const HITL_MESSAGES: {
   };
 };
 declare function approvalSummaryFromResolution(resolution: HitlResolution): string;
+/**
+ * Formats a clarify resolution into a JSON string suitable for the tool
+ * result content in the transcript. The model sees this as the clarify
+ * tool's return value — i.e. the user's answer.
+ */
+declare function formatClarifyResolution(resolution: HitlResolution): string;
+/**
+ * Formats a review resolution into a JSON string suitable for the tool
+ * result content in the transcript. The model sees this as the
+ * request_review tool's return value — i.e. the reviewer's verdict.
+ */
+declare function formatReviewResolution(resolution: HitlResolution): string;
 declare function buildResumeNarration(resolution: HitlResolution, kind: string): string;
 //#endregion
-export { AgentBinding, AgentConfig, type AgentCustomProgressEvent, 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, DEFAULT_SESSION_STORE_NAME, type EmbeddingProvider, type EmbeddingProviderContext, type EmbeddingProviderFactory, type EmbeddingProviderRegistration, HITL_MESSAGES, type HitlPauseContext, HitlPauseSignal, type HitlToolContext, 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 PluginCustomProgressInput, type PluginDiagnostic, type PluginDiscoveryOptions, type PluginDiscoveryResult, type PluginEntryConfig, type PluginExecutionRuntime, 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 PluginProgressEmitter, type PluginRecord, type PluginRegistry, type PluginRuntime, type PluginRuntimeContext, type PluginSystem, type PluginSystemOptions, type PluginToolOptions, PluginToolRegistry, type PluginsConfig, type PluginsConfigValidationResult, type RegisteredPluginTool, type ResumeOptions, type ResumeValidationResult, type RunResultPayload, type SessionContextStore, type SessionExport, type SessionInspection, type SessionMetadata, type SessionMetadataUpdate, 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, approvalSummaryFromResolution, bootstrapMountLayout, buildBootstrapContextFiles, buildResumeNarration, buildSkillsPrompt, buildSubagentAnnounceMessage, buildSystemPrompt, cleanupOldSubagentRecords, clearPendingHitl, collapseLogPath, contextSnapshotPath, createAgentTools, createApplyPatchTool, createBashTool, createBuiltinMemoryProvider, createClarifyTool, createContextManager, createEditFileTool, createExecTool, createImageTool, createListDirTool, createMemoryAppendTool, createMemoryGetTool, createMemorySearchTool, createPendingHitl, createPluginProgressEmitter, createPluginRuntime, createProcessTool, createReadFileTool, createRequestApprovalTool, createRequestReviewTool, createSession, createSessionContextStore, createSessionsSpawnTool, createSubagentsTool, createWriteFileTool, deleteMemoryFile, discoverAIMaxPlugins, ensureBootstrapMountLayout, ensureSession, exportSession, formatApprovalResolution, generateSessionTitle, getAgentConfig, getMemoryLines, hasBootstrapSentinel, hitlHistoryPath, initializePluginSystem, inspectBootstrapMountLayout, inspectSession, isBootstrapMountLayoutReady, isHitlPauseSignal, listAgents, listAvailableSlashCommands, listBindings, listMemoryFiles, listSessionSummaries, listSessions, listSubagentRunsFromDisk, loadAgentsConfig, loadBootstrapFiles, readPendingHitl as loadPendingHitl, readPendingHitl, loadPluginManifest, loadPluginManifestRegistry, loadPlugins, loadSessionContextSnapshot, loadSessionMetadata, loadSkills, loadSkillsFromDirs, loadSkillsWithPluginDirs, loadSubagentRegistryFromDisk, loadTranscript, memoryDir, metadataPath, normalizeAgentId, normalizePluginsConfig, normalizeSessionStoreName, pendingHitlPath, primaryMemoryPath, readHitlHistory, readMemoryFile, readPrimaryMemory, registerEmbeddingProvider, registerMemoryProvider, removeAgent, removeBindings, replaceMemoryFile, resetEmbeddingProviderRegistryForTests, resetMemoryProviderRegistryForTests, resolveAgentDir, resolveAgentIdByBinding, resolveAgentsConfigPath, resolveDefaultAgentId, resolveEmbeddingProvider, resolveHitlRequest, resolveHitlRequest as resolvePendingHitl, resolveMemoryProvider, resolveModelFallbacks, resolveModelString, resolvePluginManifestPath, rewriteTranscript, runAgent, saveAgentsConfig, saveSessionMetadata, saveSubagentRegistryToDisk, searchMemory, sessionDir, sessionMemoryPath, sessionsDir, skillsDir, toolResultsDir, transcriptPath, transitionHitlStatus, updateAgentIdentity, updateSessionMetadata, validatePluginsConfig, validateResume, wrapToolsWithHooks };
+export { AgentBinding, AgentConfig, type AgentCustomProgressEvent, 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, DEFAULT_SESSION_STORE_NAME, type EmbeddingProvider, type EmbeddingProviderContext, type EmbeddingProviderFactory, type EmbeddingProviderRegistration, HITL_MESSAGES, type HitlPauseContext, HitlPauseSignal, type HitlToolContext, 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 PluginCustomProgressInput, type PluginDiagnostic, type PluginDiscoveryOptions, type PluginDiscoveryResult, type PluginEntryConfig, type PluginExecutionRuntime, 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 PluginProgressEmitter, type PluginRecord, type PluginRegistry, type PluginRuntime, type PluginRuntimeContext, type PluginSystem, type PluginSystemOptions, type PluginToolOptions, PluginToolRegistry, type PluginUiToolDescriptor, type PluginUiToolOptions, type PluginsConfig, type PluginsConfigValidationResult, type RegisteredPluginTool, type ResumeOptions, type ResumeValidationResult, type RunResultPayload, type SessionContextStore, type SessionExport, type SessionInspection, type SessionMetadata, type SessionMetadataUpdate, type SessionSummary, type Skill, type SlashCommandList, type SubagentContext, SubagentRegistry, type SubagentRunRecord, type SubagentStatus, type SubagentToolsContext, type SystemPromptParams, type ToolLoopDetectionConfig, type TranscriptEntry, type UiToolOptions, UiToolPauseSignal, addAgent, addBinding, aimaxDir, appendToMemory, appendTranscriptEntry, approvalSummaryFromResolution, bootstrapMountLayout, buildBootstrapContextFiles, buildResumeNarration, buildSkillsPrompt, buildSubagentAnnounceMessage, buildSystemPrompt, cleanupOldSubagentRecords, clearPendingHitl, clearPendingUiTool, collapseLogPath, contextSnapshotPath, createAgentTools, createApplyPatchTool, createBashTool, createBuiltinMemoryProvider, createClarifyTool, createContextManager, createEditFileTool, createExecTool, createImageTool, createListDirTool, createMemoryAppendTool, createMemoryGetTool, createMemorySearchTool, createPendingHitl, createPendingUiTool, createPluginProgressEmitter, createPluginRuntime, createProcessTool, createReadFileTool, createRequestApprovalTool, createRequestReviewTool, createSession, createSessionContextStore, createSessionsSpawnTool, createSubagentsTool, createUiTool, createWriteFileTool, deleteMemoryFile, discoverAIMaxPlugins, ensureBootstrapMountLayout, ensureSession, exportSession, formatApprovalResolution, formatClarifyResolution, formatReviewResolution, generateSessionTitle, getAgentConfig, getMemoryLines, hasBootstrapSentinel, hitlHistoryPath, initializePluginSystem, inspectBootstrapMountLayout, inspectSession, isBootstrapMountLayoutReady, isHitlPauseSignal, isUiToolPauseSignal, listAgents, listAvailableSlashCommands, listBindings, listMemoryFiles, listSessionSummaries, listSessions, listSubagentRunsFromDisk, loadAgentsConfig, loadBootstrapFiles, readPendingHitl as loadPendingHitl, readPendingHitl, readPendingUiTool as loadPendingUiTool, readPendingUiTool, loadPluginManifest, loadPluginManifestRegistry, loadPlugins, loadSessionContextSnapshot, loadSessionMetadata, loadSkills, loadSkillsFromDirs, loadSkillsWithPluginDirs, loadSubagentRegistryFromDisk, loadTranscript, memoryDir, metadataPath, normalizeAgentId, normalizePluginsConfig, normalizeSessionStoreName, pendingHitlPath, pendingUiToolPath, primaryMemoryPath, readHitlHistory, readMemoryFile, readPrimaryMemory, registerEmbeddingProvider, registerMemoryProvider, removeAgent, removeBindings, replaceMemoryFile, resetEmbeddingProviderRegistryForTests, resetMemoryProviderRegistryForTests, resolveAgentDir, resolveAgentIdByBinding, resolveAgentsConfigPath, resolveDefaultAgentId, resolveEmbeddingProvider, resolveHitlRequest, resolveHitlRequest as resolvePendingHitl, resolveMemoryProvider, resolveModelFallbacks, resolveModelString, resolvePendingUiTool, resolvePluginManifestPath, rewriteTranscript, runAgent, saveAgentsConfig, saveSessionMetadata, saveSubagentRegistryToDisk, searchMemory, sessionDir, sessionMemoryPath, sessionsDir, skillsDir, toolResultsDir, transcriptPath, transitionHitlStatus, updateAgentIdentity, updateSessionMetadata, validatePluginsConfig, validateResume, wrapToolsWithHooks };