npm - @ai-agent-forge/agent-forge - Versions diffs - 0.86.7 → 0.88.0 - Mend

@ai-agent-forge/agent-forge 0.86.7 → 0.88.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (717) hide show

package/dist/modes/rpc/rpc-types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"rpc-types.js","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/*\n RPC protocol types for headless operation.\n \n Commands are sent as JSON lines on stdin.\n * Responses and events are emitted as JSON lines on stdout.\n /\n\nimport type { AgentMessage, ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, ImageContent, Model } from \"@agent-forge/ai\";\nimport type { PromptDisposition, QueuedInputDisposition, SessionStats } from \"../../core/agent-session.ts\";\nimport type { BashResult } from \"../../core/bash-executor.ts\";\nimport type { CompactionResult } from \"../../core/compaction/index.ts\";\nimport type { SessionEntry, SessionTreeNode } from \"../../core/session-manager.ts\";\nimport type { SourceInfo } from \"../../core/source-info.ts\";\nimport type { MetricsSnapshotV1 } from \"../../plugins/observability-types.ts\";\n\n// ============================================================================\n// RPC Commands (stdin)\n// ============================================================================\n\nexport type RpcCommand =\n\t// Prompting\n\t\| { id?: string; type: \"prompt\"; message: string; images?: ImageContent[]; streamingBehavior?: \"steer\" \| \"followUp\" }\n\t\| { id?: string; type: \"steer\"; message: string; images?: ImageContent[] }\n\t\| { id?: string; type: \"follow_up\"; message: string; images?: ImageContent[] }\n\t\| { id?: string; type: \"abort\" }\n\t\| { id?: string; type: \"clear_queue\" }\n\t\| { id?: string; type: \"new_session\"; parentSession?: string }\n\n\t// State\n\t\| { id?: string; type: \"get_state\" }\n\n\t// Model\n\t\| { id?: string; type: \"set_model\"; provider: string; modelId: string }\n\t\| { id?: string; type: \"cycle_model\" }\n\t\| { id?: string; type: \"get_available_models\" }\n\n\t// Thinking\n\t\| { id?: string; type: \"set_thinking_level\"; level: ThinkingLevel }\n\t\| { id?: string; type: \"cycle_thinking_level\" }\n\t\| { id?: string; type: \"get_available_thinking_levels\" }\n\n\t// Queue modes\n\t\| { id?: string; type: \"set_steering_mode\"; mode: \"all\" \| \"one-at-a-time\" }\n\t\| { id?: string; type: \"set_follow_up_mode\"; mode: \"all\" \| \"one-at-a-time\" }\n\n\t// Compaction\n\t\| { id?: string; type: \"compact\"; customInstructions?: string }\n\t\| { id?: string; type: \"set_auto_compaction\"; enabled: boolean }\n\n\t// Retry\n\t\| { id?: string; type: \"set_auto_retry\"; enabled: boolean }\n\t\| { id?: string; type: \"abort_retry\" }\n\n\t// Bash\n\t\| { id?: string; type: \"bash\"; command: string; excludeFromContext?: boolean }\n\t\| { id?: string; type: \"abort_bash\" }\n\n\t// Session\n\t\| { id?: string; type: \"get_session_stats\" }\n\t\| { id?: string; type: \"export_html\"; outputPath?: string }\n\t\| { id?: string; type: \"switch_session\"; sessionPath: string }\n\t\| { id?: string; type: \"fork\"; entryId: string }\n\t\| { id?: string; type: \"clone\" }\n\t\| { id?: string; type: \"get_fork_messages\" }\n\t\| { id?: string; type: \"get_entries\"; since?: string }\n\t\| { id?: string; type: \"get_tree\" }\n\t\| { id?: string; type: \"get_last_assistant_text\" }\n\t\| { id?: string; type: \"set_session_name\"; name: string }\n\n\t// Messages\n\t\| { id?: string; type: \"get_messages\" }\n\n\t// Metrics\n\t\| { id?: string; type: \"get_metrics\"; windowTurns?: number }\n\n\t// Commands (available for invocation via prompt)\n\t\| { id?: string; type: \"get_commands\" };\n\n// ============================================================================\n// RPC Slash Command (for get_commands response)\n// ============================================================================\n\n/* A command available for invocation via prompt /\nexport interface RpcSlashCommand {\n\t/* Command name (without leading slash) /\n\tname: string;\n\t/* Human-readable description /\n\tdescription?: string;\n\t/* What kind of command this is /\n\tsource: \"extension\" \| \"prompt\" \| \"skill\" \| \"capability\";\n\t/* Source metadata for the owning resource /\n\tsourceInfo: SourceInfo;\n}\n\n// ============================================================================\n// RPC State\n// ============================================================================\n\nexport interface RpcSessionState {\n\tmodel?: Model<Api>;\n\tthinkingLevel: ThinkingLevel;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tsteeringMode: \"all\" \| \"one-at-a-time\";\n\tfollowUpMode: \"all\" \| \"one-at-a-time\";\n\tsessionFile?: string;\n\tsessionId: string;\n\tsessionName?: string;\n\t/\n\t Suite (方案) the session is bound to (统一修复轮 B), read from the\n\t * session's SUITE_SESSION_ENTRY_TYPE custom entry. Absent for sessions\n\t * without a recorded binding.\n\t /\n\tsuiteId?: string;\n\tautoCompactionEnabled: boolean;\n\tmessageCount: number;\n\tpendingMessageCount: number;\n}\n\n// ============================================================================\n// RPC Responses (stdout)\n// ============================================================================\n\n// Success responses with data\nexport type RpcResponse =\n\t// Prompting (async - events follow)\n\t// `data` is optional for backward compatibility with older protocol peers that\n\t// omit it; current servers always include it.\n\t\| { id?: string; type: \"response\"; command: \"prompt\"; success: true; data?: { disposition: PromptDisposition } }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"steer\";\n\t\t\tsuccess: true;\n\t\t\tdata?: { disposition: QueuedInputDisposition };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"follow_up\";\n\t\t\tsuccess: true;\n\t\t\tdata?: { disposition: QueuedInputDisposition };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"abort\"; success: true }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"clear_queue\";\n\t\t\tsuccess: true;\n\t\t\tdata: { steering: string[]; followUp: string[] };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"new_session\"; success: true; data: { cancelled: boolean } }\n\n\t// State\n\t\| { id?: string; type: \"response\"; command: \"get_state\"; success: true; data: RpcSessionState }\n\n\t// Model\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"set_model\";\n\t\t\tsuccess: true;\n\t\t\tdata: Model<Api>;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"cycle_model\";\n\t\t\tsuccess: true;\n\t\t\tdata: { model: Model<Api>; thinkingLevel: ThinkingLevel; isScoped: boolean } \| null;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_available_models\";\n\t\t\tsuccess: true;\n\t\t\tdata: { models: Model<Api>[] };\n\t }\n\n\t// Thinking\n\t\| { id?: string; type: \"response\"; command: \"set_thinking_level\"; success: true }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"cycle_thinking_level\";\n\t\t\tsuccess: true;\n\t\t\tdata: { level: ThinkingLevel } \| null;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_available_thinking_levels\";\n\t\t\tsuccess: true;\n\t\t\tdata: { levels: ThinkingLevel[] };\n\t }\n\n\t// Queue modes\n\t\| { id?: string; type: \"response\"; command: \"set_steering_mode\"; success: true }\n\t\| { id?: string; type: \"response\"; command: \"set_follow_up_mode\"; success: true }\n\n\t// Compaction\n\t\| { id?: string; type: \"response\"; command: \"compact\"; success: true; data: CompactionResult }\n\t\| { id?: string; type: \"response\"; command: \"set_auto_compaction\"; success: true }\n\n\t// Retry\n\t\| { id?: string; type: \"response\"; command: \"set_auto_retry\"; success: true }\n\t\| { id?: string; type: \"response\"; command: \"abort_retry\"; success: true }\n\n\t// Bash\n\t\| { id?: string; type: \"response\"; command: \"bash\"; success: true; data: BashResult }\n\t\| { id?: string; type: \"response\"; command: \"abort_bash\"; success: true }\n\n\t// Session\n\t\| { id?: string; type: \"response\"; command: \"get_session_stats\"; success: true; data: SessionStats }\n\t\| { id?: string; type: \"response\"; command: \"export_html\"; success: true; data: { path: string } }\n\t\| { id?: string; type: \"response\"; command: \"switch_session\"; success: true; data: { cancelled: boolean } }\n\t\| { id?: string; type: \"response\"; command: \"fork\"; success: true; data: { text: string; cancelled: boolean } }\n\t\| { id?: string; type: \"response\"; command: \"clone\"; success: true; data: { cancelled: boolean } }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_fork_messages\";\n\t\t\tsuccess: true;\n\t\t\tdata: { messages: Array<{ entryId: string; text: string; replySummary?: string }> };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_entries\";\n\t\t\tsuccess: true;\n\t\t\tdata: { entries: SessionEntry[]; leafId: string \| null };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_tree\";\n\t\t\tsuccess: true;\n\t\t\tdata: { tree: SessionTreeNode[]; leafId: string \| null };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_last_assistant_text\";\n\t\t\tsuccess: true;\n\t\t\tdata: { text: string \| null };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"set_session_name\"; success: true }\n\n\t// Messages\n\t\| { id?: string; type: \"response\"; command: \"get_messages\"; success: true; data: { messages: AgentMessage[] } }\n\n\t// Metrics\n\t\| { id?: string; type: \"response\"; command: \"get_metrics\"; success: true; data: MetricsSnapshotV1 }\n\n\t// Commands\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_commands\";\n\t\t\tsuccess: true;\n\t\t\tdata: { commands: RpcSlashCommand[] };\n\t }\n\n\t// Error response (any command can fail)\n\t\| { id?: string; type: \"response\"; command: string; success: false; error: string };\n\n// ============================================================================\n// Extension UI Events (stdout)\n// ============================================================================\n\n/* Emitted when an extension needs user input /\nexport type RpcExtensionUIRequest =\n\t\| { type: \"extension_ui_request\"; id: string; method: \"select\"; title: string; options: string[]; timeout?: number }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"confirm\"; title: string; message: string; timeout?: number }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"input\";\n\t\t\ttitle: string;\n\t\t\tplaceholder?: string;\n\t\t\ttimeout?: number;\n\t }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"editor\"; title: string; prefill?: string }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"notify\";\n\t\t\tmessage: string;\n\t\t\tnotifyType?: \"info\" \| \"warning\" \| \"error\";\n\t }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"setStatus\";\n\t\t\tstatusKey: string;\n\t\t\tstatusText: string \| undefined;\n\t }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"setWidget\";\n\t\t\twidgetKey: string;\n\t\t\twidgetLines: string[] \| undefined;\n\t\t\twidgetPlacement?: \"aboveEditor\" \| \"belowEditor\";\n\t }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"setTitle\"; title: string }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"set_editor_text\"; text: string };\n\n// ============================================================================\n// Extension UI Commands (stdin)\n// ============================================================================\n\n/* Response to an extension UI request */\nexport type RpcExtensionUIResponse =\n\t\| { type: \"extension_ui_response\"; id: string; value: string }\n\t\| { type: \"extension_ui_response\"; id: string; confirmed: boolean }\n\t\| { type: \"extension_ui_response\"; id: string; cancelled: true };\n\n// ============================================================================\n// Helper type for extracting command types\n// ============================================================================\n\nexport type RpcCommandType = RpcCommand[\"type\"];\n"]}
1	+ {"version":3,"file":"rpc-types.js","sourceRoot":"","sources":["../../../src/modes/rpc/rpc-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/*\n RPC protocol types for headless operation.\n \n Commands are sent as JSON lines on stdin.\n * Responses and events are emitted as JSON lines on stdout.\n /\n\nimport type { AgentMessage, ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, ImageContent, Model } from \"@agent-forge/ai\";\nimport type { PromptDisposition, QueuedInputDisposition, SessionStats } from \"../../core/agent-session.ts\";\nimport type { BashResult } from \"../../core/bash-executor.ts\";\nimport type { CompactionResult } from \"../../core/compaction/index.ts\";\nimport type { SessionEntry, SessionTreeNode } from \"../../core/session-manager.ts\";\nimport type { SourceInfo } from \"../../core/source-info.ts\";\nimport type { MetricsSnapshotV1 } from \"../../plugins/observability-types.ts\";\n\n// ============================================================================\n// RPC Commands (stdin)\n// ============================================================================\n\nexport type RpcCommand =\n\t// Prompting\n\t\| { id?: string; type: \"prompt\"; message: string; images?: ImageContent[]; streamingBehavior?: \"steer\" \| \"followUp\" }\n\t\| { id?: string; type: \"steer\"; message: string; images?: ImageContent[] }\n\t\| { id?: string; type: \"follow_up\"; message: string; images?: ImageContent[] }\n\t\| { id?: string; type: \"abort\" }\n\t\| { id?: string; type: \"clear_queue\" }\n\t\| { id?: string; type: \"new_session\"; parentSession?: string }\n\n\t// State\n\t\| { id?: string; type: \"get_state\" }\n\n\t// Model\n\t\| { id?: string; type: \"set_model\"; provider: string; modelId: string }\n\t\| { id?: string; type: \"cycle_model\" }\n\t\| { id?: string; type: \"get_available_models\" }\n\n\t// Thinking\n\t\| { id?: string; type: \"set_thinking_level\"; level: ThinkingLevel }\n\t\| { id?: string; type: \"cycle_thinking_level\" }\n\t\| { id?: string; type: \"get_available_thinking_levels\" }\n\n\t// Queue modes\n\t\| { id?: string; type: \"set_steering_mode\"; mode: \"all\" \| \"one-at-a-time\" }\n\t\| { id?: string; type: \"set_follow_up_mode\"; mode: \"all\" \| \"one-at-a-time\" }\n\n\t// Compaction\n\t\| { id?: string; type: \"compact\"; customInstructions?: string }\n\n\t// Retry\n\t\| { id?: string; type: \"abort_retry\" }\n\n\t// Bash\n\t\| { id?: string; type: \"bash\"; command: string; excludeFromContext?: boolean }\n\t\| { id?: string; type: \"abort_bash\" }\n\n\t// Session\n\t\| { id?: string; type: \"get_session_stats\" }\n\t\| { id?: string; type: \"export_html\"; outputPath?: string }\n\t\| { id?: string; type: \"switch_session\"; sessionPath: string }\n\t\| { id?: string; type: \"fork\"; entryId: string }\n\t\| { id?: string; type: \"clone\" }\n\t\| { id?: string; type: \"get_fork_messages\" }\n\t\| { id?: string; type: \"get_entries\"; since?: string }\n\t\| { id?: string; type: \"get_tree\" }\n\t\| { id?: string; type: \"get_last_assistant_text\" }\n\t\| { id?: string; type: \"set_session_name\"; name: string }\n\n\t// Messages\n\t\| { id?: string; type: \"get_messages\" }\n\n\t// Metrics\n\t\| { id?: string; type: \"get_metrics\"; windowTurns?: number }\n\n\t// Commands (available for invocation via prompt)\n\t\| { id?: string; type: \"get_commands\" };\n\n// ============================================================================\n// RPC Slash Command (for get_commands response)\n// ============================================================================\n\n/* A command available for invocation via prompt /\nexport interface RpcSlashCommand {\n\t/* Command name (without leading slash) /\n\tname: string;\n\t/* Human-readable description /\n\tdescription?: string;\n\t/* What kind of command this is /\n\tsource: \"extension\" \| \"prompt\" \| \"skill\" \| \"capability\";\n\t/* Source metadata for the owning resource /\n\tsourceInfo: SourceInfo;\n}\n\n// ============================================================================\n// RPC State\n// ============================================================================\n\nexport interface RpcSessionState {\n\tmodel?: Model<Api>;\n\tthinkingLevel: ThinkingLevel;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tsteeringMode: \"all\" \| \"one-at-a-time\";\n\tfollowUpMode: \"all\" \| \"one-at-a-time\";\n\tsessionFile?: string;\n\tsessionId: string;\n\tsessionName?: string;\n\t/\n\t Suite (方案) the session is bound to (统一修复轮 B), read from the\n\t * session's SUITE_SESSION_ENTRY_TYPE custom entry. Absent for sessions\n\t * without a recorded binding.\n\t /\n\tsuiteId?: string;\n\tmessageCount: number;\n\tpendingMessageCount: number;\n}\n\n// ============================================================================\n// RPC Responses (stdout)\n// ============================================================================\n\n// Success responses with data\nexport type RpcResponse =\n\t// Prompting (async - events follow)\n\t// `data` is optional for backward compatibility with older protocol peers that\n\t// omit it; current servers always include it.\n\t\| { id?: string; type: \"response\"; command: \"prompt\"; success: true; data?: { disposition: PromptDisposition } }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"steer\";\n\t\t\tsuccess: true;\n\t\t\tdata?: { disposition: QueuedInputDisposition };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"follow_up\";\n\t\t\tsuccess: true;\n\t\t\tdata?: { disposition: QueuedInputDisposition };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"abort\"; success: true }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"clear_queue\";\n\t\t\tsuccess: true;\n\t\t\tdata: { steering: string[]; followUp: string[] };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"new_session\"; success: true; data: { cancelled: boolean } }\n\n\t// State\n\t\| { id?: string; type: \"response\"; command: \"get_state\"; success: true; data: RpcSessionState }\n\n\t// Model\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"set_model\";\n\t\t\tsuccess: true;\n\t\t\tdata: Model<Api>;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"cycle_model\";\n\t\t\tsuccess: true;\n\t\t\tdata: { model: Model<Api>; thinkingLevel: ThinkingLevel; isScoped: boolean } \| null;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_available_models\";\n\t\t\tsuccess: true;\n\t\t\tdata: { models: Model<Api>[] };\n\t }\n\n\t// Thinking\n\t\| { id?: string; type: \"response\"; command: \"set_thinking_level\"; success: true }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"cycle_thinking_level\";\n\t\t\tsuccess: true;\n\t\t\tdata: { level: ThinkingLevel } \| null;\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_available_thinking_levels\";\n\t\t\tsuccess: true;\n\t\t\tdata: { levels: ThinkingLevel[] };\n\t }\n\n\t// Queue modes\n\t\| { id?: string; type: \"response\"; command: \"set_steering_mode\"; success: true }\n\t\| { id?: string; type: \"response\"; command: \"set_follow_up_mode\"; success: true }\n\n\t// Compaction\n\t\| { id?: string; type: \"response\"; command: \"compact\"; success: true; data: CompactionResult }\n\n\t// Retry\n\t\| { id?: string; type: \"response\"; command: \"abort_retry\"; success: true }\n\n\t// Bash\n\t\| { id?: string; type: \"response\"; command: \"bash\"; success: true; data: BashResult }\n\t\| { id?: string; type: \"response\"; command: \"abort_bash\"; success: true }\n\n\t// Session\n\t\| { id?: string; type: \"response\"; command: \"get_session_stats\"; success: true; data: SessionStats }\n\t\| { id?: string; type: \"response\"; command: \"export_html\"; success: true; data: { path: string } }\n\t\| { id?: string; type: \"response\"; command: \"switch_session\"; success: true; data: { cancelled: boolean } }\n\t\| { id?: string; type: \"response\"; command: \"fork\"; success: true; data: { text: string; cancelled: boolean } }\n\t\| { id?: string; type: \"response\"; command: \"clone\"; success: true; data: { cancelled: boolean } }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_fork_messages\";\n\t\t\tsuccess: true;\n\t\t\tdata: { messages: Array<{ entryId: string; text: string; replySummary?: string }> };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_entries\";\n\t\t\tsuccess: true;\n\t\t\tdata: { entries: SessionEntry[]; leafId: string \| null };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_tree\";\n\t\t\tsuccess: true;\n\t\t\tdata: { tree: SessionTreeNode[]; leafId: string \| null };\n\t }\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_last_assistant_text\";\n\t\t\tsuccess: true;\n\t\t\tdata: { text: string \| null };\n\t }\n\t\| { id?: string; type: \"response\"; command: \"set_session_name\"; success: true }\n\n\t// Messages\n\t\| { id?: string; type: \"response\"; command: \"get_messages\"; success: true; data: { messages: AgentMessage[] } }\n\n\t// Metrics\n\t\| { id?: string; type: \"response\"; command: \"get_metrics\"; success: true; data: MetricsSnapshotV1 }\n\n\t// Commands\n\t\| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"get_commands\";\n\t\t\tsuccess: true;\n\t\t\tdata: { commands: RpcSlashCommand[] };\n\t }\n\n\t// Error response (any command can fail)\n\t\| { id?: string; type: \"response\"; command: string; success: false; error: string };\n\n// ============================================================================\n// Extension UI Events (stdout)\n// ============================================================================\n\n/* Emitted when an extension needs user input /\nexport type RpcExtensionUIRequest =\n\t\| { type: \"extension_ui_request\"; id: string; method: \"select\"; title: string; options: string[]; timeout?: number }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"confirm\"; title: string; message: string; timeout?: number }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"input\";\n\t\t\ttitle: string;\n\t\t\tplaceholder?: string;\n\t\t\ttimeout?: number;\n\t }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"editor\"; title: string; prefill?: string }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"notify\";\n\t\t\tmessage: string;\n\t\t\tnotifyType?: \"info\" \| \"warning\" \| \"error\";\n\t }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"setStatus\";\n\t\t\tstatusKey: string;\n\t\t\tstatusText: string \| undefined;\n\t }\n\t\| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"setWidget\";\n\t\t\twidgetKey: string;\n\t\t\twidgetLines: string[] \| undefined;\n\t\t\twidgetPlacement?: \"aboveEditor\" \| \"belowEditor\";\n\t }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"setTitle\"; title: string }\n\t\| { type: \"extension_ui_request\"; id: string; method: \"set_editor_text\"; text: string };\n\n// ============================================================================\n// Extension UI Commands (stdin)\n// ============================================================================\n\n/* Response to an extension UI request */\nexport type RpcExtensionUIResponse =\n\t\| { type: \"extension_ui_response\"; id: string; value: string }\n\t\| { type: \"extension_ui_response\"; id: string; confirmed: boolean }\n\t\| { type: \"extension_ui_response\"; id: string; cancelled: true };\n\n// ============================================================================\n// Helper type for extracting command types\n// ============================================================================\n\nexport type RpcCommandType = RpcCommand[\"type\"];\n"]}

