@perplexity-cli/perplexity-cli 0.1.0 → 0.1.3

package/dist/src/nonInteractive/control/controllers/systemController.js

@@ -0,0 +1,311 @@
+/**
+ * @license
+ * Copyright 2025 Perplexity Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * System Controller
+ *
+ * Handles system-level control requests:
+ * - initialize: Setup session and return system info
+ * - interrupt: Cancel current operations
+ * - set_model: Switch model (placeholder)
+ */
+import { BaseController } from './baseController.js';
+import { CommandService } from '../../../services/CommandService.js';
+import { BuiltinCommandLoader } from '../../../services/BuiltinCommandLoader.js';
+import { MCPServerConfig, AuthProviderType, } from '@perplexity-cli/perplexity-cli-core';
+export class SystemController extends BaseController {
+    /**
+     * Handle system control requests
+     */
+    async handleRequestPayload(payload, signal) {
+        if (signal.aborted) {
+            throw new Error('Request aborted');
+        }
+        switch (payload.subtype) {
+            case 'initialize':
+                return this.handleInitialize(payload, signal);
+            case 'interrupt':
+                return this.handleInterrupt();
+            case 'set_model':
+                return this.handleSetModel(payload, signal);
+            case 'supported_commands':
+                return this.handleSupportedCommands(signal);
+            default:
+                throw new Error(`Unsupported request subtype in SystemController`);
+        }
+    }
+    /**
+     * Handle initialize request
+     *
+     * Processes SDK MCP servers config.
+     * SDK servers are registered in context.sdkMcpServers
+     * and added to config.mcpServers with the sdk type flag.
+     * External MCP servers are configured separately in settings.
+     */
+    async handleInitialize(payload, signal) {
+        if (signal.aborted) {
+            throw new Error('Request aborted');
+        }
+        this.context.config.setSdkMode(true);
+        // Process SDK MCP servers
+        if (payload.sdkMcpServers &&
+            typeof payload.sdkMcpServers === 'object' &&
+            payload.sdkMcpServers !== null) {
+            const sdkServers = {};
+            for (const [key, wireConfig] of Object.entries(payload.sdkMcpServers)) {
+                const name = typeof wireConfig?.name === 'string' && wireConfig.name.trim().length
+                    ? wireConfig.name
+                    : key;
+                this.context.sdkMcpServers.add(name);
+                sdkServers[name] = new MCPServerConfig(undefined, // command
+                undefined, // args
+                undefined, // env
+                undefined, // cwd
+                undefined, // url
+                undefined, // httpUrl
+                undefined, // headers
+                undefined, // tcp
+                undefined, // timeout
+                true, // trust - SDK servers are trusted
+                undefined, // description
+                undefined, // includeTools
+                undefined, // excludeTools
+                undefined, // extensionName
+                undefined, // oauth
+                undefined, // authProviderType
+                undefined, // targetAudience
+                undefined, // targetServiceAccount
+                'sdk');
+            }
+            const sdkServerCount = Object.keys(sdkServers).length;
+            if (sdkServerCount > 0) {
+                try {
+                    this.context.config.addMcpServers(sdkServers);
+                    if (this.context.debugMode) {
+                        console.error(`[SystemController] Added ${sdkServerCount} SDK MCP servers to config`);
+                    }
+                }
+                catch (error) {
+                    if (this.context.debugMode) {
+                        console.error('[SystemController] Failed to add SDK MCP servers:', error);
+                    }
+                }
+            }
+        }
+        if (payload.mcpServers &&
+            typeof payload.mcpServers === 'object' &&
+            payload.mcpServers !== null) {
+            const externalServers = {};
+            for (const [name, serverConfig] of Object.entries(payload.mcpServers)) {
+                const normalized = this.normalizeMcpServerConfig(name, serverConfig);
+                if (normalized) {
+                    externalServers[name] = normalized;
+                }
+            }
+            const externalCount = Object.keys(externalServers).length;
+            if (externalCount > 0) {
+                try {
+                    this.context.config.addMcpServers(externalServers);
+                    if (this.context.debugMode) {
+                        console.error(`[SystemController] Added ${externalCount} external MCP servers to config`);
+                    }
+                }
+                catch (error) {
+                    if (this.context.debugMode) {
+                        console.error('[SystemController] Failed to add external MCP servers:', error);
+                    }
+                }
+            }
+        }
+        if (payload.agents && Array.isArray(payload.agents)) {
+            try {
+                this.context.config.setSessionSubagents(payload.agents);
+                if (this.context.debugMode) {
+                    console.error(`[SystemController] Added ${payload.agents.length} session subagents to config`);
+                }
+            }
+            catch (error) {
+                if (this.context.debugMode) {
+                    console.error('[SystemController] Failed to add session subagents:', error);
+                }
+            }
+        }
+        // Build capabilities for response
+        const capabilities = this.buildControlCapabilities();
+        if (this.context.debugMode) {
+            console.error(`[SystemController] Initialized with ${this.context.sdkMcpServers.size} SDK MCP servers`);
+        }
+        return {
+            subtype: 'initialize',
+            capabilities,
+        };
+    }
+    /**
+     * Build control capabilities for initialize control response
+     *
+     * This method constructs the control capabilities object that indicates
+     * what control features are available. It is used exclusively in the
+     * initialize control response.
+     */
+    buildControlCapabilities() {
+        const capabilities = {
+            can_handle_can_use_tool: true,
+            can_handle_hook_callback: false,
+            can_set_permission_mode: typeof this.context.config.setApprovalMode === 'function',
+            can_set_model: typeof this.context.config.setModel === 'function',
+            // SDK MCP servers are supported - messages routed through control plane
+            can_handle_mcp_message: true,
+        };
+        return capabilities;
+    }
+    normalizeMcpServerConfig(serverName, config) {
+        if (!config || typeof config !== 'object') {
+            if (this.context.debugMode) {
+                console.error(`[SystemController] Ignoring invalid MCP server config for '${serverName}'`);
+            }
+            return null;
+        }
+        const authProvider = this.normalizeAuthProviderType(config.authProviderType);
+        const oauthConfig = this.normalizeOAuthConfig(config.oauth);
+        return new MCPServerConfig(config.command, config.args, config.env, config.cwd, config.url, config.httpUrl, config.headers, config.tcp, config.timeout, config.trust, config.description, config.includeTools, config.excludeTools, config.extensionName, oauthConfig, authProvider, config.targetAudience, config.targetServiceAccount);
+    }
+    normalizeAuthProviderType(value) {
+        if (!value) {
+            return undefined;
+        }
+        switch (value) {
+            case AuthProviderType.DYNAMIC_DISCOVERY:
+            case AuthProviderType.GOOGLE_CREDENTIALS:
+            case AuthProviderType.SERVICE_ACCOUNT_IMPERSONATION:
+                return value;
+            default:
+                if (this.context.debugMode) {
+                    console.error(`[SystemController] Unsupported authProviderType '${value}', skipping`);
+                }
+                return undefined;
+        }
+    }
+    normalizeOAuthConfig(oauth) {
+        if (!oauth) {
+            return undefined;
+        }
+        return {
+            enabled: oauth.enabled,
+            clientId: oauth.clientId,
+            clientSecret: oauth.clientSecret,
+            authorizationUrl: oauth.authorizationUrl,
+            tokenUrl: oauth.tokenUrl,
+            scopes: oauth.scopes,
+            audiences: oauth.audiences,
+            redirectUri: oauth.redirectUri,
+            tokenParamName: oauth.tokenParamName,
+            registrationUrl: oauth.registrationUrl,
+        };
+    }
+    /**
+     * Handle interrupt request
+     *
+     * Triggers the interrupt callback to cancel current operations
+     */
+    async handleInterrupt() {
+        // Trigger interrupt callback if available
+        if (this.context.onInterrupt) {
+            this.context.onInterrupt();
+        }
+        // Abort the main signal to cancel ongoing operations
+        if (this.context.abortSignal && !this.context.abortSignal.aborted) {
+            // Note: We can't directly abort the signal, but the onInterrupt callback should handle this
+            if (this.context.debugMode) {
+                console.error('[SystemController] Interrupt signal triggered');
+            }
+        }
+        if (this.context.debugMode) {
+            console.error('[SystemController] Interrupt handled');
+        }
+        return { subtype: 'interrupt' };
+    }
+    /**
+     * Handle set_model request
+     *
+     * Implements actual model switching with validation and error handling
+     */
+    async handleSetModel(payload, signal) {
+        if (signal.aborted) {
+            throw new Error('Request aborted');
+        }
+        const model = payload.model;
+        // Validate model parameter
+        if (typeof model !== 'string' || model.trim() === '') {
+            throw new Error('Invalid model specified for set_model request');
+        }
+        try {
+            // Attempt to set the model using config
+            await this.context.config.setModel(model);
+            if (this.context.debugMode) {
+                console.error(`[SystemController] Model switched to: ${model}`);
+            }
+            return {
+                subtype: 'set_model',
+                model,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Failed to set model';
+            if (this.context.debugMode) {
+                console.error(`[SystemController] Failed to set model ${model}:`, error);
+            }
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * Handle supported_commands request
+     *
+     * Returns list of supported slash commands loaded dynamically
+     */
+    async handleSupportedCommands(signal) {
+        if (signal.aborted) {
+            throw new Error('Request aborted');
+        }
+        const slashCommands = await this.loadSlashCommandNames(signal);
+        return {
+            subtype: 'supported_commands',
+            commands: slashCommands,
+        };
+    }
+    /**
+     * Load slash command names using CommandService
+     *
+     * @param signal - AbortSignal to respect for cancellation
+     * @returns Promise resolving to array of slash command names
+     */
+    async loadSlashCommandNames(signal) {
+        if (signal.aborted) {
+            return [];
+        }
+        try {
+            const service = await CommandService.create([new BuiltinCommandLoader(this.context.config)], signal);
+            if (signal.aborted) {
+                return [];
+            }
+            const names = new Set();
+            const commands = service.getCommands();
+            for (const command of commands) {
+                names.add(command.name);
+            }
+            return Array.from(names).sort();
+        }
+        catch (error) {
+            // Check if the error is due to abort
+            if (signal.aborted) {
+                return [];
+            }
+            if (this.context.debugMode) {
+                console.error('[SystemController] Failed to load slash commands:', error);
+            }
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=systemController.js.map

package/dist/src/nonInteractive/control/controllers/systemController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemController.js","sourceRoot":"","sources":["../../../../../src/nonInteractive/control/controllers/systemController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,eAAe,EACf,gBAAgB,GAEjB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD;;OAEG;IACO,KAAK,CAAC,oBAAoB,CAClC,OAA8B,EAC9B,MAAmB;QAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,gBAAgB,CAC1B,OAAsC,EACtC,MAAM,CACP,CAAC;YAEJ,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;YAEhC,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,cAAc,CACxB,OAAoC,EACpC,MAAM,CACP,CAAC;YAEJ,KAAK,oBAAoB;gBACvB,OAAO,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAE9C;gBACE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,gBAAgB,CAC5B,OAAoC,EACpC,MAAmB;QAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAErC,0BAA0B;QAC1B,IACE,OAAO,CAAC,aAAa;YACrB,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ;YACzC,OAAO,CAAC,aAAa,KAAK,IAAI,EAC9B,CAAC;YACD,MAAM,UAAU,GAAoC,EAAE,CAAC;YACvD,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,GACR,OAAO,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM;oBACnE,CAAC,CAAC,UAAU,CAAC,IAAI;oBACjB,CAAC,CAAC,GAAG,CAAC;gBAEV,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,eAAe,CACpC,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,OAAO;gBAClB,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,UAAU;gBACrB,IAAI,EAAE,kCAAkC;gBACxC,SAAS,EAAE,cAAc;gBACzB,SAAS,EAAE,eAAe;gBAC1B,SAAS,EAAE,eAAe;gBAC1B,SAAS,EAAE,gBAAgB;gBAC3B,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,mBAAmB;gBAC9B,SAAS,EAAE,iBAAiB;gBAC5B,SAAS,EAAE,uBAAuB;gBAClC,KAAK,CACN,CAAC;YACJ,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;YACtD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;oBAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;wBAC3B,OAAO,CAAC,KAAK,CACX,4BAA4B,cAAc,4BAA4B,CACvE,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;wBAC3B,OAAO,CAAC,KAAK,CACX,mDAAmD,EACnD,KAAK,CACN,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IACE,OAAO,CAAC,UAAU;YAClB,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YACtC,OAAO,CAAC,UAAU,KAAK,IAAI,EAC3B,CAAC;YACD,MAAM,eAAe,GAAoC,EAAE,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtE,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAC9C,IAAI,EACJ,YAA8C,CAC/C,CAAC;gBACF,IAAI,UAAU,EAAE,CAAC;oBACf,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;YAC1D,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;oBACnD,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;wBAC3B,OAAO,CAAC,KAAK,CACX,4BAA4B,aAAa,iCAAiC,CAC3E,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;wBAC3B,OAAO,CAAC,KAAK,CACX,wDAAwD,EACxD,KAAK,CACN,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAExD,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBAC3B,OAAO,CAAC,KAAK,CACX,4BAA4B,OAAO,CAAC,MAAM,CAAC,MAAM,8BAA8B,CAChF,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBAC3B,OAAO,CAAC,KAAK,CACX,qDAAqD,EACrD,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAErD,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CACX,uCAAuC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,kBAAkB,CACzF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,YAAY;SACb,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,wBAAwB;QACtB,MAAM,YAAY,GAA4B;YAC5C,uBAAuB,EAAE,IAAI;YAC7B,wBAAwB,EAAE,KAAK;YAC/B,uBAAuB,EACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,KAAK,UAAU;YAC3D,aAAa,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU;YACjE,wEAAwE;YACxE,sBAAsB,EAAE,IAAI;SAC7B,CAAC;QAEF,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,wBAAwB,CAC9B,UAAkB,EAClB,MAA2B;QAE3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,8DAA8D,UAAU,GAAG,CAC5E,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,yBAAyB,CACjD,MAAM,CAAC,gBAAgB,CACxB,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5D,OAAO,IAAI,eAAe,CACxB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,aAAa,EACpB,WAAW,EACX,YAAY,EACZ,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,oBAAoB,CAC5B,CAAC;IACJ,CAAC;IAEO,yBAAyB,CAC/B,KAAc;QAEd,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,gBAAgB,CAAC,iBAAiB,CAAC;YACxC,KAAK,gBAAgB,CAAC,kBAAkB,CAAC;YACzC,KAAK,gBAAgB,CAAC,6BAA6B;gBACjD,OAAO,KAAK,CAAC;YACf;gBACE,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBAC3B,OAAO,CAAC,KAAK,CACX,oDAAoD,KAAK,aAAa,CACvE,CAAC;gBACJ,CAAC;gBACD,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,oBAAoB,CAC1B,KAAmC;QAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,eAAe;QAC3B,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QAED,qDAAqD;QACrD,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAClE,4FAA4F;YAC5F,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAC1B,OAAkC,EAClC,MAAmB;QAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,2BAA2B;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC;YACH,wCAAwC;YACxC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,WAAW;gBACpB,KAAK;aACN,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC;YAEjE,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,0CAA0C,KAAK,GAAG,EAClD,KAAK,CACN,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,uBAAuB,CACnC,MAAmB;QAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE/D,OAAO;YACL,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,aAAa;SACxB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,qBAAqB,CAAC,MAAmB;QACrD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CACzC,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC/C,MAAM,CACP,CAAC;YAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qCAAqC;YACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,mDAAmD,EACnD,KAAK,CACN,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/src/nonInteractive/control/types/serviceAPIs.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2025 Perplexity Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Service API Types
+ *
+ * These interfaces define the public API contract for the ControlService facade.
+ * They provide type-safe, domain-grouped access to control plane functionality
+ * for internal CLI code (nonInteractiveCli, session managers, etc.).
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { MCPServerConfig } from '@perplexity-cli/perplexity-cli-core';
+import type { PermissionSuggestion } from '../../types.js';
+/**
+ * Permission Service API
+ *
+ * Provides permission-related operations including tool execution approval,
+ * permission suggestions, and tool call monitoring callbacks.
+ */
+export interface PermissionServiceAPI {
+    /**
+     * Build UI suggestions for tool confirmation dialogs
+     *
+     * Creates actionable permission suggestions based on tool confirmation details,
+     * helping host applications present appropriate approval/denial options.
+     *
+     * @param confirmationDetails - Tool confirmation details (type, title, metadata)
+     * @returns Array of permission suggestions or null if details are invalid
+     */
+    buildPermissionSuggestions(confirmationDetails: unknown): PermissionSuggestion[] | null;
+    /**
+     * Get callback for monitoring tool call status updates
+     *
+     * Returns a callback function that should be passed to executeToolCall
+     * to enable integration with CoreToolScheduler updates. This callback
+     * handles outgoing permission requests for tools awaiting approval.
+     *
+     * @returns Callback function that processes tool call updates
+     */
+    getToolCallUpdateCallback(): (toolCalls: unknown[]) => void;
+}
+/**
+ * System Service API
+ *
+ * Provides system-level operations for the control system.
+ *
+ * Note: System messages and slash commands are NOT part of the control system API.
+ * They are handled independently via buildSystemMessage() from nonInteractiveHelpers.ts,
+ * regardless of whether the control system is available.
+ */
+export interface SystemServiceAPI {
+    /**
+     * Get control capabilities
+     *
+     * Returns the control capabilities object indicating what control
+     * features are available. Used exclusively for the initialize control
+     * response. System messages do not include capabilities as they are
+     * independent of the control system.
+     *
+     * @returns Control capabilities object
+     */
+    getControlCapabilities(): Record<string, unknown>;
+}
+/**
+ * MCP Service API
+ *
+ * Provides Model Context Protocol server interaction including
+ * lazy client initialization and server discovery.
+ */
+export interface McpServiceAPI {
+    /**
+     * Get or create MCP client for a server (lazy initialization)
+     *
+     * Returns an existing client from cache or creates a new connection
+     * if this is the first request for the server. Handles connection
+     * lifecycle and error recovery.
+     *
+     * @param serverName - Name of the MCP server to connect to
+     * @returns Promise resolving to client instance and server configuration
+     * @throws Error if server is not configured or connection fails
+     */
+    getMcpClient(serverName: string): Promise<{
+        client: Client;
+        config: MCPServerConfig;
+    }>;
+    /**
+     * List all available MCP servers
+     *
+     * Returns names of both SDK-managed and CLI-managed MCP servers
+     * that are currently configured or connected.
+     *
+     * @returns Array of server names
+     */
+    listServers(): string[];
+}
+/**
+ * Hook Service API
+ *
+ * Provides hook callback processing (placeholder for future expansion).
+ */
+export interface HookServiceAPI {
+    registerHookCallback(callback: unknown): void;
+}

package/dist/src/nonInteractive/control/types/serviceAPIs.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Perplexity Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=serviceAPIs.js.map

package/dist/src/nonInteractive/control/types/serviceAPIs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceAPIs.js","sourceRoot":"","sources":["../../../../../src/nonInteractive/control/types/serviceAPIs.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}