Fix race condition in terminal event handling by filtering func host events

extension.bundle.ts

@@ -33,13 +33,15 @@ export * from './src/utils/durableUtils';
 export { activateInternal, deactivateInternal } from './src/extension';
 export * from './src/extensionVariables';
 export * from './src/funcConfig/function';
+export { extractFuncHostErrorContextForErrorMessage, isFuncHostErrorLog } from './src/funcCoreTools/funcHostErrorUtils';
 export * from './src/funcCoreTools/hasMinFuncCliVersion';
 export * from './src/FuncVersion';
 export * from './src/templates/CentralTemplateProvider';
 export * from './src/templates/IFunctionTemplate';
 export * from './src/templates/script/getScriptResourcesLanguage';
 export * from './src/templates/TemplateProviderBase';
 export * from './src/tree/AzureAccountTreeItemWithProjects';
+export { stripAnsiControlCharacters } from './src/utils/ansiUtils';
 export * from './src/utils/cpUtils';
 export * from './src/utils/delay';
 export * from './src/utils/envUtils';

package.json

@@ -90,6 +90,16 @@
                 ]
             }
         },
+        "views": {
+            "debug": [
+                {
+                    "id": "azureFunctions.funcHostDebugView",
+                    "name": "%azureFunctions.funcHostDebugView.title%",
+                    "when": "!virtualWorkspace && azureFunctions.funcHostDebugVisible",
+                    "icon": "resources/azure-functions.svg"
+                }
+            ]
+        },
         "commands": [
             {
                 "command": "azureFunctions.addBinding",
@@ -467,6 +477,36 @@
                 "command": "azureFunctions.getMcpHostKey",
                 "title": "%azureFunctions.getMcpHostKey%",
                 "category": "Azure Functions"
+            },
+            {
+                "command": "azureFunctions.funcHostDebug.refresh",
+                "title": "%azureFunctions.funcHostDebug.refresh%",
+                "category": "Azure Functions",
+                "icon": "$(refresh)"
+            },
+            {
+                "command": "azureFunctions.funcHostDebug.clearErrors",
+                "title": "%azureFunctions.funcHostDebug.clearErrors%",
+                "category": "Azure Functions",
+                "icon": "$(clear-all)"
+            },
+            {
+                "command": "azureFunctions.funcHostDebug.showRecentLogs",
+                "title": "%azureFunctions.funcHostDebug.showRecentLogs%",
+                "category": "Azure Functions",
+                "icon": "$(output)"
+            },
+            {
+                "command": "azureFunctions.funcHostDebug.copyRecentLogs",
+                "title": "%azureFunctions.funcHostDebug.copyRecentLogs%",
+                "category": "Azure Functions",
+                "icon": "$(copy)"
+            },
+            {
+                "command": "azureFunctions.funcHostDebug.askCopilot",
+                "title": "%azureFunctions.funcHostDebug.askCopilot%",
+                "category": "Azure Functions",
+                "icon": "$(sparkle)"
             }
         ],
         "submenus": [
@@ -503,9 +543,34 @@
                     "submenu": "azureFunctions.submenus.workspaceActions",
                     "when": "view == azureWorkspace",
                     "group": "navigation@1"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.refresh",
+                    "when": "view == azureFunctions.funcHostDebugView",
+                    "group": "navigation@1"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.clearErrors",
+                    "when": "view == azureFunctions.funcHostDebugView",
+                    "group": "navigation@1"
                 }
             ],
             "view/item/context": [
+                {
+                    "command": "azureFunctions.funcHostDebug.showRecentLogs",
+                    "when": "view == azureFunctions.funcHostDebugView && viewItem == azFunc.funcHostDebug.hostTask",
+                    "group": "inline"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.copyRecentLogs",
+                    "when": "view == azureFunctions.funcHostDebugView && viewItem == azFunc.funcHostDebug.hostTask",
+                    "group": "inline"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.askCopilot",
+                    "when": "view == azureFunctions.funcHostDebugView && viewItem == azFunc.funcHostDebug.hostError",
+                    "group": "1@1"
+                },
                 {
                     "command": "azureFunctions.createFunction",
                     "when": "view == azureWorkspace && viewItem =~ /azFuncLocalProject/i",
@@ -947,6 +1012,22 @@
                 {
                     "command": "azureFunctions.unassignManagedIdentity",
                     "when": "never"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.refresh",
+                    "when": "never"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.showRecentLogs",
+                    "when": "never"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.copyRecentLogs",
+                    "when": "never"
+                },
+                {
+                    "command": "azureFunctions.funcHostDebug.askCopilot",
+                    "when": "never"
                 }
             ],
             "editor/context": [
@@ -990,6 +1071,12 @@
                 "properties": {
                     "command": {
                         "type": "string"
+                    },
+                    "args": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
                     }
                 }
             }
@@ -1186,6 +1273,11 @@
                         "description": "%azureFunctions.enableJavaRemoteDebugging%",
                         "default": false
                     },