package/dist/package-manager-cli.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"package-manager-cli.d.ts","sourceRoot":"","sources":["../src/package-manager-cli.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAkCpF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AA4HtE,wBAAgB,qBAAqB,IAAI,IAAI,CAmB5C;AA2jBD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,yBAAyB,CAAC;IAC7D,oEAAoE;IACpE,QAAQ,CAAC,8BAA8B,CAAC,EAAE,yBAAyB,CAAC;CACpE;AAMD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0E1G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+N3E","sourcesContent":["import {\n\texistsSync,\n\tmkdirSync,\n\tmkdtempSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\trmSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { Markdown, type MarkdownTheme } from \"@agent-forge/tui\";\nimport chalk from \"chalk\";\nimport lockfile from \"proper-lockfile\";\nimport { selectConfig } from \"./cli/config-selector.ts\";\nimport { createDefaultPluginManagerControllerV1 } from \"./cli/plugin-command.ts\";\nimport type { PluginManagerControllerV1 } from \"./cli/plugin-manager-controller.ts\";\nimport { createPluginSelectionControllerV1 } from \"./cli/plugin-selection-controller.ts\";\nimport {\n\tAPP_NAME,\n\tCONFIG_DIR_NAME,\n\tdetectInstallMethod,\n\tgetAgentDir,\n\tgetPackageDir,\n\tgetSelfUpdateCommand,\n\tgetSelfUpdateUnavailableInstruction,\n\tPACKAGE_NAME,\n\ttype SelfUpdateCommand,\n\ttype SelfUpdatePackageTarget,\n\tVERSION,\n} from \"./config.ts\";\nimport { ModelRuntime } from \"./core/model-runtime.ts\";\nimport { DefaultPackageManager } from \"./core/package-manager.ts\";\nimport { SettingsManager } from \"./core/settings-manager.ts\";\nimport { createPluginSelectionStoreV1 } from \"./plugins/ecosystem/selection-store.ts\";\nimport { getAgentForgeUserAgent } from \"./utils/agent-forge-user-agent.ts\";\nimport { spawnProcess, spawnProcessSync, waitForChildProcess } from \"./utils/child-process.ts\";\nimport { canonicalizePath, getCwdRelativePath } from \"./utils/paths.ts\";\nimport { sleep } from \"./utils/sleep.ts\";\nimport {\n\tEXPECTED_PACKAGE_NAME,\n\tformatVersionCheckError,\n\tgetLatestRelease,\n\tisNewerPackageVersion,\n} from \"./utils/version-check.ts\";\nimport {\n\tcleanupWindowsSelfUpdateQuarantine,\n\tquarantineWindowsNativeDependencies,\n} from \"./utils/windows-self-update.ts\";\n\nexport type PackageCommand = \"install\" \| \"remove\" \| \"update\" \| \"list\";\n\ntype UpdateTarget = { type: \"all\" } \| { type: \"self\" } \| { type: \"packages\"; source?: string } \| { type: \"models\" };\n\nconst MANAGED_INSTALL_MARKER = \"managed-install.json\";\nconst MANAGED_RELEASE_VERSION_RE = /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nfunction getActiveManagedInstallRoot(): string \| undefined {\n\tconst configuredRoot = process.env.AGENT_FORGE_MANAGED_INSTALL_ROOT?.trim();\n\tif (!configuredRoot) return undefined;\n\n\tconst managedRoot = resolve(configuredRoot);\n\tconst releasesDir = canonicalizePath(join(managedRoot, \"releases\"));\n\t// The launcher environment is inherited by child processes. Do not classify a\n\t// source checkout or another installation launched from a managed release as managed.\n\tif (getCwdRelativePath(canonicalizePath(getPackageDir()), releasesDir) === undefined) return undefined;\n\n\tconst markerPath = join(managedRoot, MANAGED_INSTALL_MARKER);\n\ttry {\n\t\tconst marker = JSON.parse(readFileSync(markerPath, \"utf8\")) as {\n\t\t\tkind?: unknown;\n\t\t\tlayout?: unknown;\n\t\t\tschemaVersion?: unknown;\n\t\t};\n\t\tif (\n\t\t\tmarker.kind !== \"agent-forge-managed-install\" \|\|\n\t\t\tmarker.schemaVersion !== 1 \|\|\n\t\t\tmarker.layout !== \"releases-v1\"\n\t\t) {\n\t\t\tthrow new Error();\n\t\t}\n\t} catch {\n\t\tthrow new Error(`Managed install marker is missing or invalid: ${markerPath}`);\n\t}\n\n\treturn managedRoot;\n}\n\nasync function fetchInstallerArtifact(url: string, label: string): Promise<string> {\n\tconst response = await fetch(url, { headers: { \"User-Agent\": getAgentForgeUserAgent(VERSION) } });\n\tif (!response.ok) {\n\t\tthrow new Error(`Could not download managed installer ${label} from ${url}: HTTP ${response.status}`);\n\t}\n\treturn await response.text();\n}\n\nasync function runManagedNpmCi(stageDir: string): Promise<void> {\n\tconst args = [\n\t\t\"ci\",\n\t\t\"--ignore-scripts\",\n\t\t\"--min-release-age=0\",\n\t\t\"--omit=dev\",\n\t\t\"--include=optional\",\n\t\t\"--no-fund\",\n\t\t\"--no-audit\",\n\t\t\"--loglevel=error\",\n\t\t\"--progress=false\",\n\t];\n\tconst code = await waitForChildProcess(spawnProcess(\"npm\", args, { cwd: stageDir, stdio: \"inherit\" }));\n\tif (code !== 0) throw new Error(`npm ${args.join(\" \")} exited with code ${code ?? \"unknown\"}`);\n}\n\nfunction verifyManagedRelease(releaseDir: string, expectedVersion: string): void {\n\tconst binPath = join(\n\t\treleaseDir,\n\t\t\"node_modules\",\n\t\t\".bin\",\n\t\tprocess.platform === \"win32\" ? `${APP_NAME}.cmd` : APP_NAME,\n\t);\n\tconst result = spawnProcessSync(binPath, [\"--version\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.error \|\| result.status !== 0) {\n\t\tconst reason = result.error?.message \|\| result.stderr.trim() \|\| `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Could not verify managed ${APP_NAME} ${expectedVersion}: ${reason}`);\n\t}\n\tconst installedVersion = result.stdout.trim();\n\tif (installedVersion !== expectedVersion) {\n\t\tthrow new Error(\n\t\t\t`Managed ${APP_NAME} smoke test returned version ${installedVersion}; expected ${expectedVersion}.`,\n\t\t);\n\t}\n}\n\n// Windows AV/indexer can hold freshly written staging files for many seconds\n// under IO load; retry the rename generously instead of failing the whole\n// self-update (observed EBUSY past 3s during full-suite runs).\nasync function activateStagedRelease(stageDir: string, releaseDir: string): Promise<void> {\n\tfor (let attempt = 0; ; attempt++) {\n\t\ttry {\n\t\t\trenameSync(stageDir, releaseDir);\n\t\t\treturn;\n\t\t} catch (error) {\n\t\t\tif (attempt >= 9 \|\| !existsSync(stageDir)) throw error;\n\t\t\tawait sleep(1000);\n\t\t}\n\t}\n}\n\nfunction activateManagedRelease(managedRoot: string, version: string): void {\n\tconst currentPath = join(managedRoot, \"current-version\");\n\tconst temporaryPath = join(managedRoot, `current-version.tmp.${process.pid}-${Date.now()}`);\n\ttry {\n\t\twriteFileSync(temporaryPath, `${version}\\n`);\n\t\trenameSync(temporaryPath, currentPath);\n\t} finally {\n\t\trmSync(temporaryPath, { force: true });\n\t}\n}\n\nfunction cleanupManagedStaging(managedRoot: string): void {\n\tconst stagingRoot = join(managedRoot, \"staging\");\n\ttry {\n\t\tfor (const entry of readdirSync(stagingRoot)) {\n\t\t\tif (entry.startsWith(\"update-\")) {\n\t\t\t\trmSync(join(stagingRoot, entry), { force: true, recursive: true });\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// The staging directory does not exist yet or is not writable.\n\t}\n}\n\nexport function cleanupManagedInstall(): void {\n\tlet managedRoot: string \| undefined;\n\ttry {\n\t\tmanagedRoot = getActiveManagedInstallRoot();\n\t} catch {\n\t\treturn;\n\t}\n\tif (!managedRoot) return;\n\n\ttry {\n\t\tconst releaseLock = lockfile.lockSync(join(managedRoot, \"update\"), { realpath: false });\n\t\ttry {\n\t\t\tcleanupManagedStaging(managedRoot);\n\t\t} finally {\n\t\t\treleaseLock();\n\t\t}\n\t} catch {\n\t\t// A live update owns the staging directory, or cleanup is unavailable.\n\t}\n}\n\nasync function runManagedSelfUpdate(managedRoot: string, version: string): Promise<void> {\n\tif (!MANAGED_RELEASE_VERSION_RE.test(version)) {\n\t\tthrow new Error(`Invalid managed release version: ${version}`);\n\t}\n\n\tlet releaseLock: () => Promise<void>;\n\ttry {\n\t\treleaseLock = await lockfile.lock(join(managedRoot, \"update\"), { realpath: false });\n\t} catch (error: unknown) {\n\t\tif (error instanceof Error && \"code\" in error && error.code === \"ELOCKED\") {\n\t\t\tthrow new Error(`Another managed ${APP_NAME} update is already running.`);\n\t\t}\n\t\tthrow error;\n\t}\n\n\tlet stageDir: string \| undefined;\n\ttry {\n\t\tcleanupManagedStaging(managedRoot);\n\t\tconst installerApiBase = process.env.AGENT_FORGE_INSTALLER_API_BASE?.trim().replace(/\\/+$/, \"\");\n\t\tif (!installerApiBase) {\n\t\t\tthrow new Error(\"Managed self-update requires AGENT_FORGE_INSTALLER_API_BASE to be configured.\");\n\t\t}\n\t\tconst releaseUrl = `${installerApiBase}/${encodeURIComponent(version)}`;\n\t\tconst stagingRoot = join(managedRoot, \"staging\");\n\t\tconst releasesRoot = join(managedRoot, \"releases\");\n\t\tmkdirSync(releasesRoot, { recursive: true });\n\t\tconst releaseDir = join(releasesRoot, version);\n\t\tif (existsSync(releaseDir)) {\n\t\t\tverifyManagedRelease(releaseDir, version);\n\t\t\tactivateManagedRelease(managedRoot, version);\n\t\t\treturn;\n\t\t}\n\n\t\tmkdirSync(stagingRoot, { recursive: true });\n\t\tstageDir = mkdtempSync(join(stagingRoot, \"update-\"));\n\t\tconst [packageJsonContent, packageLockContent] = await Promise.all([\n\t\t\tfetchInstallerArtifact(`${releaseUrl}/package.json`, \"package.json\"),\n\t\t\tfetchInstallerArtifact(`${releaseUrl}/package-lock.json`, \"package-lock.json\"),\n\t\t]);\n\t\twriteFileSync(join(stageDir, \"package.json\"), packageJsonContent);\n\t\twriteFileSync(join(stageDir, \"package-lock.json\"), packageLockContent);\n\n\t\tawait runManagedNpmCi(stageDir);\n\t\tverifyManagedRelease(stageDir, version);\n\t\tawait activateStagedRelease(stageDir, releaseDir);\n\t\tactivateManagedRelease(managedRoot, version);\n\t} finally {\n\t\t// Staging files may still be held briefly by AV/scanner on Windows; a\n\t\t// failed cleanup must not mask the actual update error (or success).\n\t\ttry {\n\t\t\tif (stageDir) rmSync(stageDir, { force: true, recursive: true });\n\t\t} catch {\n\t\t\t// Orphaned staging dirs are removed by the next cleanupManagedStaging.\n\t\t}\n\t\tawait releaseLock();\n\t}\n}\n\nconst SELF_UPDATE_NOTE_MARKDOWN_THEME: MarkdownTheme = {\n\theading: (text) => chalk.bold(chalk.yellow(text)),\n\tlink: (text) => chalk.cyan(text),\n\tlinkUrl: (text) => chalk.dim(text),\n\tcode: (text) => chalk.yellow(text),\n\tcodeBlock: (text) => chalk.dim(text),\n\tcodeBlockBorder: (text) => chalk.dim(text),\n\tquote: (text) => chalk.dim(text),\n\tquoteBorder: (text) => chalk.dim(text),\n\thr: (text) => chalk.dim(text),\n\tlistBullet: (text) => chalk.yellow(text),\n\tbold: (text) => chalk.bold(text),\n\titalic: (text) => chalk.italic(text),\n\tstrikethrough: (text) => chalk.strikethrough(text),\n\tunderline: (text) => chalk.underline(text),\n};\n\ninterface PackageCommandOptions {\n\tcommand: PackageCommand;\n\tsource?: string;\n\tupdateTarget?: UpdateTarget;\n\tshowPackagesSkippedNote: boolean;\n\tlocal: boolean;\n\tforce: boolean;\n\thelp: boolean;\n\tinvalidOption?: string;\n\tinvalidArgument?: string;\n\tmissingOptionValue?: string;\n\tconflictingOptions?: string;\n}\n\nfunction reportSettingsErrors(settingsManager: SettingsManager, context: string): void {\n\tconst errors = settingsManager.drainErrors();\n\tfor (const { scope, error } of errors) {\n\t\tconsole.error(chalk.yellow(`Warning (${context}, ${scope} settings): ${error.message}`));\n\t\tif (error.stack) {\n\t\t\tconsole.error(chalk.dim(error.stack));\n\t\t}\n\t}\n}\n\nfunction getPackageCommandUsage(command: PackageCommand): string {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\treturn `${APP_NAME} install <source> [-l]`;\n\t\tcase \"remove\":\n\t\t\treturn `${APP_NAME} remove <source> [-l]`;\n\t\tcase \"update\":\n\t\t\treturn `${APP_NAME} update [source\|self] [--self\|--packages\|--models\|--all] [--package <source>] [--force]`;\n\t\tcase \"list\":\n\t\t\treturn `${APP_NAME} list`;\n\t}\n}\n\nconst CONFIG_COMMAND_USAGE = `${APP_NAME} config [-l]`;\n\nfunction createConfigPluginSelectionController(agentDir: string, cwd: string, scope: \"global\" \| \"project\") {\n\treturn createPluginSelectionControllerV1({\n\t\tstore: createPluginSelectionStoreV1({\n\t\t\tfilePath:\n\t\t\t\tscope === \"project\"\n\t\t\t\t\t? join(cwd, CONFIG_DIR_NAME, \".plugin-selection.json\")\n\t\t\t\t\t: join(agentDir, \".plugin-selection.json\"),\n\t\t}),\n\t\tscope,\n\t\thost: {\n\t\t\tos: process.platform === \"win32\" ? \"windows\" : process.platform === \"darwin\" ? \"macos\" : \"linux\",\n\t\t\tarch: process.arch === \"x64\" \|\| process.arch === \"arm64\" ? process.arch : \"any\",\n\t\t\truntime: [{ name: \"node\", version: process.versions.node }],\n\t\t\tapiVersion: \"1\",\n\t\t\thostFeatures: [\"desktop-control\"],\n\t\t},\n\t});\n}\n\nfunction printConfigCommandHelp(): void {\n\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${CONFIG_COMMAND_USAGE}\n\nOpen the resource configuration TUI to enable or disable package resources.\nWithout -l, starts in global settings (~/${CONFIG_DIR_NAME}/agent/settings.json).\nPress Tab in the TUI to switch between global and project-local modes.\n\nOptions:\n -l, --local Edit project overrides (${CONFIG_DIR_NAME}/settings.json)\n`);\n}\n\nfunction printPackageCommandHelp(command: PackageCommand): void {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"install\")}\n\nInstall a package and add it to settings.\n\nOptions:\n -l, --local Install project-locally (${CONFIG_DIR_NAME}/settings.json)\n\nExamples:\n ${APP_NAME} install npm:@foo/bar\n ${APP_NAME} install git:github.com/user/repo\n ${APP_NAME} install git:git@github.com:user/repo\n ${APP_NAME} install https://github.com/user/repo\n ${APP_NAME} install ssh://git@github.com/user/repo\n ${APP_NAME} install ./local/path\n`);\n\t\t\treturn;\n\n\t\tcase \"remove\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"remove\")}\n\nRemove a package and its source from settings.\nAlias: ${APP_NAME} uninstall <source> [-l]\n\nOptions:\n -l, --local Remove from project settings (${CONFIG_DIR_NAME}/settings.json)\n\nExamples:\n ${APP_NAME} remove npm:@foo/bar\n ${APP_NAME} uninstall npm:@foo/bar\n`);\n\t\t\treturn;\n\n\t\tcase \"update\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"update\")}\n\nUpdate Agent Forge, installed packages, or model catalogs.\n\nOptions:\n --self Update Agent Forge only (default when no target is given)\n --packages Update installed packages only\n --models Refresh model catalogs only\n --all Update Agent Forge and installed packages\n --package <source> Update one package only\n --force Reinstall Agent Forge even if the current version is latest\n\nShort forms:\n ${APP_NAME} update Update Agent Forge only\n ${APP_NAME} update --all Update Agent Forge and all packages\n ${APP_NAME} update --models Refresh model catalogs only\n ${APP_NAME} update <source> Update one package\n ${APP_NAME} update self Update Agent Forge only\n`);\n\t\t\treturn;\n\n\t\tcase \"list\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"list\")}\n\nList installed packages from user and project settings.\n\nOptions:\n Project packages are loaded from project settings without a core approval prompt.\n`);\n\t\t\treturn;\n\t}\n}\n\nfunction parsePackageCommand(args: string[]): PackageCommandOptions \| undefined {\n\tconst [rawCommand, ...rest] = args;\n\tlet command: PackageCommand \| undefined;\n\tif (rawCommand === \"uninstall\") {\n\t\tcommand = \"remove\";\n\t} else if (rawCommand === \"install\" \|\| rawCommand === \"remove\" \|\| rawCommand === \"update\" \|\| rawCommand === \"list\") {\n\t\tcommand = rawCommand;\n\t}\n\tif (!command) {\n\t\treturn undefined;\n\t}\n\n\tlet local = false;\n\tlet force = false;\n\tlet help = false;\n\tlet invalidOption: string \| undefined;\n\tlet invalidArgument: string \| undefined;\n\tlet missingOptionValue: string \| undefined;\n\tlet conflictingOptions: string \| undefined;\n\tlet source: string \| undefined;\n\tlet selfFlag = false;\n\tlet packagesFlag = false;\n\tlet modelsFlag = false;\n\tlet allFlag = false;\n\tlet packageFlagSource: string \| undefined;\n\n\tfor (let index = 0; index < rest.length; index++) {\n\t\tconst arg = rest[index];\n\t\tif (arg === \"-h\" \|\| arg === \"--help\") {\n\t\t\thelp = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"-l\" \|\| arg === \"--local\") {\n\t\t\tif (command === \"install\" \|\| command === \"remove\") {\n\t\t\t\tlocal = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--self\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tselfFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--packages\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tpackagesFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--models\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tmodelsFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--all\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tallFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--force\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tforce = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--package\") {\n\t\t\tif (command !== \"update\") {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst value = rest[index + 1];\n\t\t\tif (!value \|\| value.startsWith(\"-\")) {\n\t\t\t\tmissingOptionValue = missingOptionValue ?? arg;\n\t\t\t} else if (packageFlagSource) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package can only be provided once\";\n\t\t\t\tindex++;\n\t\t\t} else {\n\t\t\t\tpackageFlagSource = value;\n\t\t\t\tindex++;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg.startsWith(\"-\")) {\n\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!source) {\n\t\t\tsource = arg;\n\t\t} else {\n\t\t\tinvalidArgument = invalidArgument ?? arg;\n\t\t}\n\t}\n\n\tlet updateTarget: UpdateTarget \| undefined;\n\tlet showPackagesSkippedNote = false;\n\tif (command === \"update\") {\n\t\tif (allFlag && (selfFlag \|\| packagesFlag \|\| modelsFlag \|\| packageFlagSource)) {\n\t\t\tconflictingOptions =\n\t\t\t\tconflictingOptions ?? \"--all cannot be combined with --self, --packages, --models, or --package\";\n\t\t}\n\t\tif (allFlag && source) {\n\t\t\tconflictingOptions = conflictingOptions ?? \"--all cannot be combined with a positional source\";\n\t\t}\n\n\t\tif (modelsFlag) {\n\t\t\tif (selfFlag \|\| packagesFlag \|\| allFlag \|\| packageFlagSource) {\n\t\t\t\tconflictingOptions =\n\t\t\t\t\tconflictingOptions ?? \"--models cannot be combined with --self, --packages, --all, or --package\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--models cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"models\" };\n\t\t} else if (packageFlagSource) {\n\t\t\tif (selfFlag \|\| packagesFlag \|\| allFlag) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package cannot be combined with --self, --packages, or --all\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"packages\", source: packageFlagSource };\n\t\t} else if (source) {\n\t\t\tconst sourceIsSelf = source === \"self\";\n\t\t\tif (sourceIsSelf) {\n\t\t\t\tupdateTarget = packagesFlag ? { type: \"all\" } : { type: \"self\" };\n\t\t\t} else {\n\t\t\t\tif (packagesFlag \|\| selfFlag \|\| allFlag) {\n\t\t\t\t\tconflictingOptions =\n\t\t\t\t\t\tconflictingOptions ??\n\t\t\t\t\t\t\"positional update targets cannot be combined with --self, --packages, or --all\";\n\t\t\t\t}\n\t\t\t\tupdateTarget = { type: \"packages\", source };\n\t\t\t}\n\t\t} else if (allFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag && packagesFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag) {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t} else if (packagesFlag) {\n\t\t\tupdateTarget = { type: \"packages\" };\n\t\t} else {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t\tshowPackagesSkippedNote = true;\n\t\t}\n\t}\n\n\treturn {\n\t\tcommand,\n\t\tsource,\n\t\tupdateTarget,\n\t\tshowPackagesSkippedNote,\n\t\tlocal,\n\t\tforce,\n\t\thelp,\n\t\tinvalidOption,\n\t\tinvalidArgument,\n\t\tmissingOptionValue,\n\t\tconflictingOptions,\n\t};\n}\n\nfunction updateTargetIncludesSelf(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" \|\| target.type === \"self\";\n}\n\nfunction updateTargetIncludesPackages(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" \|\| target.type === \"packages\";\n}\n\nasync function refreshModelCatalogs(agentDir: string): Promise<void> {\n\tconst controller = new AbortController();\n\tconst timeout = setTimeout(() => controller.abort(), 15_000);\n\ttry {\n\t\tconst modelRuntime = await ModelRuntime.create({\n\t\t\tauthPath: join(agentDir, \"auth.json\"),\n\t\t\tmodelsPath: join(agentDir, \"models.json\"),\n\t\t\tallowModelNetwork: false,\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tconst result = await modelRuntime.refresh({\n\t\t\tallowNetwork: true,\n\t\t\tforce: true,\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tif (result.aborted) {\n\t\t\tthrow new Error(\"Model catalog refresh timed out.\");\n\t\t}\n\t\tif (result.errors.size > 0) {\n\t\t\tconst details = Array.from(result.errors, ([provider, error]) => `${provider}: ${error.message}`).join(\"; \");\n\t\t\tthrow new Error(`Could not refresh model catalogs: ${details}`);\n\t\t}\n\t} finally {\n\t\tclearTimeout(timeout);\n\t}\n\tconsole.log(chalk.green(\"Model catalogs refreshed\"));\n}\n\nfunction printSelfUpdateUnavailable(\n\tnpmCommand?: string[],\n\tupdatePackageTarget: SelfUpdatePackageTarget = PACKAGE_NAME,\n): void {\n\tconsole.error(`error: ${APP_NAME} cannot self-update this installation.`);\n\tconsole.error(getSelfUpdateUnavailableInstruction(PACKAGE_NAME, npmCommand, updatePackageTarget));\n\n\tconst entrypoint = process.argv[1];\n\tif (entrypoint) {\n\t\tconsole.error(\"\");\n\t\tconsole.error(`Location of ${APP_NAME} executable: ${entrypoint}`);\n\t}\n}\n\nfunction printSelfUpdateFallback(command: SelfUpdateCommand): void {\n\tconsole.error(chalk.dim(`If this keeps failing, run this command yourself: ${command.display}`));\n}\n\nfunction printPnpmSelfUpdateMetadataHint(): void {\n\tconsole.error(chalk.yellow(\"If pnpm reports missing package versions, its cached registry metadata may be stale.\"));\n\tconsole.error(chalk.yellow(`Run \\`pnpm store prune\\` and retry \\`${APP_NAME} update --self\\`.`));\n}\n\nfunction printSelfUpdateNote(note: string): void {\n\tconst trimmedNote = note.trim();\n\tif (!trimmedNote) {\n\t\treturn;\n\t}\n\n\tconsole.log();\n\tconsole.log(chalk.bold(chalk.yellow(\"Update note\")));\n\ttry {\n\t\tconst width = Math.max(20, process.stdout.columns ?? 80);\n\t\tconst renderedLines = new Markdown(trimmedNote, 0, 0, SELF_UPDATE_NOTE_MARKDOWN_THEME)\n\t\t\t.render(width)\n\t\t\t.map((line) => line.trimEnd());\n\t\tconsole.log(renderedLines.join(\"\\n\"));\n\t} catch {\n\t\tconsole.log(trimmedNote);\n\t}\n\tconsole.log();\n}\n\ninterface SelfUpdatePlan {\n\tpackageName: string;\n\tinstallSpec: string;\n\tversion: string;\n\tshouldRun: boolean;\n\tnote?: string;\n}\n\nasync function getSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tlet latestRelease: Awaited<ReturnType<typeof getLatestRelease>>;\n\ttry {\n\t\tlatestRelease = await getLatestRelease(VERSION, { retry: true });\n\t} catch (error: unknown) {\n\t\tthrow new Error(`Could not determine latest ${APP_NAME} version: ${formatVersionCheckError(error)}`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (!latestRelease) {\n\t\tthrow new Error(`Could not determine latest ${APP_NAME} version.`);\n\t}\n\n\t// The version service names the OFFICIAL published distribution\n\t// (@ai-agent-forge/agent-forge, D-075) — not the local workspace package\n\t// name, which differs in dev checkouts and would contradict the\n\t// version-check layer.\n\tif (latestRelease.packageName && latestRelease.packageName !== EXPECTED_PACKAGE_NAME) {\n\t\tthrow new Error(\n\t\t\t`Version service returned an unexpected package name: ${latestRelease.packageName}. Expected ${EXPECTED_PACKAGE_NAME}.`,\n\t\t);\n\t}\n\tconst packageName = PACKAGE_NAME;\n\tconst installSpec = `${packageName}@${latestRelease.version}`;\n\tif (force \|\| isNewerPackageVersion(latestRelease.version, VERSION)) {\n\t\treturn {\n\t\t\tpackageName,\n\t\t\tinstallSpec,\n\t\t\tversion: latestRelease.version,\n\t\t\t...(latestRelease.note ? { note: latestRelease.note } : {}),\n\t\t\tshouldRun: true,\n\t\t};\n\t}\n\n\tconsole.log(chalk.green(`${APP_NAME} is already up to date (v${VERSION})`));\n\treturn { packageName, installSpec, version: latestRelease.version, shouldRun: false };\n}\n\nasync function runSelfUpdate(command: SelfUpdateCommand): Promise<void> {\n\tconsole.log(chalk.dim(`Updating ${APP_NAME} with ${command.display}...`));\n\tfor (const step of command.steps ?? [command]) {\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst child = spawnProcess(step.command, step.args, {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t});\n\t\t\tchild.on(\"error\", (error) => {\n\t\t\t\treject(error);\n\t\t\t});\n\t\t\tchild.on(\"close\", (code, signal) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolve();\n\t\t\t\t} else if (signal) {\n\t\t\t\t\treject(new Error(`${step.display} terminated by signal ${signal}`));\n\t\t\t\t} else {\n\t\t\t\t\treject(new Error(`${step.display} exited with code ${code ?? \"unknown\"}`));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n}\n\nfunction prepareWindowsNpmSelfUpdate(): void {\n\t// v8 ignore next -- 非 Windows 平台分支，Windows 测试环境不可达\n\tif (process.platform !== \"win32\") {\n\t\treturn;\n\t}\n\n\tconst packageDir = getPackageDir();\n\tcleanupWindowsSelfUpdateQuarantine(packageDir);\n\tquarantineWindowsNativeDependencies(packageDir);\n}\n\ninterface CommandSettingsResult {\n\tsettingsManager: SettingsManager;\n}\n\n/*\n Optional host-owned dependencies for the config command.\n \n The package manager cannot construct a trustworthy registry or installer on\n * its own. Hosts that provide those dependencies may inject the bounded\n * manager controller; the default CLI leaves this undefined.\n /\nexport interface ConfigCommandOptions {\n\treadonly pluginManagerController?: PluginManagerControllerV1;\n\t/* Optional host-owned manager for project-scoped installations. */\n\treadonly projectPluginManagerController?: PluginManagerControllerV1;\n}\n\nfunction createCommandSettingsManager(options: { cwd: string; agentDir: string }): CommandSettingsResult {\n\treturn { settingsManager: SettingsManager.create(options.cwd, options.agentDir) };\n}\n\nexport async function handleConfigCommand(args: string[], options?: ConfigCommandOptions): Promise<boolean> {\n\tconst [command, ...rest] = args;\n\tif (command !== \"config\") {\n\t\treturn false;\n\t}\n\n\tif (rest.includes(\"-h\") \|\| rest.includes(\"--help\")) {\n\t\tprintConfigCommandHelp();\n\t\treturn true;\n\t}\n\n\tlet local = false;\n\tfor (const arg of rest) {\n\t\tif (arg === \"-l\" \|\| arg === \"--local\") {\n\t\t\tlocal = true;\n\t\t} else if (arg.startsWith(\"-\")) {\n\t\t\tconsole.error(chalk.red(`Unknown option ${arg} for \"config\".`));\n\t\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${CONFIG_COMMAND_USAGE}\".`));\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t\t} else {\n\t\t\tconsole.error(chalk.red(`Unexpected argument ${arg}.`));\n\t\t\tconsole.error(chalk.dim(`Usage: ${CONFIG_COMMAND_USAGE}`));\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t\t}\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst { settingsManager } = createCommandSettingsManager({\n\t\tcwd,\n\t\tagentDir,\n\t});\n\treportSettingsErrors(settingsManager, \"config command\");\n\tconst globalSettingsManager = SettingsManager.create(cwd, agentDir);\n\tconst globalResolvedPaths = await new DefaultPackageManager({\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager: globalSettingsManager,\n\t}).resolve();\n\tconst projectResolvedPaths = await new DefaultPackageManager({ cwd, agentDir, settingsManager }).resolve();\n\tconst injectedPluginManagerController = local\n\t\t? options?.projectPluginManagerController\n\t\t: options?.pluginManagerController;\n\t// The plugin manager defaults to the disk install store plus an optional\n\t// configured marketplace origin; host injection still wins entirely.\n\tconst defaultPluginManager =\n\t\tinjectedPluginManagerController === undefined\n\t\t\t? await createDefaultPluginManagerControllerV1({ agentDir, cwd, scope: local ? \"project\" : \"global\" })\n\t\t\t: undefined;\n\tconst pluginManagerController = injectedPluginManagerController ?? defaultPluginManager?.controller;\n\n\ttry {\n\t\tawait selectConfig({\n\t\t\tresolvedPaths: { global: globalResolvedPaths, project: projectResolvedPaths },\n\t\t\tsettingsManager,\n\t\t\tcwd,\n\t\t\tagentDir,\n\t\t\twriteScope: local ? \"project\" : \"global\",\n\t\t\tprojectModeAvailable: true,\n\t\t\tpluginSelectionController: createConfigPluginSelectionController(agentDir, cwd, local ? \"project\" : \"global\"),\n\t\t\t...(pluginManagerController === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\tpluginManagerController,\n\t\t\t\t\t\tpluginManagerScope: local ? \"project\" : \"global\",\n\t\t\t\t\t}),\n\t\t});\n\t} finally {\n\t\tawait defaultPluginManager?.close();\n\t}\n\n\tprocess.exit(0);\n}\n\nexport async function handlePackageCommand(args: string[]): Promise<boolean> {\n\tconst options = parsePackageCommand(args);\n\tif (!options) {\n\t\treturn false;\n\t}\n\n\tif (options.help) {\n\t\tprintPackageCommandHelp(options.command);\n\t\treturn true;\n\t}\n\n\tif (options.invalidOption) {\n\t\tconsole.error(chalk.red(`Unknown option ${options.invalidOption} for \"${options.command}\".`));\n\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${getPackageCommandUsage(options.command)}\".`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.missingOptionValue) {\n\t\tconsole.error(chalk.red(`Missing value for ${options.missingOptionValue}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.invalidArgument) {\n\t\tconsole.error(chalk.red(`Unexpected argument ${options.invalidArgument}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.conflictingOptions) {\n\t\tconsole.error(chalk.red(options.conflictingOptions));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst source = options.source;\n\tif ((options.command === \"install\" \|\| options.command === \"remove\") && !source) {\n\t\tconsole.error(chalk.red(`Missing ${options.command} source.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.command === \"update\" && options.updateTarget?.type === \"models\") {\n\t\ttry {\n\t\t\tawait refreshModelCatalogs(getAgentDir());\n\t\t} catch (error: unknown) {\n\t\t\tconst message = error instanceof Error ? error.message : \"Unknown model catalog refresh error\";\n\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\tprocess.exitCode = 1;\n\t\t}\n\t\treturn true;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst { settingsManager } = createCommandSettingsManager({\n\t\tcwd,\n\t\tagentDir,\n\t});\n\treportSettingsErrors(settingsManager, \"package command\");\n\tconst selfUpdateNpmCommand = settingsManager.getGlobalSettings().npmCommand;\n\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\n\tpackageManager.setProgressCallback((event) => {\n\t\tif (event.type === \"start\") {\n\t\t\tprocess.stdout.write(chalk.dim(`${event.message}\\n`));\n\t\t}\n\t});\n\n\ttry {\n\t\tswitch (options.command) {\n\t\t\tcase \"install\":\n\t\t\t\tawait packageManager.installAndPersist(source!, { local: options.local });\n\t\t\t\tconsole.log(chalk.green(`Installed ${source}`));\n\t\t\t\treturn true;\n\n\t\t\tcase \"remove\": {\n\t\t\t\tconst removed = await packageManager.removeAndPersist(source!, { local: options.local });\n\t\t\t\tif (!removed) {\n\t\t\t\t\tconsole.error(chalk.red(`No matching package found for ${source}`));\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\tconsole.log(chalk.green(`Removed ${source}`));\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"list\": {\n\t\t\t\tconst configuredPackages = packageManager.listConfiguredPackages();\n\t\t\t\tconst userPackages = configuredPackages.filter((pkg) => pkg.scope === \"user\");\n\t\t\t\tconst projectPackages = configuredPackages.filter((pkg) => pkg.scope === \"project\");\n\n\t\t\t\tif (configuredPackages.length === 0) {\n\t\t\t\t\tconsole.log(chalk.dim(\"No packages installed.\"));\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tconst formatPackage = (pkg: (typeof configuredPackages)[number]) => {\n\t\t\t\t\tconst display = pkg.filtered ? `${pkg.source} (filtered)` : pkg.source;\n\t\t\t\t\tconsole.log(` ${display}`);\n\t\t\t\t\tif (pkg.installedPath) {\n\t\t\t\t\t\tconsole.log(chalk.dim(` ${pkg.installedPath}`));\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tif (userPackages.length > 0) {\n\t\t\t\t\tconsole.log(chalk.bold(\"User packages:\"));\n\t\t\t\t\tfor (const pkg of userPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (projectPackages.length > 0) {\n\t\t\t\t\tif (userPackages.length > 0) console.log();\n\t\t\t\t\tconsole.log(chalk.bold(\"Project packages:\"));\n\t\t\t\t\tfor (const pkg of projectPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"update\": {\n\t\t\t\tconst target = options.updateTarget ?? { type: \"self\" };\n\t\t\t\tif (options.showPackagesSkippedNote) {\n\t\t\t\t\tconsole.log(chalk.dim(`Packages are skipped. Run ${APP_NAME} update --packages to update packages.`));\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesPackages(target)) {\n\t\t\t\t\tconst updateSource = target.type === \"packages\" ? target.source : undefined;\n\t\t\t\t\tawait packageManager.update(updateSource);\n\t\t\t\t\tif (updateSource) {\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${updateSource}`));\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconsole.log(chalk.green(\"Updated packages\"));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesSelf(target)) {\n\t\t\t\t\tconst managedInstallRoot = getActiveManagedInstallRoot();\n\t\t\t\t\tif (managedInstallRoot && options.force) {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\tchalk.red(\n\t\t\t\t\t\t\t\t`Managed ${APP_NAME} installations do not support --force; rerun the installer to repair this installation.`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdatePlan = await getSelfUpdatePlan(options.force);\n\t\t\t\t\tif (!selfUpdatePlan.shouldRun) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tif (managedInstallRoot) {\n\t\t\t\t\t\tif (selfUpdatePlan.note) {\n\t\t\t\t\t\t\tprintSelfUpdateNote(selfUpdatePlan.note);\n\t\t\t\t\t\t}\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconsole.log(chalk.dim(`Updating managed ${APP_NAME} installation...`));\n\t\t\t\t\t\t\tawait runManagedSelfUpdate(managedInstallRoot, selfUpdatePlan.version);\n\t\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown managed update error\";\n\t\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME} from ${VERSION} to ${selfUpdatePlan.version}`));\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst installMethod = detectInstallMethod();\n\t\t\t\t\tif (process.platform === \"win32\" && installMethod !== \"npm\" && installMethod !== \"pnpm\") {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\tchalk.red(`${APP_NAME} self-update on Windows is only supported for npm and pnpm installs.`),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconsole.error(chalk.dim(`Detected install method: ${installMethod}. Update ${APP_NAME} manually.`));\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdateTarget = {\n\t\t\t\t\t\tpackageName: selfUpdatePlan.packageName,\n\t\t\t\t\t\tinstallSpec: selfUpdatePlan.installSpec,\n\t\t\t\t\t};\n\t\t\t\t\tconst selfUpdateCommand = getSelfUpdateCommand(PACKAGE_NAME, selfUpdateNpmCommand, selfUpdateTarget);\n\t\t\t\t\tif (!selfUpdateCommand) {\n\t\t\t\t\t\tprintSelfUpdateUnavailable(selfUpdateNpmCommand, selfUpdateTarget);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tif (selfUpdatePlan.note) {\n\t\t\t\t\t\tprintSelfUpdateNote(selfUpdatePlan.note);\n\t\t\t\t\t}\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (installMethod === \"npm\") {\n\t\t\t\t\t\t\tprepareWindowsNpmSelfUpdate();\n\t\t\t\t\t\t}\n\t\t\t\t\t\tawait runSelfUpdate(selfUpdateCommand);\n\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\tif (installMethod === \"pnpm\") {\n\t\t\t\t\t\t\tprintPnpmSelfUpdateMetadataHint();\n\t\t\t\t\t\t}\n\t\t\t\t\t\tprintSelfUpdateFallback(selfUpdateCommand);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME} from ${VERSION} to ${selfUpdatePlan.version}`));\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n}\n"]}
1	+ {"version":3,"file":"package-manager-cli.d.ts","sourceRoot":"","sources":["../src/package-manager-cli.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAmCpF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAyItE,wBAAgB,qBAAqB,IAAI,IAAI,CAmB5C;AAokBD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,yBAAyB,CAAC;IAC7D,oEAAoE;IACpE,QAAQ,CAAC,8BAA8B,CAAC,EAAE,yBAAyB,CAAC;CACpE;AAMD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0E1G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+N3E","sourcesContent":["import {\n\texistsSync,\n\tmkdirSync,\n\tmkdtempSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\trmSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { Markdown, type MarkdownTheme } from \"@agent-forge/tui\";\nimport chalk from \"chalk\";\nimport lockfile from \"proper-lockfile\";\nimport { selectConfig } from \"./cli/config-selector.ts\";\nimport { createDefaultPluginManagerControllerV1 } from \"./cli/plugin-command.ts\";\nimport type { PluginManagerControllerV1 } from \"./cli/plugin-manager-controller.ts\";\nimport { createPluginSelectionControllerV1 } from \"./cli/plugin-selection-controller.ts\";\nimport {\n\tAPP_NAME,\n\tCONFIG_DIR_NAME,\n\tdetectInstallMethod,\n\tgetAgentDir,\n\tgetPackageDir,\n\tgetSelfUpdateCommand,\n\tgetSelfUpdateUnavailableInstruction,\n\tPACKAGE_NAME,\n\ttype SelfUpdateCommand,\n\ttype SelfUpdatePackageTarget,\n\tVERSION,\n} from \"./config.ts\";\nimport { t } from \"./core/i18n/index.ts\";\nimport { ModelRuntime } from \"./core/model-runtime.ts\";\nimport { DefaultPackageManager } from \"./core/package-manager.ts\";\nimport { SettingsManager } from \"./core/settings-manager.ts\";\nimport { createPluginSelectionStoreV1 } from \"./plugins/ecosystem/selection-store.ts\";\nimport { getAgentForgeUserAgent } from \"./utils/agent-forge-user-agent.ts\";\nimport { spawnProcess, spawnProcessSync, waitForChildProcess } from \"./utils/child-process.ts\";\nimport { canonicalizePath, getCwdRelativePath } from \"./utils/paths.ts\";\nimport { sleep } from \"./utils/sleep.ts\";\nimport {\n\tEXPECTED_PACKAGE_NAME,\n\tformatVersionCheckError,\n\tgetLatestRelease,\n\tisNewerPackageVersion,\n} from \"./utils/version-check.ts\";\nimport {\n\tcleanupWindowsSelfUpdateQuarantine,\n\tquarantineWindowsNativeDependencies,\n} from \"./utils/windows-self-update.ts\";\n\nexport type PackageCommand = \"install\" \| \"remove\" \| \"update\" \| \"list\";\n\ntype UpdateTarget = { type: \"all\" } \| { type: \"self\" } \| { type: \"packages\"; source?: string } \| { type: \"models\" };\n\nconst MANAGED_INSTALL_MARKER = \"managed-install.json\";\nconst MANAGED_RELEASE_VERSION_RE = /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nfunction getActiveManagedInstallRoot(): string \| undefined {\n\tconst configuredRoot = process.env.AGENT_FORGE_MANAGED_INSTALL_ROOT?.trim();\n\tif (!configuredRoot) return undefined;\n\n\tconst managedRoot = resolve(configuredRoot);\n\tconst releasesDir = canonicalizePath(join(managedRoot, \"releases\"));\n\t// The launcher environment is inherited by child processes. Do not classify a\n\t// source checkout or another installation launched from a managed release as managed.\n\tif (getCwdRelativePath(canonicalizePath(getPackageDir()), releasesDir) === undefined) return undefined;\n\n\tconst markerPath = join(managedRoot, MANAGED_INSTALL_MARKER);\n\ttry {\n\t\tconst marker = JSON.parse(readFileSync(markerPath, \"utf8\")) as {\n\t\t\tkind?: unknown;\n\t\t\tlayout?: unknown;\n\t\t\tschemaVersion?: unknown;\n\t\t};\n\t\tif (\n\t\t\tmarker.kind !== \"agent-forge-managed-install\" \|\|\n\t\t\tmarker.schemaVersion !== 1 \|\|\n\t\t\tmarker.layout !== \"releases-v1\"\n\t\t) {\n\t\t\tthrow new Error();\n\t\t}\n\t} catch {\n\t\tthrow new Error(t(\"Managed install marker is missing or invalid: {path}\", { path: markerPath }));\n\t}\n\n\treturn managedRoot;\n}\n\nasync function fetchInstallerArtifact(url: string, label: string): Promise<string> {\n\tconst response = await fetch(url, { headers: { \"User-Agent\": getAgentForgeUserAgent(VERSION) } });\n\tif (!response.ok) {\n\t\tthrow new Error(\n\t\t\tt(\"Could not download managed installer {label} from {url}: HTTP {status}\", {\n\t\t\t\tlabel,\n\t\t\t\turl,\n\t\t\t\tstatus: response.status,\n\t\t\t}),\n\t\t);\n\t}\n\treturn await response.text();\n}\n\nasync function runManagedNpmCi(stageDir: string): Promise<void> {\n\tconst args = [\n\t\t\"ci\",\n\t\t\"--ignore-scripts\",\n\t\t\"--min-release-age=0\",\n\t\t\"--omit=dev\",\n\t\t\"--include=optional\",\n\t\t\"--no-fund\",\n\t\t\"--no-audit\",\n\t\t\"--loglevel=error\",\n\t\t\"--progress=false\",\n\t];\n\tconst code = await waitForChildProcess(spawnProcess(\"npm\", args, { cwd: stageDir, stdio: \"inherit\" }));\n\tif (code !== 0)\n\t\tthrow new Error(t(\"npm {args} exited with code {code}\", { args: args.join(\" \"), code: code ?? \"unknown\" }));\n}\n\nfunction verifyManagedRelease(releaseDir: string, expectedVersion: string): void {\n\tconst binPath = join(\n\t\treleaseDir,\n\t\t\"node_modules\",\n\t\t\".bin\",\n\t\tprocess.platform === \"win32\" ? `${APP_NAME}.cmd` : APP_NAME,\n\t);\n\tconst result = spawnProcessSync(binPath, [\"--version\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.error \|\| result.status !== 0) {\n\t\tconst reason = result.error?.message \|\| result.stderr.trim() \|\| `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(\n\t\t\tt(\"Could not verify managed {app} {version}: {reason}\", { app: APP_NAME, version: expectedVersion, reason }),\n\t\t);\n\t}\n\tconst installedVersion = result.stdout.trim();\n\tif (installedVersion !== expectedVersion) {\n\t\tthrow new Error(\n\t\t\tt(\"Managed {app} smoke test returned version {installed}; expected {expected}.\", {\n\t\t\t\tapp: APP_NAME,\n\t\t\t\tinstalled: installedVersion,\n\t\t\t\texpected: expectedVersion,\n\t\t\t}),\n\t\t);\n\t}\n}\n\n// Windows AV/indexer can hold freshly written staging files for many seconds\n// under IO load; retry the rename generously instead of failing the whole\n// self-update (observed EBUSY past 3s during full-suite runs).\nasync function activateStagedRelease(stageDir: string, releaseDir: string): Promise<void> {\n\tfor (let attempt = 0; ; attempt++) {\n\t\ttry {\n\t\t\trenameSync(stageDir, releaseDir);\n\t\t\treturn;\n\t\t} catch (error) {\n\t\t\tif (attempt >= 9 \|\| !existsSync(stageDir)) throw error;\n\t\t\tawait sleep(1000);\n\t\t}\n\t}\n}\n\nfunction activateManagedRelease(managedRoot: string, version: string): void {\n\tconst currentPath = join(managedRoot, \"current-version\");\n\tconst temporaryPath = join(managedRoot, `current-version.tmp.${process.pid}-${Date.now()}`);\n\ttry {\n\t\twriteFileSync(temporaryPath, `${version}\\n`);\n\t\trenameSync(temporaryPath, currentPath);\n\t} finally {\n\t\trmSync(temporaryPath, { force: true });\n\t}\n}\n\nfunction cleanupManagedStaging(managedRoot: string): void {\n\tconst stagingRoot = join(managedRoot, \"staging\");\n\ttry {\n\t\tfor (const entry of readdirSync(stagingRoot)) {\n\t\t\tif (entry.startsWith(\"update-\")) {\n\t\t\t\trmSync(join(stagingRoot, entry), { force: true, recursive: true });\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// The staging directory does not exist yet or is not writable.\n\t}\n}\n\nexport function cleanupManagedInstall(): void {\n\tlet managedRoot: string \| undefined;\n\ttry {\n\t\tmanagedRoot = getActiveManagedInstallRoot();\n\t} catch {\n\t\treturn;\n\t}\n\tif (!managedRoot) return;\n\n\ttry {\n\t\tconst releaseLock = lockfile.lockSync(join(managedRoot, \"update\"), { realpath: false });\n\t\ttry {\n\t\t\tcleanupManagedStaging(managedRoot);\n\t\t} finally {\n\t\t\treleaseLock();\n\t\t}\n\t} catch {\n\t\t// A live update owns the staging directory, or cleanup is unavailable.\n\t}\n}\n\nasync function runManagedSelfUpdate(managedRoot: string, version: string): Promise<void> {\n\tif (!MANAGED_RELEASE_VERSION_RE.test(version)) {\n\t\tthrow new Error(t(\"Invalid managed release version: {version}\", { version }));\n\t}\n\n\tlet releaseLock: () => Promise<void>;\n\ttry {\n\t\treleaseLock = await lockfile.lock(join(managedRoot, \"update\"), { realpath: false });\n\t} catch (error: unknown) {\n\t\tif (error instanceof Error && \"code\" in error && error.code === \"ELOCKED\") {\n\t\t\tthrow new Error(t(\"Another managed {app} update is already running.\", { app: APP_NAME }));\n\t\t}\n\t\tthrow error;\n\t}\n\n\tlet stageDir: string \| undefined;\n\ttry {\n\t\tcleanupManagedStaging(managedRoot);\n\t\tconst installerApiBase = process.env.AGENT_FORGE_INSTALLER_API_BASE?.trim().replace(/\\/+$/, \"\");\n\t\tif (!installerApiBase) {\n\t\t\tthrow new Error(t(\"Managed self-update requires AGENT_FORGE_INSTALLER_API_BASE to be configured.\"));\n\t\t}\n\t\tconst releaseUrl = `${installerApiBase}/${encodeURIComponent(version)}`;\n\t\tconst stagingRoot = join(managedRoot, \"staging\");\n\t\tconst releasesRoot = join(managedRoot, \"releases\");\n\t\tmkdirSync(releasesRoot, { recursive: true });\n\t\tconst releaseDir = join(releasesRoot, version);\n\t\tif (existsSync(releaseDir)) {\n\t\t\tverifyManagedRelease(releaseDir, version);\n\t\t\tactivateManagedRelease(managedRoot, version);\n\t\t\treturn;\n\t\t}\n\n\t\tmkdirSync(stagingRoot, { recursive: true });\n\t\tstageDir = mkdtempSync(join(stagingRoot, \"update-\"));\n\t\tconst [packageJsonContent, packageLockContent] = await Promise.all([\n\t\t\tfetchInstallerArtifact(`${releaseUrl}/package.json`, \"package.json\"),\n\t\t\tfetchInstallerArtifact(`${releaseUrl}/package-lock.json`, \"package-lock.json\"),\n\t\t]);\n\t\twriteFileSync(join(stageDir, \"package.json\"), packageJsonContent);\n\t\twriteFileSync(join(stageDir, \"package-lock.json\"), packageLockContent);\n\n\t\tawait runManagedNpmCi(stageDir);\n\t\tverifyManagedRelease(stageDir, version);\n\t\tawait activateStagedRelease(stageDir, releaseDir);\n\t\tactivateManagedRelease(managedRoot, version);\n\t} finally {\n\t\t// Staging files may still be held briefly by AV/scanner on Windows; a\n\t\t// failed cleanup must not mask the actual update error (or success).\n\t\ttry {\n\t\t\tif (stageDir) rmSync(stageDir, { force: true, recursive: true });\n\t\t} catch {\n\t\t\t// Orphaned staging dirs are removed by the next cleanupManagedStaging.\n\t\t}\n\t\tawait releaseLock();\n\t}\n}\n\nconst SELF_UPDATE_NOTE_MARKDOWN_THEME: MarkdownTheme = {\n\theading: (text) => chalk.bold(chalk.yellow(text)),\n\tlink: (text) => chalk.cyan(text),\n\tlinkUrl: (text) => chalk.dim(text),\n\tcode: (text) => chalk.yellow(text),\n\tcodeBlock: (text) => chalk.dim(text),\n\tcodeBlockBorder: (text) => chalk.dim(text),\n\tquote: (text) => chalk.dim(text),\n\tquoteBorder: (text) => chalk.dim(text),\n\thr: (text) => chalk.dim(text),\n\tlistBullet: (text) => chalk.yellow(text),\n\tbold: (text) => chalk.bold(text),\n\titalic: (text) => chalk.italic(text),\n\tstrikethrough: (text) => chalk.strikethrough(text),\n\tunderline: (text) => chalk.underline(text),\n};\n\ninterface PackageCommandOptions {\n\tcommand: PackageCommand;\n\tsource?: string;\n\tupdateTarget?: UpdateTarget;\n\tshowPackagesSkippedNote: boolean;\n\tlocal: boolean;\n\tforce: boolean;\n\thelp: boolean;\n\tinvalidOption?: string;\n\tinvalidArgument?: string;\n\tmissingOptionValue?: string;\n\tconflictingOptions?: string;\n}\n\nfunction reportSettingsErrors(settingsManager: SettingsManager, context: string): void {\n\tconst errors = settingsManager.drainErrors();\n\tfor (const { scope, error } of errors) {\n\t\tconsole.error(chalk.yellow(`Warning (${context}, ${scope} settings): ${error.message}`));\n\t\tif (error.stack) {\n\t\t\tconsole.error(chalk.dim(error.stack));\n\t\t}\n\t}\n}\n\nfunction getPackageCommandUsage(command: PackageCommand): string {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\treturn `${APP_NAME} install <source> [-l]`;\n\t\tcase \"remove\":\n\t\t\treturn `${APP_NAME} remove <source> [-l]`;\n\t\tcase \"update\":\n\t\t\treturn `${APP_NAME} update [source\|self] [--self\|--packages\|--models\|--all] [--package <source>] [--force]`;\n\t\tcase \"list\":\n\t\t\treturn `${APP_NAME} list`;\n\t}\n}\n\nconst CONFIG_COMMAND_USAGE = `${APP_NAME} config [-l]`;\n\nfunction createConfigPluginSelectionController(agentDir: string, cwd: string, scope: \"global\" \| \"project\") {\n\treturn createPluginSelectionControllerV1({\n\t\tstore: createPluginSelectionStoreV1({\n\t\t\tfilePath:\n\t\t\t\tscope === \"project\"\n\t\t\t\t\t? join(cwd, CONFIG_DIR_NAME, \".plugin-selection.json\")\n\t\t\t\t\t: join(agentDir, \".plugin-selection.json\"),\n\t\t}),\n\t\tscope,\n\t\thost: {\n\t\t\tos: process.platform === \"win32\" ? \"windows\" : process.platform === \"darwin\" ? \"macos\" : \"linux\",\n\t\t\tarch: process.arch === \"x64\" \|\| process.arch === \"arm64\" ? process.arch : \"any\",\n\t\t\truntime: [{ name: \"node\", version: process.versions.node }],\n\t\t\tapiVersion: \"1\",\n\t\t\thostFeatures: [\"desktop-control\"],\n\t\t},\n\t});\n}\n\nfunction printConfigCommandHelp(): void {\n\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${CONFIG_COMMAND_USAGE}\n\nOpen the resource configuration TUI to enable or disable package resources.\nWithout -l, starts in global settings (~/${CONFIG_DIR_NAME}/agent/settings.json).\nPress Tab in the TUI to switch between global and project-local modes.\n\nOptions:\n -l, --local Edit project overrides (${CONFIG_DIR_NAME}/settings.json)\n`);\n}\n\nfunction printPackageCommandHelp(command: PackageCommand): void {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"install\")}\n\nInstall a package and add it to settings.\n\nOptions:\n -l, --local Install project-locally (${CONFIG_DIR_NAME}/settings.json)\n\nExamples:\n ${APP_NAME} install npm:@foo/bar\n ${APP_NAME} install git:github.com/user/repo\n ${APP_NAME} install git:git@github.com:user/repo\n ${APP_NAME} install https://github.com/user/repo\n ${APP_NAME} install ssh://git@github.com/user/repo\n ${APP_NAME} install ./local/path\n`);\n\t\t\treturn;\n\n\t\tcase \"remove\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"remove\")}\n\nRemove a package and its source from settings.\nAlias: ${APP_NAME} uninstall <source> [-l]\n\nOptions:\n -l, --local Remove from project settings (${CONFIG_DIR_NAME}/settings.json)\n\nExamples:\n ${APP_NAME} remove npm:@foo/bar\n ${APP_NAME} uninstall npm:@foo/bar\n`);\n\t\t\treturn;\n\n\t\tcase \"update\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"update\")}\n\nUpdate Agent Forge, installed packages, or model catalogs.\n\nOptions:\n --self Update Agent Forge only (default when no target is given)\n --packages Update installed packages only\n --models Refresh model catalogs only\n --all Update Agent Forge and installed packages\n --package <source> Update one package only\n --force Reinstall Agent Forge even if the current version is latest\n\nShort forms:\n ${APP_NAME} update Update Agent Forge only\n ${APP_NAME} update --all Update Agent Forge and all packages\n ${APP_NAME} update --models Refresh model catalogs only\n ${APP_NAME} update <source> Update one package\n ${APP_NAME} update self Update Agent Forge only\n`);\n\t\t\treturn;\n\n\t\tcase \"list\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n ${getPackageCommandUsage(\"list\")}\n\nList installed packages from user and project settings.\n\nOptions:\n Project packages are loaded from project settings without a core approval prompt.\n`);\n\t\t\treturn;\n\t}\n}\n\nfunction parsePackageCommand(args: string[]): PackageCommandOptions \| undefined {\n\tconst [rawCommand, ...rest] = args;\n\tlet command: PackageCommand \| undefined;\n\tif (rawCommand === \"uninstall\") {\n\t\tcommand = \"remove\";\n\t} else if (rawCommand === \"install\" \|\| rawCommand === \"remove\" \|\| rawCommand === \"update\" \|\| rawCommand === \"list\") {\n\t\tcommand = rawCommand;\n\t}\n\tif (!command) {\n\t\treturn undefined;\n\t}\n\n\tlet local = false;\n\tlet force = false;\n\tlet help = false;\n\tlet invalidOption: string \| undefined;\n\tlet invalidArgument: string \| undefined;\n\tlet missingOptionValue: string \| undefined;\n\tlet conflictingOptions: string \| undefined;\n\tlet source: string \| undefined;\n\tlet selfFlag = false;\n\tlet packagesFlag = false;\n\tlet modelsFlag = false;\n\tlet allFlag = false;\n\tlet packageFlagSource: string \| undefined;\n\n\tfor (let index = 0; index < rest.length; index++) {\n\t\tconst arg = rest[index];\n\t\tif (arg === \"-h\" \|\| arg === \"--help\") {\n\t\t\thelp = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"-l\" \|\| arg === \"--local\") {\n\t\t\tif (command === \"install\" \|\| command === \"remove\") {\n\t\t\t\tlocal = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--self\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tselfFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--packages\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tpackagesFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--models\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tmodelsFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--all\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tallFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--force\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tforce = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--package\") {\n\t\t\tif (command !== \"update\") {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst value = rest[index + 1];\n\t\t\tif (!value \|\| value.startsWith(\"-\")) {\n\t\t\t\tmissingOptionValue = missingOptionValue ?? arg;\n\t\t\t} else if (packageFlagSource) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package can only be provided once\";\n\t\t\t\tindex++;\n\t\t\t} else {\n\t\t\t\tpackageFlagSource = value;\n\t\t\t\tindex++;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg.startsWith(\"-\")) {\n\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!source) {\n\t\t\tsource = arg;\n\t\t} else {\n\t\t\tinvalidArgument = invalidArgument ?? arg;\n\t\t}\n\t}\n\n\tlet updateTarget: UpdateTarget \| undefined;\n\tlet showPackagesSkippedNote = false;\n\tif (command === \"update\") {\n\t\tif (allFlag && (selfFlag \|\| packagesFlag \|\| modelsFlag \|\| packageFlagSource)) {\n\t\t\tconflictingOptions =\n\t\t\t\tconflictingOptions ?? \"--all cannot be combined with --self, --packages, --models, or --package\";\n\t\t}\n\t\tif (allFlag && source) {\n\t\t\tconflictingOptions = conflictingOptions ?? \"--all cannot be combined with a positional source\";\n\t\t}\n\n\t\tif (modelsFlag) {\n\t\t\tif (selfFlag \|\| packagesFlag \|\| allFlag \|\| packageFlagSource) {\n\t\t\t\tconflictingOptions =\n\t\t\t\t\tconflictingOptions ?? \"--models cannot be combined with --self, --packages, --all, or --package\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--models cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"models\" };\n\t\t} else if (packageFlagSource) {\n\t\t\tif (selfFlag \|\| packagesFlag \|\| allFlag) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package cannot be combined with --self, --packages, or --all\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--package cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"packages\", source: packageFlagSource };\n\t\t} else if (source) {\n\t\t\tconst sourceIsSelf = source === \"self\";\n\t\t\tif (sourceIsSelf) {\n\t\t\t\tupdateTarget = packagesFlag ? { type: \"all\" } : { type: \"self\" };\n\t\t\t} else {\n\t\t\t\tif (packagesFlag \|\| selfFlag \|\| allFlag) {\n\t\t\t\t\tconflictingOptions =\n\t\t\t\t\t\tconflictingOptions ??\n\t\t\t\t\t\t\"positional update targets cannot be combined with --self, --packages, or --all\";\n\t\t\t\t}\n\t\t\t\tupdateTarget = { type: \"packages\", source };\n\t\t\t}\n\t\t} else if (allFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag && packagesFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag) {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t} else if (packagesFlag) {\n\t\t\tupdateTarget = { type: \"packages\" };\n\t\t} else {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t\tshowPackagesSkippedNote = true;\n\t\t}\n\t}\n\n\treturn {\n\t\tcommand,\n\t\tsource,\n\t\tupdateTarget,\n\t\tshowPackagesSkippedNote,\n\t\tlocal,\n\t\tforce,\n\t\thelp,\n\t\tinvalidOption,\n\t\tinvalidArgument,\n\t\tmissingOptionValue,\n\t\tconflictingOptions,\n\t};\n}\n\nfunction updateTargetIncludesSelf(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" \|\| target.type === \"self\";\n}\n\nfunction updateTargetIncludesPackages(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" \|\| target.type === \"packages\";\n}\n\nasync function refreshModelCatalogs(agentDir: string): Promise<void> {\n\tconst controller = new AbortController();\n\tconst timeout = setTimeout(() => controller.abort(), 15_000);\n\ttry {\n\t\tconst modelRuntime = await ModelRuntime.create({\n\t\t\tauthPath: join(agentDir, \"auth.json\"),\n\t\t\tmodelsPath: join(agentDir, \"models.json\"),\n\t\t\tallowModelNetwork: false,\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tconst result = await modelRuntime.refresh({\n\t\t\tallowNetwork: true,\n\t\t\tforce: true,\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tif (result.aborted) {\n\t\t\tthrow new Error(t(\"Model catalog refresh timed out.\"));\n\t\t}\n\t\tif (result.errors.size > 0) {\n\t\t\tconst details = Array.from(result.errors, ([provider, error]) => `${provider}: ${error.message}`).join(\"; \");\n\t\t\tthrow new Error(t(\"Could not refresh model catalogs: {details}\", { details }));\n\t\t}\n\t} finally {\n\t\tclearTimeout(timeout);\n\t}\n\tconsole.log(chalk.green(\"Model catalogs refreshed\"));\n}\n\nfunction printSelfUpdateUnavailable(\n\tnpmCommand?: string[],\n\tupdatePackageTarget: SelfUpdatePackageTarget = PACKAGE_NAME,\n): void {\n\tconsole.error(`error: ${APP_NAME} cannot self-update this installation.`);\n\tconsole.error(getSelfUpdateUnavailableInstruction(PACKAGE_NAME, npmCommand, updatePackageTarget));\n\n\tconst entrypoint = process.argv[1];\n\tif (entrypoint) {\n\t\tconsole.error(\"\");\n\t\tconsole.error(`Location of ${APP_NAME} executable: ${entrypoint}`);\n\t}\n}\n\nfunction printSelfUpdateFallback(command: SelfUpdateCommand): void {\n\tconsole.error(chalk.dim(`If this keeps failing, run this command yourself: ${command.display}`));\n}\n\nfunction printPnpmSelfUpdateMetadataHint(): void {\n\tconsole.error(chalk.yellow(\"If pnpm reports missing package versions, its cached registry metadata may be stale.\"));\n\tconsole.error(chalk.yellow(`Run \\`pnpm store prune\\` and retry \\`${APP_NAME} update --self\\`.`));\n}\n\nfunction printSelfUpdateNote(note: string): void {\n\tconst trimmedNote = note.trim();\n\tif (!trimmedNote) {\n\t\treturn;\n\t}\n\n\tconsole.log();\n\tconsole.log(chalk.bold(chalk.yellow(\"Update note\")));\n\ttry {\n\t\tconst width = Math.max(20, process.stdout.columns ?? 80);\n\t\tconst renderedLines = new Markdown(trimmedNote, 0, 0, SELF_UPDATE_NOTE_MARKDOWN_THEME)\n\t\t\t.render(width)\n\t\t\t.map((line) => line.trimEnd());\n\t\tconsole.log(renderedLines.join(\"\\n\"));\n\t} catch {\n\t\tconsole.log(trimmedNote);\n\t}\n\tconsole.log();\n}\n\ninterface SelfUpdatePlan {\n\tpackageName: string;\n\tinstallSpec: string;\n\tversion: string;\n\tshouldRun: boolean;\n\tnote?: string;\n}\n\nasync function getSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tlet latestRelease: Awaited<ReturnType<typeof getLatestRelease>>;\n\ttry {\n\t\tlatestRelease = await getLatestRelease(VERSION, { retry: true });\n\t} catch (error: unknown) {\n\t\tthrow new Error(\n\t\t\tt(\"Could not determine latest {app} version: {reason}\", {\n\t\t\t\tapp: APP_NAME,\n\t\t\t\treason: formatVersionCheckError(error),\n\t\t\t}),\n\t\t\t{\n\t\t\t\tcause: error,\n\t\t\t},\n\t\t);\n\t}\n\tif (!latestRelease) {\n\t\tthrow new Error(t(\"Could not determine latest {app} version.\", { app: APP_NAME }));\n\t}\n\n\t// The version service names the OFFICIAL published distribution\n\t// (@ai-agent-forge/agent-forge, D-075) — not the local workspace package\n\t// name, which differs in dev checkouts and would contradict the\n\t// version-check layer.\n\tif (latestRelease.packageName && latestRelease.packageName !== EXPECTED_PACKAGE_NAME) {\n\t\tthrow new Error(\n\t\t\tt(\"Version service returned an unexpected package name: {actual}. Expected {expected}.\", {\n\t\t\t\tactual: latestRelease.packageName,\n\t\t\t\texpected: EXPECTED_PACKAGE_NAME,\n\t\t\t}),\n\t\t);\n\t}\n\tconst packageName = PACKAGE_NAME;\n\tconst installSpec = `${packageName}@${latestRelease.version}`;\n\tif (force \|\| isNewerPackageVersion(latestRelease.version, VERSION)) {\n\t\treturn {\n\t\t\tpackageName,\n\t\t\tinstallSpec,\n\t\t\tversion: latestRelease.version,\n\t\t\t...(latestRelease.note ? { note: latestRelease.note } : {}),\n\t\t\tshouldRun: true,\n\t\t};\n\t}\n\n\tconsole.log(chalk.green(`${APP_NAME} is already up to date (v${VERSION})`));\n\treturn { packageName, installSpec, version: latestRelease.version, shouldRun: false };\n}\n\nasync function runSelfUpdate(command: SelfUpdateCommand): Promise<void> {\n\tconsole.log(chalk.dim(`Updating ${APP_NAME} with ${command.display}...`));\n\tfor (const step of command.steps ?? [command]) {\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst child = spawnProcess(step.command, step.args, {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t});\n\t\t\tchild.on(\"error\", (error) => {\n\t\t\t\treject(error);\n\t\t\t});\n\t\t\tchild.on(\"close\", (code, signal) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolve();\n\t\t\t\t} else if (signal) {\n\t\t\t\t\treject(new Error(`${step.display} terminated by signal ${signal}`));\n\t\t\t\t} else {\n\t\t\t\t\treject(new Error(`${step.display} exited with code ${code ?? \"unknown\"}`));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n}\n\nfunction prepareWindowsNpmSelfUpdate(): void {\n\t// v8 ignore next -- 非 Windows 平台分支，Windows 测试环境不可达\n\tif (process.platform !== \"win32\") {\n\t\treturn;\n\t}\n\n\tconst packageDir = getPackageDir();\n\tcleanupWindowsSelfUpdateQuarantine(packageDir);\n\tquarantineWindowsNativeDependencies(packageDir);\n}\n\ninterface CommandSettingsResult {\n\tsettingsManager: SettingsManager;\n}\n\n/*\n Optional host-owned dependencies for the config command.\n \n The package manager cannot construct a trustworthy registry or installer on\n * its own. Hosts that provide those dependencies may inject the bounded\n * manager controller; the default CLI leaves this undefined.\n /\nexport interface ConfigCommandOptions {\n\treadonly pluginManagerController?: PluginManagerControllerV1;\n\t/* Optional host-owned manager for project-scoped installations. */\n\treadonly projectPluginManagerController?: PluginManagerControllerV1;\n}\n\nfunction createCommandSettingsManager(options: { cwd: string; agentDir: string }): CommandSettingsResult {\n\treturn { settingsManager: SettingsManager.create(options.cwd, options.agentDir) };\n}\n\nexport async function handleConfigCommand(args: string[], options?: ConfigCommandOptions): Promise<boolean> {\n\tconst [command, ...rest] = args;\n\tif (command !== \"config\") {\n\t\treturn false;\n\t}\n\n\tif (rest.includes(\"-h\") \|\| rest.includes(\"--help\")) {\n\t\tprintConfigCommandHelp();\n\t\treturn true;\n\t}\n\n\tlet local = false;\n\tfor (const arg of rest) {\n\t\tif (arg === \"-l\" \|\| arg === \"--local\") {\n\t\t\tlocal = true;\n\t\t} else if (arg.startsWith(\"-\")) {\n\t\t\tconsole.error(chalk.red(`Unknown option ${arg} for \"config\".`));\n\t\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${CONFIG_COMMAND_USAGE}\".`));\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t\t} else {\n\t\t\tconsole.error(chalk.red(`Unexpected argument ${arg}.`));\n\t\t\tconsole.error(chalk.dim(`Usage: ${CONFIG_COMMAND_USAGE}`));\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t\t}\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst { settingsManager } = createCommandSettingsManager({\n\t\tcwd,\n\t\tagentDir,\n\t});\n\treportSettingsErrors(settingsManager, \"config command\");\n\tconst globalSettingsManager = SettingsManager.create(cwd, agentDir);\n\tconst globalResolvedPaths = await new DefaultPackageManager({\n\t\tcwd,\n\t\tagentDir,\n\t\tsettingsManager: globalSettingsManager,\n\t}).resolve();\n\tconst projectResolvedPaths = await new DefaultPackageManager({ cwd, agentDir, settingsManager }).resolve();\n\tconst injectedPluginManagerController = local\n\t\t? options?.projectPluginManagerController\n\t\t: options?.pluginManagerController;\n\t// The plugin manager defaults to the disk install store plus an optional\n\t// configured marketplace origin; host injection still wins entirely.\n\tconst defaultPluginManager =\n\t\tinjectedPluginManagerController === undefined\n\t\t\t? await createDefaultPluginManagerControllerV1({ agentDir, cwd, scope: local ? \"project\" : \"global\" })\n\t\t\t: undefined;\n\tconst pluginManagerController = injectedPluginManagerController ?? defaultPluginManager?.controller;\n\n\ttry {\n\t\tawait selectConfig({\n\t\t\tresolvedPaths: { global: globalResolvedPaths, project: projectResolvedPaths },\n\t\t\tsettingsManager,\n\t\t\tcwd,\n\t\t\tagentDir,\n\t\t\twriteScope: local ? \"project\" : \"global\",\n\t\t\tprojectModeAvailable: true,\n\t\t\tpluginSelectionController: createConfigPluginSelectionController(agentDir, cwd, local ? \"project\" : \"global\"),\n\t\t\t...(pluginManagerController === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\tpluginManagerController,\n\t\t\t\t\t\tpluginManagerScope: local ? \"project\" : \"global\",\n\t\t\t\t\t}),\n\t\t});\n\t} finally {\n\t\tawait defaultPluginManager?.close();\n\t}\n\n\tprocess.exit(0);\n}\n\nexport async function handlePackageCommand(args: string[]): Promise<boolean> {\n\tconst options = parsePackageCommand(args);\n\tif (!options) {\n\t\treturn false;\n\t}\n\n\tif (options.help) {\n\t\tprintPackageCommandHelp(options.command);\n\t\treturn true;\n\t}\n\n\tif (options.invalidOption) {\n\t\tconsole.error(chalk.red(`Unknown option ${options.invalidOption} for \"${options.command}\".`));\n\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${getPackageCommandUsage(options.command)}\".`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.missingOptionValue) {\n\t\tconsole.error(chalk.red(`Missing value for ${options.missingOptionValue}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.invalidArgument) {\n\t\tconsole.error(chalk.red(`Unexpected argument ${options.invalidArgument}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.conflictingOptions) {\n\t\tconsole.error(chalk.red(options.conflictingOptions));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst source = options.source;\n\tif ((options.command === \"install\" \|\| options.command === \"remove\") && !source) {\n\t\tconsole.error(chalk.red(`Missing ${options.command} source.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.command === \"update\" && options.updateTarget?.type === \"models\") {\n\t\ttry {\n\t\t\tawait refreshModelCatalogs(getAgentDir());\n\t\t} catch (error: unknown) {\n\t\t\tconst message = error instanceof Error ? error.message : \"Unknown model catalog refresh error\";\n\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\tprocess.exitCode = 1;\n\t\t}\n\t\treturn true;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst { settingsManager } = createCommandSettingsManager({\n\t\tcwd,\n\t\tagentDir,\n\t});\n\treportSettingsErrors(settingsManager, \"package command\");\n\tconst selfUpdateNpmCommand = settingsManager.getGlobalSettings().npmCommand;\n\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\n\tpackageManager.setProgressCallback((event) => {\n\t\tif (event.type === \"start\") {\n\t\t\tprocess.stdout.write(chalk.dim(`${event.message}\\n`));\n\t\t}\n\t});\n\n\ttry {\n\t\tswitch (options.command) {\n\t\t\tcase \"install\":\n\t\t\t\tawait packageManager.installAndPersist(source!, { local: options.local });\n\t\t\t\tconsole.log(chalk.green(`Installed ${source}`));\n\t\t\t\treturn true;\n\n\t\t\tcase \"remove\": {\n\t\t\t\tconst removed = await packageManager.removeAndPersist(source!, { local: options.local });\n\t\t\t\tif (!removed) {\n\t\t\t\t\tconsole.error(chalk.red(`No matching package found for ${source}`));\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\tconsole.log(chalk.green(`Removed ${source}`));\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"list\": {\n\t\t\t\tconst configuredPackages = packageManager.listConfiguredPackages();\n\t\t\t\tconst userPackages = configuredPackages.filter((pkg) => pkg.scope === \"user\");\n\t\t\t\tconst projectPackages = configuredPackages.filter((pkg) => pkg.scope === \"project\");\n\n\t\t\t\tif (configuredPackages.length === 0) {\n\t\t\t\t\tconsole.log(chalk.dim(\"No packages installed.\"));\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tconst formatPackage = (pkg: (typeof configuredPackages)[number]) => {\n\t\t\t\t\tconst display = pkg.filtered ? `${pkg.source} (filtered)` : pkg.source;\n\t\t\t\t\tconsole.log(` ${display}`);\n\t\t\t\t\tif (pkg.installedPath) {\n\t\t\t\t\t\tconsole.log(chalk.dim(` ${pkg.installedPath}`));\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tif (userPackages.length > 0) {\n\t\t\t\t\tconsole.log(chalk.bold(\"User packages:\"));\n\t\t\t\t\tfor (const pkg of userPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (projectPackages.length > 0) {\n\t\t\t\t\tif (userPackages.length > 0) console.log();\n\t\t\t\t\tconsole.log(chalk.bold(\"Project packages:\"));\n\t\t\t\t\tfor (const pkg of projectPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"update\": {\n\t\t\t\tconst target = options.updateTarget ?? { type: \"self\" };\n\t\t\t\tif (options.showPackagesSkippedNote) {\n\t\t\t\t\tconsole.log(chalk.dim(`Packages are skipped. Run ${APP_NAME} update --packages to update packages.`));\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesPackages(target)) {\n\t\t\t\t\tconst updateSource = target.type === \"packages\" ? target.source : undefined;\n\t\t\t\t\tawait packageManager.update(updateSource);\n\t\t\t\t\tif (updateSource) {\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${updateSource}`));\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconsole.log(chalk.green(\"Updated packages\"));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesSelf(target)) {\n\t\t\t\t\tconst managedInstallRoot = getActiveManagedInstallRoot();\n\t\t\t\t\tif (managedInstallRoot && options.force) {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\tchalk.red(\n\t\t\t\t\t\t\t\t`Managed ${APP_NAME} installations do not support --force; rerun the installer to repair this installation.`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdatePlan = await getSelfUpdatePlan(options.force);\n\t\t\t\t\tif (!selfUpdatePlan.shouldRun) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tif (managedInstallRoot) {\n\t\t\t\t\t\tif (selfUpdatePlan.note) {\n\t\t\t\t\t\t\tprintSelfUpdateNote(selfUpdatePlan.note);\n\t\t\t\t\t\t}\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconsole.log(chalk.dim(`Updating managed ${APP_NAME} installation...`));\n\t\t\t\t\t\t\tawait runManagedSelfUpdate(managedInstallRoot, selfUpdatePlan.version);\n\t\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown managed update error\";\n\t\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME} from ${VERSION} to ${selfUpdatePlan.version}`));\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst installMethod = detectInstallMethod();\n\t\t\t\t\tif (process.platform === \"win32\" && installMethod !== \"npm\" && installMethod !== \"pnpm\") {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\tchalk.red(`${APP_NAME} self-update on Windows is only supported for npm and pnpm installs.`),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconsole.error(chalk.dim(`Detected install method: ${installMethod}. Update ${APP_NAME} manually.`));\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdateTarget = {\n\t\t\t\t\t\tpackageName: selfUpdatePlan.packageName,\n\t\t\t\t\t\tinstallSpec: selfUpdatePlan.installSpec,\n\t\t\t\t\t};\n\t\t\t\t\tconst selfUpdateCommand = getSelfUpdateCommand(PACKAGE_NAME, selfUpdateNpmCommand, selfUpdateTarget);\n\t\t\t\t\tif (!selfUpdateCommand) {\n\t\t\t\t\t\tprintSelfUpdateUnavailable(selfUpdateNpmCommand, selfUpdateTarget);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tif (selfUpdatePlan.note) {\n\t\t\t\t\t\tprintSelfUpdateNote(selfUpdatePlan.note);\n\t\t\t\t\t}\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (installMethod === \"npm\") {\n\t\t\t\t\t\t\tprepareWindowsNpmSelfUpdate();\n\t\t\t\t\t\t}\n\t\t\t\t\t\tawait runSelfUpdate(selfUpdateCommand);\n\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\tif (installMethod === \"pnpm\") {\n\t\t\t\t\t\t\tprintPnpmSelfUpdateMetadataHint();\n\t\t\t\t\t\t}\n\t\t\t\t\t\tprintSelfUpdateFallback(selfUpdateCommand);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME} from ${VERSION} to ${selfUpdatePlan.version}`));\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n}\n"]}

package/dist/package-manager-cli.js CHANGED Viewed

@@ -7,6 +7,7 @@ import { selectConfig } from "./cli/config-selector.js";
 import { createDefaultPluginManagerControllerV1 } from "./cli/plugin-command.js";
 import { createPluginSelectionControllerV1 } from "./cli/plugin-selection-controller.js";
 import { APP_NAME, CONFIG_DIR_NAME, detectInstallMethod, getAgentDir, getPackageDir, getSelfUpdateCommand, getSelfUpdateUnavailableInstruction, PACKAGE_NAME, VERSION, } from "./config.js";
+import { t } from "./core/i18n/index.js";
 import { ModelRuntime } from "./core/model-runtime.js";
 import { DefaultPackageManager } from "./core/package-manager.js";
 import { SettingsManager } from "./core/settings-manager.js";
@@ -39,14 +40,18 @@ function getActiveManagedInstallRoot() {
         }
     }
     catch {
-        throw new Error(`Managed install marker is missing or invalid: ${markerPath}`);
+        throw new Error(t("Managed install marker is missing or invalid: {path}", { path: markerPath }));
     }
     return managedRoot;
 }
 async function fetchInstallerArtifact(url, label) {
     const response = await fetch(url, { headers: { "User-Agent": getAgentForgeUserAgent(VERSION) } });
     if (!response.ok) {
-        throw new Error(`Could not download managed installer ${label} from ${url}: HTTP ${response.status}`);
+        throw new Error(t("Could not download managed installer {label} from {url}: HTTP {status}", {
+            label,
+            url,
+            status: response.status,
+        }));
     }
     return await response.text();
 }
