@robota-sdk/agent-sdk 3.0.0-beta.51 → 3.0.0-beta.53

package/dist/node/index.d.cts

@@ -1,10 +1,73 @@
-import { IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, THooksConfig, TTrustLevel, TPermissionMode, IAIProvider, TToolArgs, IToolWithEventService, IHistoryEntry, IContextWindowState, TUniversalMessage } from '@robota-sdk/agent-core';
-export { IAIProvider, IContextTokenUsage, IContextWindowState, IHistoryEntry, IHookInput, IPermissionLists, THookEvent, THooksConfig, TPermissionDecision, TPermissionMode, TRUST_TO_MODE, TToolArgs, TTrustLevel, chatEntryToMessage, evaluatePermission, getMessagesForAPI, isChatEntry, messageToHistoryEntry, runHooks } from '@robota-sdk/agent-core';
 import { ITerminalOutput, SessionStore, TPermissionHandler, ISessionLogger, Session, FileSessionLogger } from '@robota-sdk/agent-sessions';
 export { ISpinner, ITerminalOutput } from '@robota-sdk/agent-sessions';
+import { TToolArgs, IHistoryEntry, IContextWindowState, IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, THooksConfig, TTrustLevel, TPermissionMode, IAIProvider, IToolWithEventService, TUniversalMessage } from '@robota-sdk/agent-core';
+export { IAIProvider, IContextTokenUsage, IContextWindowState, IHistoryEntry, IHookInput, IPermissionLists, THookEvent, THooksConfig, TPermissionDecision, TPermissionMode, TRUST_TO_MODE, TToolArgs, TTrustLevel, chatEntryToMessage, evaluatePermission, getMessagesForAPI, isChatEntry, messageToHistoryEntry, runHooks } from '@robota-sdk/agent-core';
 import { createZodFunctionTool } from '@robota-sdk/agent-tools';
 export { TToolResult } from '@robota-sdk/agent-tools';
 