+                    "azureFunctions.alwaysShowFuncHostDebugView": {
+                        "type": "boolean",
+                        "description": "%azureFunctions.alwaysShowFuncHostDebugView%",
+                        "default": false
+                    },
                     "azureFunctions.showProjectWarning": {
                         "type": "boolean",
                         "description": "%azureFunctions.showProjectWarning%",

package.nls.json

@@ -39,6 +39,7 @@
     "azureFunctions.disconnectRepo": "Disconnect from Repo...",
     "azureFunctions.enableFunction": "Enable Function",
     "azureFunctions.enableJavaRemoteDebugging": "Enable remote debugging for Java Functions Apps running on Windows. (experimental)",
+    "azureFunctions.alwaysShowFuncHostDebugView": "Always show the Function Host Debug view in Run and Debug, even when no host task is running.",
     "azureFunctions.enableOutputTimestamps": "Prepends each line displayed in the output channel with a timestamp.",
     "azureFunctions.enableRemoteDebugging": "Enable remote debugging for Node.js Function Apps running on Linux App Service plans. Consumption plans are not supported. (experimental)",
     "azureFunctions.enableSystemIdentity": "Enable System Assigned Identity",
@@ -144,5 +145,11 @@
     "azureFunctions.mcpProjectType": "The type of MCP integration the project uses.",
     "azureFunctions.mcpProjectType.NoMcpServer": "Runs the standard Azure Functions runtime with no MCP integration.",
     "azureFunctions.mcpProjectType.McpExtensionServer": "Runs the Functions host with an embedded MCP server provided by the Azure Functions MCP extension.",
-    "azureFunctions.mcpProjectType.SelfHostedMcpServer": "Runs the Functions host in custom-handler mode, forwarding requests to a self-hosted MCP server process."
+    "azureFunctions.mcpProjectType.SelfHostedMcpServer": "Runs the Functions host in custom-handler mode, forwarding requests to a self-hosted MCP server process.",
+    "azureFunctions.funcHostDebugView.title": "Function Host Debug",
+    "azureFunctions.funcHostDebug.refresh": "Refresh",
+    "azureFunctions.funcHostDebug.clearErrors": "Clear Function Host Errors",
+    "azureFunctions.funcHostDebug.showRecentLogs": "Show Recent Host Logs",
+    "azureFunctions.funcHostDebug.copyRecentLogs": "Copy Recent Host Logs",
+    "azureFunctions.funcHostDebug.askCopilot": "Ask Copilot"
 }

src/commands/CommandAttributes.ts

@@ -30,5 +30,4 @@ export class CommandAttributes {
             "Task hub creation fails — if an existing parent DTS resource was selected, check that the scheduler is not stuck in a provisioning state.",
         ],
     };
-
 }

src/commands/pickFuncProcess.ts

@@ -21,15 +21,44 @@ import { getWorkspaceSetting } from '../vsCodeConfig/settings';
 const funcTaskReadyEmitter = new vscode.EventEmitter<vscode.WorkspaceFolder>();
 export const onDotnetFuncTaskReady = funcTaskReadyEmitter.event;
 
+/**
+ * Result returned from starting a function host process via the API.
+ */
+export interface IStartFuncProcessResult {
+    /**
+     * The process ID of the started function host.
+     */
+    processId: string;
+    /**
+     * Whether the function host was successfully started.
+     */
+    success: boolean;
+    /**
+     * Error message if the function host failed to start.
+     */
+    error: string;
+    /**
+     * An async iterable stream of terminal output from the function host task.
+     * This stream provides real-time access to the output of the `func host start` command,
+     * allowing consumers to monitor host status, capture logs, and detect errors.
+     * 
+     * The stream will be undefined if the host failed to start or if output streaming is not available.
+     * Consumers should iterate over the stream asynchronously to read output lines as they are produced.
+     * The stream remains active for the lifetime of the function host process.
+     */
+    stream: AsyncIterable<string> | undefined;
+}
+
 export async function startFuncProcessFromApi(
     buildPath: string,
     args: string[],
     env: { [key: string]: string }
-): Promise<{ processId: string; success: boolean; error: string }> {
-    const result = {
+): Promise<IStartFuncProcessResult> {
+    const result: IStartFuncProcessResult = {
         processId: '',
         success: false,
-        error: ''
+        error: '',
+        stream: undefined
     };
 
     let funcHostStartCmd: string = 'func host start';
@@ -66,6 +95,7 @@ export async function startFuncProcessFromApi(
             const taskInfo = await startFuncTask(context, workspaceFolder, buildPath, funcTask);
             result.processId = await pickChildProcess(taskInfo);
             result.success = true;
+            result.stream = taskInfo.stream;
         } catch (err) {
             const pError = parseError(err);
             result.error = pError.message;
@@ -140,6 +170,7 @@ async function startFuncTask(context: IActionContext, workspaceFolder: vscode.Wo
         const funcPort: string = await getFuncPortFromTaskOrProject(context, funcTask, workspaceFolder);
         let statusRequestTimeout: number = intervalMs;
         const maxTime: number = Date.now() + timeoutInSeconds * 1000;
+
         while (Date.now() < maxTime) {
             if (taskError !== undefined) {
                 throw taskError;
@@ -171,6 +202,7 @@ async function startFuncTask(context: IActionContext, workspaceFolder: vscode.Wo
                         }
                     }
                 }
+
             }
 
             await delay(intervalMs);

src/debug/FuncTaskProvider.ts

@@ -104,6 +104,11 @@ export class FuncTaskProvider implements TaskProvider {
 
     private async createTask(context: IActionContext, command: string, folder: WorkspaceFolder, projectRoot: string | undefined, language: string | undefined, definition?: TaskDefinition): Promise<Task> {
         const funcCliPath = await getFuncCliPath(context, folder);
+        const args = (definition?.args || []) as string[];
+        if (args.length > 0) {
+            command = `${command} ${args.join(' ')}`;
+        }
+
         let commandLine: string = `${funcCliPath} ${command}`;
         if (language === ProjectLanguage.Python) {
             commandLine = venvUtils.convertToVenvCommand(commandLine, folder.uri.fsPath);