@@ -64,7 +69,7 @@ async function runManagedNpmCi(stageDir) {
     ];
     const code = await waitForChildProcess(spawnProcess("npm", args, { cwd: stageDir, stdio: "inherit" }));
     if (code !== 0)
-        throw new Error(`npm ${args.join(" ")} exited with code ${code ?? "unknown"}`);
+        throw new Error(t("npm {args} exited with code {code}", { args: args.join(" "), code: code ?? "unknown" }));
 }
 function verifyManagedRelease(releaseDir, expectedVersion) {
     const binPath = join(releaseDir, "node_modules", ".bin", process.platform === "win32" ? `${APP_NAME}.cmd` : APP_NAME);
@@ -74,11 +79,15 @@ function verifyManagedRelease(releaseDir, expectedVersion) {
     });
     if (result.error || result.status !== 0) {
         const reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? "unknown"}`;
-        throw new Error(`Could not verify managed ${APP_NAME} ${expectedVersion}: ${reason}`);
+        throw new Error(t("Could not verify managed {app} {version}: {reason}", { app: APP_NAME, version: expectedVersion, reason }));
     }
     const installedVersion = result.stdout.trim();
     if (installedVersion !== expectedVersion) {
-        throw new Error(`Managed ${APP_NAME} smoke test returned version ${installedVersion}; expected ${expectedVersion}.`);
+        throw new Error(t("Managed {app} smoke test returned version {installed}; expected {expected}.", {
+            app: APP_NAME,
+            installed: installedVersion,
+            expected: expectedVersion,
+        }));
     }
 }
 // Windows AV/indexer can hold freshly written staging files for many seconds
@@ -146,7 +155,7 @@ export function cleanupManagedInstall() {
 }
 async function runManagedSelfUpdate(managedRoot, version) {
     if (!MANAGED_RELEASE_VERSION_RE.test(version)) {
-        throw new Error(`Invalid managed release version: ${version}`);
+        throw new Error(t("Invalid managed release version: {version}", { version }));
     }
     let releaseLock;
     try {
@@ -154,7 +163,7 @@ async function runManagedSelfUpdate(managedRoot, version) {
     }
     catch (error) {
         if (error instanceof Error && "code" in error && error.code === "ELOCKED") {
-            throw new Error(`Another managed ${APP_NAME} update is already running.`);
+            throw new Error(t("Another managed {app} update is already running.", { app: APP_NAME }));
         }
         throw error;
     }
@@ -163,7 +172,7 @@ async function runManagedSelfUpdate(managedRoot, version) {
         cleanupManagedStaging(managedRoot);
         const installerApiBase = process.env.AGENT_FORGE_INSTALLER_API_BASE?.trim().replace(/\/+$/, "");
         if (!installerApiBase) {
-            throw new Error("Managed self-update requires AGENT_FORGE_INSTALLER_API_BASE to be configured.");
+            throw new Error(t("Managed self-update requires AGENT_FORGE_INSTALLER_API_BASE to be configured."));
         }
         const releaseUrl = `${installerApiBase}/${encodeURIComponent(version)}`;
         const stagingRoot = join(managedRoot, "staging");
@@ -548,11 +557,11 @@ async function refreshModelCatalogs(agentDir) {
             signal: controller.signal,
         });
         if (result.aborted) {
-            throw new Error("Model catalog refresh timed out.");
+            throw new Error(t("Model catalog refresh timed out."));
         }
         if (result.errors.size > 0) {
             const details = Array.from(result.errors, ([provider, error]) => `${provider}: ${error.message}`).join("; ");
-            throw new Error(`Could not refresh model catalogs: ${details}`);
+            throw new Error(t("Could not refresh model catalogs: {details}", { details }));
         }
     }
     finally {
@@ -601,19 +610,25 @@ async function getSelfUpdatePlan(force) {
         latestRelease = await getLatestRelease(VERSION, { retry: true });
     }
     catch (error) {
-        throw new Error(`Could not determine latest ${APP_NAME} version: ${formatVersionCheckError(error)}`, {
+        throw new Error(t("Could not determine latest {app} version: {reason}", {
+            app: APP_NAME,
+            reason: formatVersionCheckError(error),
+        }), {
             cause: error,
         });
     }
     if (!latestRelease) {
-        throw new Error(`Could not determine latest ${APP_NAME} version.`);
+        throw new Error(t("Could not determine latest {app} version.", { app: APP_NAME }));
     }
     // The version service names the OFFICIAL published distribution
     // (@ai-agent-forge/agent-forge, D-075) — not the local workspace package
     // name, which differs in dev checkouts and would contradict the
     // version-check layer.
     if (latestRelease.packageName && latestRelease.packageName !== EXPECTED_PACKAGE_NAME) {
-        throw new Error(`Version service returned an unexpected package name: ${latestRelease.packageName}. Expected ${EXPECTED_PACKAGE_NAME}.`);
+        throw new Error(t("Version service returned an unexpected package name: {actual}. Expected {expected}.", {
+            actual: latestRelease.packageName,
+            expected: EXPECTED_PACKAGE_NAME,
+        }));
     }
     const packageName = PACKAGE_NAME;
     const installSpec = `${packageName}@${latestRelease.version}`;