+/**
+ * Types for InteractiveSession — event-driven session wrapper.
+ */
+
+/** Permission handler result — SDK-owned type (mirrors agent-sessions TPermissionResult).
+ *  true = allow, false = deny, 'allow-session' = allow and remember for this session. */
+type TPermissionResultValue = boolean | 'allow-session';
+/** Tool execution state visible to clients. */
+interface IToolState {
+    toolName: string;
+    firstArg: string;
+    isRunning: boolean;
+    result?: 'success' | 'error' | 'denied';
+    diffLines?: IDiffLine[];
+    diffFile?: string;
+}
+/** A single diff line for Edit tool display. */
+interface IDiffLine {
+    type: 'add' | 'remove' | 'context';
+    text: string;
+    lineNumber: number;
+}
+/** Result of a completed prompt execution. */
+interface IExecutionResult {
+    response: string;
+    history: IHistoryEntry[];
+    toolSummaries: IToolSummary[];
+    contextState: IContextWindowState;
+}
+/** Summary of a tool call extracted from history. */
+interface IToolSummary {
+    name: string;
+    args: string;
+}
+/** Permission handler delegate — clients provide their own UI. */
+type TInteractivePermissionHandler = (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;
+/** Events emitted by InteractiveSession. */
+interface IInteractiveSessionEvents {
+    text_delta: (delta: string) => void;
+    tool_start: (state: IToolState) => void;
+    tool_end: (state: IToolState) => void;
+    thinking: (isThinking: boolean) => void;
+    complete: (result: IExecutionResult) => void;
+    error: (error: Error) => void;
+    context_update: (state: IContextWindowState) => void;
+    interrupted: (result: IExecutionResult) => void;
+}
+type TInteractiveEventName = keyof IInteractiveSessionEvents;
+/**
+ * Common interface for all transport adapters.
+ * Each transport exposes InteractiveSession over a specific protocol.
+ */
+interface ITransportAdapter {
+    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
+    readonly name: string;
+    /** Attach an InteractiveSession to this transport. */
+    attach(session: InteractiveSession): void;
+    /** Start serving. What this means depends on the transport. */
+    start(): Promise<void>;
+    /** Stop serving and clean up resources. */
+    stop(): Promise<void>;
+}
+
 /**
  * Prompt hook executor — evaluates a prompt via an AI model.
  *
@@ -357,76 +420,10 @@ declare function createSubagentLogger(parentSessionId: string, _agentId: string,
 declare function resolveSubagentLogDir(parentSessionId: string, baseLogsDir: string): string;
 
 /**
- * Types for InteractiveSession — event-driven session wrapper.
- */
-
-/** Permission handler result — SDK-owned type (mirrors agent-sessions TPermissionResult).
- *  true = allow, false = deny, 'allow-session' = allow and remember for this session. */
-type TPermissionResultValue = boolean | 'allow-session';
-/** Tool execution state visible to clients. */
-interface IToolState {
-    toolName: string;
-    firstArg: string;
-    isRunning: boolean;
-    result?: 'success' | 'error' | 'denied';
-    diffLines?: IDiffLine[];
-    diffFile?: string;
-}
-/** A single diff line for Edit tool display. */
-interface IDiffLine {
-    type: 'add' | 'remove' | 'context';
-    text: string;
-    lineNumber: number;
-}
-/** Result of a completed prompt execution. */
-interface IExecutionResult {
-    response: string;
-    history: IHistoryEntry[];
-    toolSummaries: IToolSummary[];
-    contextState: IContextWindowState;
-}
-/** Summary of a tool call extracted from history. */
-interface IToolSummary {
-    name: string;
-    args: string;
-}
-/** Permission handler delegate — clients provide their own UI. */
-type TInteractivePermissionHandler = (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;
-/** Events emitted by InteractiveSession. */
-interface IInteractiveSessionEvents {
-    text_delta: (delta: string) => void;
-    tool_start: (state: IToolState) => void;
-    tool_end: (state: IToolState) => void;
-    thinking: (isThinking: boolean) => void;
-    complete: (result: IExecutionResult) => void;
-    error: (error: Error) => void;
-    context_update: (state: IContextWindowState) => void;
-    interrupted: (result: IExecutionResult) => void;
-}
-type TInteractiveEventName = keyof IInteractiveSessionEvents;
-/**
- * Common interface for all transport adapters.
- * Each transport exposes InteractiveSession over a specific protocol.
- */
-interface ITransportAdapter {
-    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
-    readonly name: string;
-    /** Attach an InteractiveSession to this transport. */
-    attach(session: InteractiveSession): void;
-    /** Start serving. What this means depends on the transport. */
-    start(): Promise<void>;
-    /** Stop serving and clean up resources. */
-    stop(): Promise<void>;
-}
-
-/**
- * InteractiveSession — the single entry point for all SDK consumers.
+ * Session initialization helpers for InteractiveSession.
  *
- * Wraps Session (composition). Manages streaming text accumulation,
- * tool execution state tracking, prompt queuing, abort orchestration,
- * message history, and system command execution.
- *
- * Config/context loading is internal. Consumer provides cwd + provider.
+ * Handles async config/context loading, plugin merging, and session creation.
+ * Also provides session-restore (resume/fork) logic.
  */
 
 /** Standard construction: cwd + provider. Config/context loaded internally. */
@@ -454,7 +451,19 @@ interface IInteractiveSessionInjectedOptions {
     resumeSessionId?: string;
     forkSession?: boolean;
 }
+/** Union of standard and injected construction options. */
 type IInteractiveSessionOptions = IInteractiveSessionStandardOptions | IInteractiveSessionInjectedOptions;
+
+/**
+ * InteractiveSession — the single entry point for all SDK consumers.
+ *
+ * Wraps Session (composition). Manages streaming text accumulation,
+ * tool execution state tracking, prompt queuing, abort orchestration,
+ * message history, and system command execution.
+ *
+ * Config/context loading is internal. Consumer provides cwd + provider.
+ */
+
 declare class InteractiveSession {
     private session;
     private readonly commandExecutor;
@@ -482,53 +491,35 @@ declare class InteractiveSession {
     on<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
     off<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
     private emit;
-    /** Submit a prompt. Queues if already executing (max 1 queued). */
     submit(input: string, displayInput?: string, rawInput?: string): Promise<void>;
-    /** Execute a system command by name. Returns null if not found. */
     executeCommand(name: string, args: string): Promise<{
         message: string;
         success: boolean;
         data?: Record<string, unknown>;
     } | null>;
-    /** List all registered system commands. */
     listCommands(): Array<{
         name: string;
         description: string;
     }>;
-    /** Abort current execution and clear queue. */
     abort(): void;
-    /** Cancel queued prompt without aborting current execution. */
     cancelQueue(): void;
+    private clearPendingQueue;
     isExecuting(): boolean;
     getPendingPrompt(): string | null;
-    /** Get full history timeline (chat + events) for TUI rendering */
     getFullHistory(): IHistoryEntry[];
-    /** Get chat messages only (backward compatible) */
     getMessages(): TUniversalMessage[];
     getStreamingText(): string;
     getActiveTools(): IToolState[];
     getContextState(): IContextWindowState;
-    /** Get session name. */
     getName(): string | undefined;
-    /** Set session name and persist if store is available. */
+    getSession(): Session;
     setName(name: string): void;
-    /** Attach a transport adapter to this session. Calls transport.attach(this). */
     attachTransport(transport: ITransportAdapter): void;
-    /** Access underlying Session. For advanced use / testing only. */
-    getSession(): Session;
     private executePrompt;
     private handleTextDelta;
     private handleToolExecution;
-    /** Push tool execution summary into messages (before Robota response).
-     *  Moves tool info from activeTools (real-time display) to messages (permanent display).
-     *  After this, activeTools will be cleared by clearStreaming(). */
-    private pushToolSummaryMessage;
     private clearStreaming;
     private flushStreaming;
-    private buildResult;
-    private buildInterruptedResult;
-    private extractToolSummaries;
-    private trimCompletedTools;
 }
 
 /**
@@ -796,11 +787,7 @@ declare class BundlePluginLoader {
 }
 
 /**
- * MarketplaceClient — manages marketplace registries via shallow git clones.
- *
- * Marketplaces are git repositories containing `.claude-plugin/marketplace.json`.
- * They are cloned to `~/.robota/plugins/marketplaces/<name>/` and tracked
- * in `known_marketplaces.json`.
+ * Shared types for marketplace client and registry.
  */
 /** Source specification for a marketplace. */
 type IMarketplaceSource = {
@@ -858,6 +845,15 @@ interface IMarketplaceClientOptions {
     /** Custom exec function for testing (replaces child_process.execSync). */
     exec?: ExecFn$1;
 }
+
+/**
+ * MarketplaceClient — manages marketplace registries via shallow git clones.
+ *
+ * Marketplaces are git repositories containing `.claude-plugin/marketplace.json`.
+ * They are cloned to `~/.robota/plugins/marketplaces/<name>/` and tracked
+ * in `known_marketplaces.json`.
+ */
+
 /** Manages marketplace registries via shallow git clones. */
 declare class MarketplaceClient {
     private readonly pluginsDir;
@@ -868,10 +864,9 @@ declare class MarketplaceClient {
     /**
      * Add a marketplace by cloning its repository.
      *
-     * 1. Parse source: `owner/repo` string becomes a GitHub source.
-     * 2. Shallow git clone (`--depth 1`) to `marketplaces/<name>/`.
-     * 3. Read `.claude-plugin/marketplace.json` for the `name` field.
-     * 4. Register in `known_marketplaces.json`.
+     * 1. Shallow git clone (`--depth 1`) to `marketplaces/<name>/`.
+     * 2. Read `.claude-plugin/marketplace.json` for the `name` field.
+     * 3. Register in `known_marketplaces.json`.
      *
      * Returns the registered marketplace name from the manifest.
      */
@@ -886,9 +881,6 @@ declare class MarketplaceClient {
      * Update a marketplace by running git pull on its clone.
      * The manifest is re-read from disk on demand (via fetchManifest), so the
      * updated manifest is automatically available after pull.
-     *
-     * TODO: After pull, detect version changes in installed plugins and offer
-     * to update them (re-install at new version).
      */
     updateMarketplace(name: string): void;
     /** List all registered marketplaces. */
@@ -897,9 +889,7 @@ declare class MarketplaceClient {
         source: IMarketplaceSource;
         lastUpdated: string;
     }>;
-    /**
-     * Read the marketplace manifest from a registered marketplace's clone.
-     */
+    /** Read the marketplace manifest from a registered marketplace's clone. */
     fetchManifest(marketplaceName: string): IMarketplaceManifest;
     /** Get the clone directory path for a registered marketplace. */
     getMarketplaceDir(name: string): string;
@@ -914,18 +904,8 @@ declare class MarketplaceClient {
     }>;
     /** Resolve a marketplace source to a git clone URL. */
     private resolveCloneUrl;
-    /**
-     * Remove all installed plugins that belong to a given marketplace.
-     * Reads installed_plugins.json, deletes cache directories for matching plugins,
-     * and updates the registry.
-     */
-    private removeInstalledPluginsForMarketplace;
     /** Read and parse a marketplace.json from a file path. */
     private readManifestFromPath;
-    /** Read the known_marketplaces.json registry. */
-    private readRegistry;
-    /** Write the known_marketplaces.json registry. */
-    private writeRegistry;
     /** Default exec implementation using child_process. */
     private defaultExec;
 }

package/dist/node/index.d.ts

@@ -1,10 +1,73 @@
-import { IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, THooksConfig, TTrustLevel, TPermissionMode, IAIProvider, TToolArgs, IToolWithEventService, IHistoryEntry, IContextWindowState, TUniversalMessage } from '@robota-sdk/agent-core';
-export { IAIProvider, IContextTokenUsage, IContextWindowState, IHistoryEntry, IHookInput, IPermissionLists, THookEvent, THooksConfig, TPermissionDecision, TPermissionMode, TRUST_TO_MODE, TToolArgs, TTrustLevel, chatEntryToMessage, evaluatePermission, getMessagesForAPI, isChatEntry, messageToHistoryEntry, runHooks } from '@robota-sdk/agent-core';
 import { ITerminalOutput, SessionStore, TPermissionHandler, ISessionLogger, Session, FileSessionLogger } from '@robota-sdk/agent-sessions';
 export { ISpinner, ITerminalOutput } from '@robota-sdk/agent-sessions';
+import { TToolArgs, IHistoryEntry, IContextWindowState, IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, THooksConfig, TTrustLevel, TPermissionMode, IAIProvider, IToolWithEventService, TUniversalMessage } from '@robota-sdk/agent-core';
+export { IAIProvider, IContextTokenUsage, IContextWindowState, IHistoryEntry, IHookInput, IPermissionLists, THookEvent, THooksConfig, TPermissionDecision, TPermissionMode, TRUST_TO_MODE, TToolArgs, TTrustLevel, chatEntryToMessage, evaluatePermission, getMessagesForAPI, isChatEntry, messageToHistoryEntry, runHooks } from '@robota-sdk/agent-core';
 import { createZodFunctionTool } from '@robota-sdk/agent-tools';
 export { TToolResult } from '@robota-sdk/agent-tools';
 
+/**
+ * Types for InteractiveSession — event-driven session wrapper.
+ */
+
+/** Permission handler result — SDK-owned type (mirrors agent-sessions TPermissionResult).
+ *  true = allow, false = deny, 'allow-session' = allow and remember for this session. */
+type TPermissionResultValue = boolean | 'allow-session';
+/** Tool execution state visible to clients. */
+interface IToolState {
+    toolName: string;
+    firstArg: string;
+    isRunning: boolean;
+    result?: 'success' | 'error' | 'denied';
+    diffLines?: IDiffLine[];
+    diffFile?: string;
+}
+/** A single diff line for Edit tool display. */
+interface IDiffLine {
+    type: 'add' | 'remove' | 'context';
+    text: string;
+    lineNumber: number;
+}
+/** Result of a completed prompt execution. */
+interface IExecutionResult {
+    response: string;
+    history: IHistoryEntry[];
+    toolSummaries: IToolSummary[];
+    contextState: IContextWindowState;
+}
+/** Summary of a tool call extracted from history. */
+interface IToolSummary {
+    name: string;
+    args: string;
+}
+/** Permission handler delegate — clients provide their own UI. */
+type TInteractivePermissionHandler = (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;
+/** Events emitted by InteractiveSession. */
+interface IInteractiveSessionEvents {
+    text_delta: (delta: string) => void;
+    tool_start: (state: IToolState) => void;
+    tool_end: (state: IToolState) => void;
+    thinking: (isThinking: boolean) => void;
+    complete: (result: IExecutionResult) => void;
+    error: (error: Error) => void;
+    context_update: (state: IContextWindowState) => void;
+    interrupted: (result: IExecutionResult) => void;
+}
+type TInteractiveEventName = keyof IInteractiveSessionEvents;
+/**
+ * Common interface for all transport adapters.
+ * Each transport exposes InteractiveSession over a specific protocol.
+ */
+interface ITransportAdapter {
+    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
+    readonly name: string;
+    /** Attach an InteractiveSession to this transport. */
+    attach(session: InteractiveSession): void;
+    /** Start serving. What this means depends on the transport. */
+    start(): Promise<void>;
+    /** Stop serving and clean up resources. */
+    stop(): Promise<void>;
+}
+
 /**
  * Prompt hook executor — evaluates a prompt via an AI model.
  *
@@ -357,76 +420,10 @@ declare function createSubagentLogger(parentSessionId: string, _agentId: string,
 declare function resolveSubagentLogDir(parentSessionId: string, baseLogsDir: string): string;
 
 /**
- * Types for InteractiveSession — event-driven session wrapper.
- */
-
-/** Permission handler result — SDK-owned type (mirrors agent-sessions TPermissionResult).
- *  true = allow, false = deny, 'allow-session' = allow and remember for this session. */
-type TPermissionResultValue = boolean | 'allow-session';
-/** Tool execution state visible to clients. */
-interface IToolState {
-    toolName: string;
-    firstArg: string;
-    isRunning: boolean;
-    result?: 'success' | 'error' | 'denied';
-    diffLines?: IDiffLine[];
-    diffFile?: string;
-}
-/** A single diff line for Edit tool display. */
-interface IDiffLine {
-    type: 'add' | 'remove' | 'context';
-    text: string;
-    lineNumber: number;
-}
-/** Result of a completed prompt execution. */
-interface IExecutionResult {
-    response: string;
-    history: IHistoryEntry[];
-    toolSummaries: IToolSummary[];
-    contextState: IContextWindowState;
-}
-/** Summary of a tool call extracted from history. */
-interface IToolSummary {
-    name: string;
-    args: string;
-}
-/** Permission handler delegate — clients provide their own UI. */
-type TInteractivePermissionHandler = (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;
-/** Events emitted by InteractiveSession. */
-interface IInteractiveSessionEvents {
-    text_delta: (delta: string) => void;
-    tool_start: (state: IToolState) => void;
-    tool_end: (state: IToolState) => void;
-    thinking: (isThinking: boolean) => void;
-    complete: (result: IExecutionResult) => void;
-    error: (error: Error) => void;
-    context_update: (state: IContextWindowState) => void;
-    interrupted: (result: IExecutionResult) => void;
-}
-type TInteractiveEventName = keyof IInteractiveSessionEvents;
-/**
- * Common interface for all transport adapters.
- * Each transport exposes InteractiveSession over a specific protocol.
- */
-interface ITransportAdapter {
-    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
-    readonly name: string;
-    /** Attach an InteractiveSession to this transport. */
-    attach(session: InteractiveSession): void;
-    /** Start serving. What this means depends on the transport. */
-    start(): Promise<void>;
-    /** Stop serving and clean up resources. */
-    stop(): Promise<void>;
-}
-
-/**
- * InteractiveSession — the single entry point for all SDK consumers.
+ * Session initialization helpers for InteractiveSession.
  *
- * Wraps Session (composition). Manages streaming text accumulation,
- * tool execution state tracking, prompt queuing, abort orchestration,
- * message history, and system command execution.
- *
- * Config/context loading is internal. Consumer provides cwd + provider.
+ * Handles async config/context loading, plugin merging, and session creation.
+ * Also provides session-restore (resume/fork) logic.
  */
 
 /** Standard construction: cwd + provider. Config/context loaded internally. */
@@ -454,7 +451,19 @@ interface IInteractiveSessionInjectedOptions {
     resumeSessionId?: string;
     forkSession?: boolean;
 }
+/** Union of standard and injected construction options. */
 type IInteractiveSessionOptions = IInteractiveSessionStandardOptions | IInteractiveSessionInjectedOptions;
+
+/**
+ * InteractiveSession — the single entry point for all SDK consumers.
+ *
+ * Wraps Session (composition). Manages streaming text accumulation,
+ * tool execution state tracking, prompt queuing, abort orchestration,
+ * message history, and system command execution.
+ *
+ * Config/context loading is internal. Consumer provides cwd + provider.
+ */
+
 declare class InteractiveSession {
     private session;
     private readonly commandExecutor;
@@ -482,53 +491,35 @@ declare class InteractiveSession {
     on<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
     off<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
     private emit;
-    /** Submit a prompt. Queues if already executing (max 1 queued). */
     submit(input: string, displayInput?: string, rawInput?: string): Promise<void>;
-    /** Execute a system command by name. Returns null if not found. */
     executeCommand(name: string, args: string): Promise<{
         message: string;
         success: boolean;
         data?: Record<string, unknown>;
     } | null>;
-    /** List all registered system commands. */
     listCommands(): Array<{
         name: string;
         description: string;
     }>;
-    /** Abort current execution and clear queue. */
     abort(): void;
-    /** Cancel queued prompt without aborting current execution. */
     cancelQueue(): void;
+    private clearPendingQueue;
     isExecuting(): boolean;
     getPendingPrompt(): string | null;
-    /** Get full history timeline (chat + events) for TUI rendering */
     getFullHistory(): IHistoryEntry[];
-    /** Get chat messages only (backward compatible) */
     getMessages(): TUniversalMessage[];
     getStreamingText(): string;
     getActiveTools(): IToolState[];
     getContextState(): IContextWindowState;
-    /** Get session name. */
     getName(): string | undefined;
-    /** Set session name and persist if store is available. */
+    getSession(): Session;
     setName(name: string): void;
-    /** Attach a transport adapter to this session. Calls transport.attach(this). */
     attachTransport(transport: ITransportAdapter): void;
-    /** Access underlying Session. For advanced use / testing only. */
-    getSession(): Session;
     private executePrompt;
     private handleTextDelta;
     private handleToolExecution;
-    /** Push tool execution summary into messages (before Robota response).
-     *  Moves tool info from activeTools (real-time display) to messages (permanent display).
-     *  After this, activeTools will be cleared by clearStreaming(). */
-    private pushToolSummaryMessage;
     private clearStreaming;
     private flushStreaming;
-    private buildResult;
-    private buildInterruptedResult;
-    private extractToolSummaries;
-    private trimCompletedTools;
 }
 
 /**
@@ -796,11 +787,7 @@ declare class BundlePluginLoader {
 }
 
 /**
- * MarketplaceClient — manages marketplace registries via shallow git clones.
- *
- * Marketplaces are git repositories containing `.claude-plugin/marketplace.json`.
- * They are cloned to `~/.robota/plugins/marketplaces/<name>/` and tracked
- * in `known_marketplaces.json`.
+ * Shared types for marketplace client and registry.
  */
 /** Source specification for a marketplace. */
 type IMarketplaceSource = {
@@ -858,6 +845,15 @@ interface IMarketplaceClientOptions {
     /** Custom exec function for testing (replaces child_process.execSync). */
     exec?: ExecFn$1;
 }
+
+/**
+ * MarketplaceClient — manages marketplace registries via shallow git clones.
+ *
+ * Marketplaces are git repositories containing `.claude-plugin/marketplace.json`.
+ * They are cloned to `~/.robota/plugins/marketplaces/<name>/` and tracked
+ * in `known_marketplaces.json`.
+ */
+
 /** Manages marketplace registries via shallow git clones. */
 declare class MarketplaceClient {
     private readonly pluginsDir;
@@ -868,10 +864,9 @@ declare class MarketplaceClient {
     /**
      * Add a marketplace by cloning its repository.
      *
-     * 1. Parse source: `owner/repo` string becomes a GitHub source.
-     * 2. Shallow git clone (`--depth 1`) to `marketplaces/<name>/`.
-     * 3. Read `.claude-plugin/marketplace.json` for the `name` field.
-     * 4. Register in `known_marketplaces.json`.
+     * 1. Shallow git clone (`--depth 1`) to `marketplaces/<name>/`.
+     * 2. Read `.claude-plugin/marketplace.json` for the `name` field.
+     * 3. Register in `known_marketplaces.json`.
      *
      * Returns the registered marketplace name from the manifest.
      */
@@ -886,9 +881,6 @@ declare class MarketplaceClient {
      * Update a marketplace by running git pull on its clone.
      * The manifest is re-read from disk on demand (via fetchManifest), so the
      * updated manifest is automatically available after pull.
-     *
-     * TODO: After pull, detect version changes in installed plugins and offer
-     * to update them (re-install at new version).
      */
     updateMarketplace(name: string): void;
     /** List all registered marketplaces. */
@@ -897,9 +889,7 @@ declare class MarketplaceClient {
         source: IMarketplaceSource;
         lastUpdated: string;
     }>;
-    /**
-     * Read the marketplace manifest from a registered marketplace's clone.
-     */
+    /** Read the marketplace manifest from a registered marketplace's clone. */
     fetchManifest(marketplaceName: string): IMarketplaceManifest;
     /** Get the clone directory path for a registered marketplace. */
     getMarketplaceDir(name: string): string;
@@ -914,18 +904,8 @@ declare class MarketplaceClient {
     }>;
     /** Resolve a marketplace source to a git clone URL. */
     private resolveCloneUrl;
-    /**
-     * Remove all installed plugins that belong to a given marketplace.
-     * Reads installed_plugins.json, deletes cache directories for matching plugins,
-     * and updates the registry.
-     */
-    private removeInstalledPluginsForMarketplace;
     /** Read and parse a marketplace.json from a file path. */
     private readManifestFromPath;
-    /** Read the known_marketplaces.json registry. */
-    private readRegistry;
-    /** Write the known_marketplaces.json registry. */
-    private writeRegistry;
     /** Default exec implementation using child_process. */
     private defaultExec;
 }