@gencode/agents 0.7.6 → 0.8.0

package/dist/index.d.ts

@@ -131,6 +131,394 @@ declare function validatePluginsConfig(params: {
   registry: PluginManifestRegistry;
 }): PluginsConfigValidationResult;
 //#endregion
+//#region src/memory/config.d.ts
+type MemorySearchConfig = {
+  chunkTokens: number;
+  chunkOverlap: number;
+  maxResults: number;
+  minScore: number;
+  fallback: {
+    enabled: boolean;
+  };
+  embedding: {
+    providerId?: string;
+  };
+  experimental: {
+    sessionMemory: boolean;
+  };
+  sources: Array<"memory" | "sessions">;
+  store: {
+    sessionStoreName?: string;
+    vector: {
+      enabled: boolean;
+      extensionPath?: string;
+    };
+  };
+  hybrid: {
+    enabled: boolean;
+    vectorWeight: number;
+    textWeight: number;
+    candidateMultiplier: number;
+    mmr: {
+      enabled: boolean;
+      lambda: number;
+    };
+    temporalDecay: {
+      enabled: boolean;
+      halfLifeDays: number;
+    };
+  };
+  cache: {
+    enabled: boolean;
+    maxEntries?: number;
+  };
+  sync: {
+    onSessionStart: boolean;
+    onSearch: boolean;
+    watch: boolean;
+    watchDebounceMs: number;
+    sessions: {
+      deltaBytes: number;
+      deltaMessages: number;
+    };
+  };
+  citations: "off" | "auto" | "on";
+};
+//#endregion
+//#region src/memory/manager.d.ts
+type MemorySearchResult$1 = {
+  id?: string;
+  path: string;
+  startLine: number;
+  endLine: number;
+  score: number;
+  snippet: string;
+  source: "memory" | "sessions";
+  citation?: string;
+};
+type MemoryProviderStatus = {
+  backend: "builtin";
+  provider: string;
+  model?: string;
+  files?: number;
+  chunks?: number;
+  dirty?: boolean;
+  workspaceDir?: string;
+  dbPath?: string;
+  sources?: Array<"memory" | "sessions">;
+  sourceCounts?: Array<{
+    source: "memory" | "sessions";
+    files: number;
+    chunks: number;
+  }>;
+  cache?: {
+    enabled: boolean;
+    entries?: number;
+    maxEntries?: number;
+  };
+  fts?: {
+    enabled: boolean;
+    available: boolean;
+    error?: string;
+    rows?: number;
+  };
+  vector?: {
+    enabled: boolean;
+    available?: boolean;
+    extensionPath?: string;
+    loadError?: string;
+    dims?: number;
+  };
+  custom?: Record<string, unknown>;
+};
+type MemoryRebuildSummary = {
+  reason: string;
+  memoryFilesIndexed: number;
+  sessionFilesIndexed: number;
+  staleMemoryFilesRemoved: number;
+  staleSessionFilesRemoved: number;
+  chunks: number;
+  ftsRows?: number;
+  fallbackActive: boolean;
+  needsFullReindex: boolean;
+};
+declare class MemoryIndexManager {
+  private readonly dataDir;
+  private readonly memoryRoot;
+  private readonly storePath;
+  private readonly config;
+  private sessionStoreName;
+  private provider;
+  private providerKey;
+  private embeddingProviderId?;
+  private db;
+  private dirty;
+  private ftsAvailable;
+  private ftsError?;
+  private vector;
+  private vectorReady;
+  private watchers;
+  private watchTimer;
+  private sessionWatchTimer;
+  private sessionsDirty;
+  private sessionsDirtyFiles;
+  private sessionPendingFiles;
+  private searchFallbackOnly;
+  private lastRebuildSummary?;
+  private sessionDeltas;
+  static get(dataDir: string, config?: Partial<MemorySearchConfig>): MemoryIndexManager;
+  private constructor();
+  private applyConfig;
+  warmSession(): void;
+  noteSessionUpdate(sessionFile: string): void;
+  status(): MemoryProviderStatus;
+  probeEmbeddingAvailability(): Promise<{
+    ok: boolean;
+    error?: string;
+  }>;
+  probeVectorAvailability(): Promise<boolean>;
+  search(query: string): Promise<MemorySearchResult$1[]>;
+  readFile(params: {
+    relPath: string;
+    from?: number;
+    lines?: number;
+  }): Promise<{
+    text: string;
+    path: string;
+  }>;
+  replaceFile(params: {
+    relPath: string;
+    content: string;
+  }): Promise<void>;
+  deleteFile(relPath: string): Promise<void>;
+  appendToMemory(content: string): Promise<void>;
+  private openDatabase;
+  private ensureSchema;
+  private ensureVectorReady;
+  private loadVectorExtension;
+  private ensureVectorTable;
+  private dropVectorTable;
+  private withTimeout;
+  private ensureWatcher;
+  private scheduleWatchSync;
+  private ensureSessionListener;
+  private scheduleSessionDirty;
+  private processSessionDeltaBatch;
+  private updateSessionDelta;
+  private countNewlines;
+  private computeProviderKey;
+  private resolveMemoryFilePath;
+  private applyEmbeddingProvider;
+  private readMeta;
+  private writeMeta;
+  private loadEmbeddingCache;
+  private upsertEmbeddingCache;
+  private embedChunks;
+  private indexFile;
+  private buildSourceFilter;
+  private searchVector;
+  private searchKeyword;
+  private resetIndex;
+  private syncAndPostCheck;
+  private indexHasSearchableData;
+  private fileScanSearch;
+  private getFtsRowCount;
+  private buildRebuildSummary;
+  rebuild(reason?: string): Promise<MemoryRebuildSummary>;
+  sync(params?: {
+    reason?: string;
+    forceFullReindex?: boolean;
+  }): Promise<void>;
+  private syncSessionFiles;
+  private resetSessionDelta;
+  private decorateCitations;
+  private decorateEntryIds;
+}
+//#endregion
+//#region src/memory/provider.d.ts
+type MemoryProviderContext = {
+  dataDir: string;
+  memoryDir: string;
+  sessionId?: string;
+  sessionStoreName?: string;
+  pluginId?: string;
+  config?: Record<string, unknown>;
+  rootDir?: string;
+  source?: string;
+};
+type MemorySearchOptions = {
+  limit?: number;
+  sources?: Array<"memory" | "sessions">;
+};
+type MemoryChangeSource = "memory" | "sessions";
+type MemoryChangedEvent = {
+  reason: string;
+  files: string[];
+  source: MemoryChangeSource;
+  sessionId?: string;
+  providerId?: string;
+  timestamp: string;
+};
+type MemoryChangedHandler = (event: MemoryChangedEvent) => void | Promise<void>;
+type MemoryProvider = {
+  id: string;
+  name?: string;
+  status: () => MemoryProviderStatus;
+  search: (query: string, options?: MemorySearchOptions) => Promise<MemorySearchResult$1[]>;
+  getLines: (file: string, startLine: number, endLine: number) => Promise<string[] | null>;
+  listFiles: () => Promise<string[]>;
+  append: (content: string) => Promise<void>; /** Write a daily or session log entry. Falls back to append() if not implemented. */
+  appendRecent?: (content: string, scope: "daily" | "session") => Promise<void>;
+  updateFile: (file: string, content: string) => Promise<void>;
+  deleteFile: (file: string) => Promise<void>;
+  sync?: (reason?: string) => Promise<void>;
+  noteSessionUpdate?: (sessionFile: string) => void;
+  onMemoryChanged?: MemoryChangedHandler;
+};
+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;
+  };
+};
+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>;
+/** Ensures a session directory exists (for resuming an existing session) */
+declare function ensureSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<void>;
+/** Loads all transcript entries from a session */
+declare function loadTranscript(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<TranscriptEntry[]>;
+declare function appendArtifactOperation(dataDir: string, sessionId: string, operation: ArtifactOperationInput, options?: SessionPathOptions): Promise<void>;
+declare function loadArtifactOperations(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<ArtifactOperation[]>;
+/** Appends a single entry to the transcript file */
+declare function appendTranscriptEntry(dataDir: string, sessionId: string, entry: TranscriptEntry, options?: SessionPathOptions & {
+  providerId?: string;
+  pluginId?: string;
+  onMemoryChanged?: MemoryChangedHandler;
+}): Promise<void>;
+/** Rewrites the full transcript atomically using the provided updater. */
+declare function rewriteTranscript(dataDir: string, sessionId: string, updater: (entries: TranscriptEntry[]) => TranscriptEntry[], options?: SessionPathOptions & {
+  providerId?: string;
+  pluginId?: string;
+  onMemoryChanged?: MemoryChangedHandler;
+}): Promise<TranscriptEntry[]>;
+declare function appendCronExecutionRecord(dataDir: string, sessionId: string, record: CronExecutionRecord, options?: SessionPathOptions): Promise<void>;
+declare function loadCronExecutionRecords(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<CronExecutionRecord[]>;
+/** Lists all session IDs within a data directory */
+declare function listSessions(dataDir: string, options?: SessionPathOptions): Promise<string[]>;
+/** Saves session metadata to disk */
+declare function saveSessionMetadata(dataDir: string, metadata: SessionMetadata$1, options?: SessionPathOptions): Promise<void>;
+type SessionMetadataUpdate = Partial<Omit<SessionMetadata$1, "id" | "createdAt">>;
+declare function updateSessionMetadata(dataDir: string, sessionId: string, updates: SessionMetadataUpdate, options?: SessionPathOptions): Promise<SessionMetadata$1 | null>;
+/** Loads session metadata from disk; returns null if not found */
+declare function loadSessionMetadata(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionMetadata$1 | null>;
+/** Lists all sessions with their metadata summaries, optionally filtered by channel */
+declare function listSessionSummaries(dataDir: string, channel?: Channel, options?: SessionPathOptions): Promise<SessionSummary$1[]>;
+declare function loadSessionContextSnapshot(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionContextSnapshot>;
+declare function inspectSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionInspection>;
+declare function exportSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionExport>;
+//#endregion
+//#region src/history/topic-segmentation.d.ts
+type TopicSegmentationConfig = {
+  enabled?: boolean;
+  minUserTurns?: number;
+  minEstimatedTokens?: number;
+  recentProtectedTurnCount?: number;
+  maxCandidates?: number;
+  maxSelectedTurns?: number;
+  maxCandidateUserChars?: number;
+  maxCandidateAssistantChars?: number;
+  timeoutMs?: number;
+  maxTokens?: number;
+};
+//#endregion
 //#region src/skills/skills.d.ts
 /** Resolves the skills directory path within a data directory */
 declare function skillsDir(dataDir: string): string;
@@ -300,456 +688,211 @@ type AgentRunParamsBase = {
   loopDetection?: ToolLoopDetectionConfig; /** LLM turn retry policy for transient provider/network failures. Enabled by default. */
   llmRetry?: LlmTurnRetryConfig; /** Plugin system options (optional) */
   plugins?: {
-    /** Plugin config structure (allow/deny/entries/slots/load.paths) */config?: PluginsConfig; /** Data dir used to resolve .aimax extensions */
-    dataDir?: string; /** Workspace dir exposed to plugin runtime/hooks */
-    workspaceDir?: string; /** Bundled plugins directory (disabled unless explicitly enabled) */
-    bundledDir?: string; /** Optional ownership uid override for security checks */
-    ownershipUid?: number | null; /** Optional tool allowlist for plugin tools */
-    toolAllowlist?: string[]; /** Optional allowlist for plugin LLM access (plugin id or tool name) */
-    llmAllowlist?: string[];
-  };
-  /**
-   * Additional skill registry directories supplied by the CLI.
-   * Each directory contains skill child directories such as <dir>/<skill-name>/SKILL.md.
-   */
-  skillsLoadPaths?: string[]; /** Whether the CLI should prepare an encrypted .aimax mount before this run. */
-  encryptSessions?: boolean; /** Memory system options (optional) */
-  memory?: {
-    /** Explicit memory provider id (overrides plugins.slots.memory) */providerId?: string; /** Explicit plugin id for memory provider (used when providerId not set) */
-    pluginId?: string; /** Whether memory replies should include source path/line hints */
-    citationsMode?: "off" | "on";
-  }; /** Messaging prompt controls */
-  messaging?: {
-    enabled?: boolean; /** Human-readable configured channel list */
-    channels?: string[];
-  }; /** Internal auto-skill controls. CLI wiring is intentionally separate. */
-  autoSkills?: {
-    load?: {
-      /** Defaults to false. When false, the main agent cannot see or load learned auto-skills. */enabled?: boolean;
-    };
-    review?: {
-      /** Defaults to "write": run post-run auto-skill review when gates pass unless explicitly disabled. */mode?: AutoSkillReviewMode; /** Defaults to 1. Hard cap for review attempts that complete per session. */
-      maxReviewsPerSession?: number; /** Scope-based all-AND gates for session, current run, and review window statistics. */
-      gates?: AutoSkillReviewGatesConfig;
-    };
-  };
-  /**
-   * Maximum number of recent user turns to include in context.
-   * Older turns are dropped before the history is sent to the LLM.
-   * 0 or undefined means no limit.
-   */
-  historyLimit?: number;
-  /**
-   * Goal to create when this run establishes a new session (CLI `run --goal` without --session-id).
-   * Applied in runner after sessionId is assigned; not passed to the model as a tool.
-   */
-  pendingGoal?: {
-    objective: string;
-    tokenBudget: number | null;
-  }; /** Internal multi-agent prompt/model/tool policy resolved at run time. */
-  agentPolicy?: AgentRuntimePolicyInput;
-};
-/** Parameters for running an agent session */
-type AgentRunParams = AgentRunParamsBase & ({
-  /** The user message to process */message: string; /** Structured messages to process for file-based runs */
-  messages?: never;
-} | {
-  /** Structured messages to process for file-based runs */messages: Message[]; /** The user message to process */
-  message?: never;
-});
-/** Final result returned after agent execution completes */
-type AgentRunResult = RunResultPayload$1 & {
-  sessionId: string; /** Present when the run was paused for HITL. */
-  paused?: {
-    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;
-    outputSchema: _gencode_shared0.UiToolOutputSchema;
-    extra?: _gencode_shared0.UiToolExtra;
-  };
-};
-/** HTTP callback body formats */
-type CallbackPayload = CallbackEventPayload$1;
-/** A user message turn */
-type UserEntry = {
-  role: "user";
-  content: string;
-  timestamp: string;
-  source?: "cron";
-};
-/** An assistant message turn; may include tool calls when the LLM used tools */
-type AssistantEntry = {
-  role: "assistant"; /** Text response from the assistant (may be empty when the turn is tool-only) */
-  content: string; /** Persisted SDK stop reason when the assistant turn ended abnormally. */
-  stopReason?: "stop" | "length" | "toolUse" | "error" | "aborted"; /** Pi-compatible assistant error text for failed model turns. */
-  errorMessage?: string; /** Tool calls issued by the assistant during this turn */
-  toolCalls?: Array<{
-    id: string;
-    name: string;
-    arguments: Record<string, unknown>;
-  }>;
-  timestamp: string;
-  source?: "cron";
-};
-/** The result returned by a single tool execution */
-type ToolResultEntry = {
-  role: "tool_result"; /** Matches AssistantEntry.toolCalls[].id */
-  toolCallId: string;
-  toolName: string; /** Text output of the tool */
-  content: string;
-  isError: boolean;
-  toolResultRef?: ToolResultReference;
-  timestamp: string;
-  source?: "cron";
-};
-/**
- * A compaction record written after LLM-based history summarisation.
- * `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/memory/config.d.ts
-type MemorySearchConfig = {
-  chunkTokens: number;
-  chunkOverlap: number;
-  maxResults: number;
-  minScore: number;
-  fallback: {
-    enabled: boolean;
-  };
-  embedding: {
-    providerId?: string;
-  };
-  experimental: {
-    sessionMemory: boolean;
-  };
-  sources: Array<"memory" | "sessions">;
-  store: {
-    sessionStoreName?: string;
-    vector: {
-      enabled: boolean;
-      extensionPath?: string;
-    };
-  };
-  hybrid: {
-    enabled: boolean;
-    vectorWeight: number;
-    textWeight: number;
-    candidateMultiplier: number;
-    mmr: {
-      enabled: boolean;
-      lambda: number;
-    };
-    temporalDecay: {
-      enabled: boolean;
-      halfLifeDays: number;
-    };
-  };
-  cache: {
-    enabled: boolean;
-    maxEntries?: number;
+    /** Plugin config structure (allow/deny/entries/slots/load.paths) */config?: PluginsConfig; /** Data dir used to resolve .aimax extensions */
+    dataDir?: string; /** Workspace dir exposed to plugin runtime/hooks */
+    workspaceDir?: string; /** Bundled plugins directory (disabled unless explicitly enabled) */
+    bundledDir?: string; /** Optional ownership uid override for security checks */
+    ownershipUid?: number | null; /** Optional tool allowlist for plugin tools */
+    toolAllowlist?: string[]; /** Optional allowlist for plugin LLM access (plugin id or tool name) */
+    llmAllowlist?: string[];
   };
-  sync: {
-    onSessionStart: boolean;
-    onSearch: boolean;
-    watch: boolean;
-    watchDebounceMs: number;
-    sessions: {
-      deltaBytes: number;
-      deltaMessages: number;
+  /**
+   * Additional skill registry directories supplied by the CLI.
+   * Each directory contains skill child directories such as <dir>/<skill-name>/SKILL.md.
+   */
+  skillsLoadPaths?: string[]; /** Whether the CLI should prepare an encrypted .aimax mount before this run. */
+  encryptSessions?: boolean; /** Memory system options (optional) */
+  memory?: {
+    /** Explicit memory provider id (overrides plugins.slots.memory) */providerId?: string; /** Explicit plugin id for memory provider (used when providerId not set) */
+    pluginId?: string; /** Whether memory replies should include source path/line hints */
+    citationsMode?: "off" | "on";
+  }; /** Messaging prompt controls */
+  messaging?: {
+    enabled?: boolean; /** Human-readable configured channel list */
+    channels?: string[];
+  }; /** Internal auto-skill controls. CLI wiring is intentionally separate. */
+  autoSkills?: {
+    load?: {
+      /** Defaults to false. When false, the main agent cannot see or load learned auto-skills. */enabled?: boolean;
+    };
+    review?: {
+      /** Defaults to "write": run post-run auto-skill review when gates pass unless explicitly disabled. */mode?: AutoSkillReviewMode; /** Defaults to 1. Hard cap for review attempts that complete per session. */
+      maxReviewsPerSession?: number; /** Scope-based all-AND gates for session, current run, and review window statistics. */
+      gates?: AutoSkillReviewGatesConfig;
     };
   };
-  citations: "off" | "auto" | "on";
-};
-//#endregion
-//#region src/memory/manager.d.ts
-type MemorySearchResult$1 = {
-  id?: string;
-  path: string;
-  startLine: number;
-  endLine: number;
-  score: number;
-  snippet: string;
-  source: "memory" | "sessions";
-  citation?: string;
+  /**
+   * Maximum number of recent user turns to include in context.
+   * 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. Disabled unless enabled=true. */
+  topicSegmentation?: TopicSegmentationConfig;
+  /**
+   * Goal to create when this run establishes a new session (CLI `run --goal` without --session-id).
+   * Applied in runner after sessionId is assigned; not passed to the model as a tool.
+   */
+  pendingGoal?: {
+    objective: string;
+    tokenBudget: number | null;
+  }; /** Internal multi-agent prompt/model/tool policy resolved at run time. */
+  agentPolicy?: AgentRuntimePolicyInput;
 };
-type MemoryProviderStatus = {
-  backend: "builtin";
-  provider: string;
-  model?: string;
-  files?: number;
-  chunks?: number;
-  dirty?: boolean;
-  workspaceDir?: string;
-  dbPath?: string;
-  sources?: Array<"memory" | "sessions">;
-  sourceCounts?: Array<{
-    source: "memory" | "sessions";
-    files: number;
-    chunks: number;
-  }>;
-  cache?: {
-    enabled: boolean;
-    entries?: number;
-    maxEntries?: number;
-  };
-  fts?: {
-    enabled: boolean;
-    available: boolean;
-    error?: string;
-    rows?: number;
-  };
-  vector?: {
-    enabled: boolean;
-    available?: boolean;
-    extensionPath?: string;
-    loadError?: string;
-    dims?: number;
+/** Parameters for running an agent session */
+type AgentRunParams = AgentRunParamsBase & ({
+  /** The user message to process */message: string; /** Structured messages to process for file-based runs */
+  messages?: never;
+} | {
+  /** Structured messages to process for file-based runs */messages: Message[]; /** The user message to process */
+  message?: never;
+});
+/** Final result returned after agent execution completes */
+type AgentRunResult = RunResultPayload$1 & {
+  sessionId: string; /** Present when the run was paused for HITL. */
+  paused?: {
+    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;
+    outputSchema: _gencode_shared0.UiToolOutputSchema;
+    extra?: _gencode_shared0.UiToolExtra;
   };
-  custom?: Record<string, unknown>;
 };
-type MemoryRebuildSummary = {
-  reason: string;
-  memoryFilesIndexed: number;
-  sessionFilesIndexed: number;
-  staleMemoryFilesRemoved: number;
-  staleSessionFilesRemoved: number;
-  chunks: number;
-  ftsRows?: number;
-  fallbackActive: boolean;
-  needsFullReindex: boolean;
+/** HTTP callback body formats */
+type CallbackPayload = CallbackEventPayload$1;
+/** A user message turn */
+type UserEntry = {
+  role: "user";
+  content: string;
+  timestamp: string;
+  source?: "cron";
 };
-declare class MemoryIndexManager {
-  private readonly dataDir;
-  private readonly memoryRoot;
-  private readonly storePath;
-  private readonly config;
-  private sessionStoreName;
-  private provider;
-  private providerKey;
-  private embeddingProviderId?;
-  private db;
-  private dirty;
-  private ftsAvailable;
-  private ftsError?;
-  private vector;
-  private vectorReady;
-  private watchers;
-  private watchTimer;
-  private sessionWatchTimer;
-  private sessionsDirty;
-  private sessionsDirtyFiles;
-  private sessionPendingFiles;
-  private searchFallbackOnly;
-  private lastRebuildSummary?;
-  private sessionDeltas;
-  static get(dataDir: string, config?: Partial<MemorySearchConfig>): MemoryIndexManager;
-  private constructor();
-  private applyConfig;
-  warmSession(): void;
-  noteSessionUpdate(sessionFile: string): void;
-  status(): MemoryProviderStatus;
-  probeEmbeddingAvailability(): Promise<{
-    ok: boolean;
-    error?: string;
-  }>;
-  probeVectorAvailability(): Promise<boolean>;
-  search(query: string): Promise<MemorySearchResult$1[]>;
-  readFile(params: {
-    relPath: string;
-    from?: number;
-    lines?: number;
-  }): Promise<{
-    text: string;
-    path: string;
+/** An assistant message turn; may include tool calls when the LLM used tools */
+type AssistantEntry = {
+  role: "assistant"; /** Text response from the assistant (may be empty when the turn is tool-only) */
+  content: string; /** Persisted SDK stop reason when the assistant turn ended abnormally. */
+  stopReason?: "stop" | "length" | "toolUse" | "error" | "aborted"; /** Pi-compatible assistant error text for failed model turns. */
+  errorMessage?: string; /** Tool calls issued by the assistant during this turn */
+  toolCalls?: Array<{
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
   }>;
-  replaceFile(params: {
-    relPath: string;
-    content: string;
-  }): Promise<void>;
-  deleteFile(relPath: string): Promise<void>;
-  appendToMemory(content: string): Promise<void>;
-  private openDatabase;
-  private ensureSchema;
-  private ensureVectorReady;
-  private loadVectorExtension;
-  private ensureVectorTable;
-  private dropVectorTable;
-  private withTimeout;
-  private ensureWatcher;
-  private scheduleWatchSync;
-  private ensureSessionListener;
-  private scheduleSessionDirty;
-  private processSessionDeltaBatch;
-  private updateSessionDelta;
-  private countNewlines;
-  private computeProviderKey;
-  private resolveMemoryFilePath;
-  private applyEmbeddingProvider;
-  private readMeta;
-  private writeMeta;
-  private loadEmbeddingCache;
-  private upsertEmbeddingCache;
-  private embedChunks;
-  private indexFile;
-  private buildSourceFilter;
-  private searchVector;
-  private searchKeyword;
-  private resetIndex;
-  private syncAndPostCheck;
-  private indexHasSearchableData;
-  private fileScanSearch;
-  private getFtsRowCount;
-  private buildRebuildSummary;
-  rebuild(reason?: string): Promise<MemoryRebuildSummary>;
-  sync(params?: {
-    reason?: string;
-    forceFullReindex?: boolean;
-  }): Promise<void>;
-  private syncSessionFiles;
-  private resetSessionDelta;
-  private decorateCitations;
-  private decorateEntryIds;
-}
-//#endregion
-//#region src/memory/provider.d.ts
-type MemoryProviderContext = {
-  dataDir: string;
-  memoryDir: string;
-  sessionId?: string;
-  sessionStoreName?: string;
-  pluginId?: string;
-  config?: Record<string, unknown>;
-  rootDir?: string;
-  source?: string;
-};
-type MemorySearchOptions = {
-  limit?: number;
-  sources?: Array<"memory" | "sessions">;
+  timestamp: string;
+  source?: "cron";
 };
-type MemoryChangeSource = "memory" | "sessions";
-type MemoryChangedEvent = {
-  reason: string;
-  files: string[];
-  source: MemoryChangeSource;
-  sessionId?: string;
-  providerId?: string;
+/** The result returned by a single tool execution */
+type ToolResultEntry = {
+  role: "tool_result"; /** Matches AssistantEntry.toolCalls[].id */
+  toolCallId: string;
+  toolName: string; /** Text output of the tool */
+  content: string;
+  isError: boolean;
+  toolResultRef?: ToolResultReference;
   timestamp: string;
+  source?: "cron";
 };
-type MemoryChangedHandler = (event: MemoryChangedEvent) => void | Promise<void>;
-type MemoryProvider = {
-  id: string;
-  name?: string;
-  status: () => MemoryProviderStatus;
-  search: (query: string, options?: MemorySearchOptions) => Promise<MemorySearchResult$1[]>;
-  getLines: (file: string, startLine: number, endLine: number) => Promise<string[] | null>;
-  listFiles: () => Promise<string[]>;
-  append: (content: string) => Promise<void>; /** Write a daily or session log entry. Falls back to append() if not implemented. */
-  appendRecent?: (content: string, scope: "daily" | "session") => Promise<void>;
-  updateFile: (file: string, content: string) => Promise<void>;
-  deleteFile: (file: string) => Promise<void>;
-  sync?: (reason?: string) => Promise<void>;
-  noteSessionUpdate?: (sessionFile: string) => void;
-  onMemoryChanged?: MemoryChangedHandler;
+/**
+ * A compaction record written after LLM-based history summarisation.
+ * `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";
 };
-type MemoryProviderFactory = (ctx: MemoryProviderContext) => MemoryProvider;
+/** 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";
@@ -934,134 +1077,6 @@ declare function generateSessionTitle(params: GenerateTitleParams): Promise<stri
  */
 declare function runAgent(params: AgentRunParams, _registryForTesting?: SubagentRegistry): Promise<AgentRunResult>;
 //#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>;
-/** Ensures a session directory exists (for resuming an existing session) */
-declare function ensureSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<void>;
-/** Loads all transcript entries from a session */
-declare function loadTranscript(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<TranscriptEntry[]>;
-declare function appendArtifactOperation(dataDir: string, sessionId: string, operation: ArtifactOperationInput, options?: SessionPathOptions): Promise<void>;
-declare function loadArtifactOperations(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<ArtifactOperation[]>;
-/** Appends a single entry to the transcript file */
-declare function appendTranscriptEntry(dataDir: string, sessionId: string, entry: TranscriptEntry, options?: SessionPathOptions & {
-  providerId?: string;
-  pluginId?: string;
-  onMemoryChanged?: MemoryChangedHandler;
-}): Promise<void>;
-/** Rewrites the full transcript atomically using the provided updater. */
-declare function rewriteTranscript(dataDir: string, sessionId: string, updater: (entries: TranscriptEntry[]) => TranscriptEntry[], options?: SessionPathOptions & {
-  providerId?: string;
-  pluginId?: string;
-  onMemoryChanged?: MemoryChangedHandler;
-}): Promise<TranscriptEntry[]>;
-declare function appendCronExecutionRecord(dataDir: string, sessionId: string, record: CronExecutionRecord, options?: SessionPathOptions): Promise<void>;
-declare function loadCronExecutionRecords(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<CronExecutionRecord[]>;
-/** Lists all session IDs within a data directory */
-declare function listSessions(dataDir: string, options?: SessionPathOptions): Promise<string[]>;
-/** Saves session metadata to disk */
-declare function saveSessionMetadata(dataDir: string, metadata: SessionMetadata$1, options?: SessionPathOptions): Promise<void>;
-type SessionMetadataUpdate = Partial<Omit<SessionMetadata$1, "id" | "createdAt">>;
-declare function updateSessionMetadata(dataDir: string, sessionId: string, updates: SessionMetadataUpdate, options?: SessionPathOptions): Promise<SessionMetadata$1 | null>;
-/** Loads session metadata from disk; returns null if not found */
-declare function loadSessionMetadata(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionMetadata$1 | null>;
-/** Lists all sessions with their metadata summaries, optionally filtered by channel */
-declare function listSessionSummaries(dataDir: string, channel?: Channel, options?: SessionPathOptions): Promise<SessionSummary$1[]>;
-declare function loadSessionContextSnapshot(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionContextSnapshot>;
-declare function inspectSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionInspection>;
-declare function exportSession(dataDir: string, sessionId: string, options?: SessionPathOptions): Promise<SessionExport>;
-//#endregion
 //#region src/session/session-storage.d.ts
 declare function readSessionFile(filePath: string): Promise<string | null>;
 declare function writeSessionFile(filePath: string, content: string, encrypt?: boolean): Promise<void>;
@@ -1124,6 +1139,7 @@ type ManageLayeredHistoryParams = {
   historyLimit?: number;
   compactionEnabled?: boolean;
   pendingUserMessage?: string;
+  topicSegmentation?: TopicSegmentationConfig;
   signal?: AbortSignal;
   hooks?: PluginHookRegistry;
   hookCtx?: PluginHookAgentContext;
@@ -1132,6 +1148,8 @@ type ManageLayeredHistoryParams = {
   sessionId?: string;
   sessionStoreName?: string;
   sessionPathScope?: Pick<SessionPathOptions, "subagent">;
+  channel?: Channel$1;
+  isSubagent?: boolean;
 };
 type ManageLayeredHistoryResult = {
   messages: AgentMessage[];
@@ -2133,7 +2151,7 @@ type BatchSpawnResult = {
   status: "done" | "partial_error" | "error";
   results: BatchSpawnItemResult[];
 };
-type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
 /** Formats the announce message injected into the parent session when a subagent completes. */
 declare function buildSubagentAnnounceMessage(params: {
   task: string;
@@ -2280,7 +2298,7 @@ type SubagentToolsContext = {
   depth: number;
   channel: AgentRunParams["channel"];
   llm: AgentRunParams["llm"];
-  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
   loopDetection?: ToolLoopDetectionConfig;
   autoSkillsLoadEnabled?: boolean;
   memoryOptions?: MemoryToolOptions;