@dexto/core 1.3.0 → 1.5.0

package/dist/plugins/registry.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import type { DextoPlugin } from './types.js';
+import { BaseRegistry } from '../providers/base-registry.js';
+/**
+ * Context passed to plugin providers when creating plugin instances.
+ * Provides access to configuration and optional services.
+ */
+export interface PluginCreationContext {
+    /** Plugin-specific configuration from YAML */
+    config: Record<string, any>;
+    /** Whether this plugin should block execution on errors */
+    blocking: boolean;
+    /** Execution priority (lower runs first) */
+    priority: number;
+}
+/**
+ * Plugin provider interface.
+ * Allows external code to register plugin providers that create plugin instances.
+ * Follows the same pattern as BlobStoreProvider, CompressionProvider, and CustomToolProvider.
+ *
+ * @template TType - The provider type discriminator (must match config.type)
+ * @template TConfig - The provider configuration type (must include { type: TType })
+ */
+export interface PluginProvider<TType extends string = string, TConfig extends {
+    type: TType;
+} = any> {
+    /** Unique type identifier matching the discriminator in config */
+    type: TType;
+    /** Zod schema for runtime validation of provider configuration */
+    configSchema: z.ZodType<TConfig, any, any>;
+    /**
+     * Factory function to create a plugin instance from validated configuration
+     * @param config - Validated configuration matching configSchema
+     * @param context - Plugin creation context with priority and blocking settings
+     * @returns A DextoPlugin instance
+     */
+    create(config: TConfig, context: PluginCreationContext): DextoPlugin;
+    /** Optional metadata for display and categorization */
+    metadata?: {
+        displayName: string;
+        description: string;
+        /** Which extension points this plugin implements */
+        extensionPoints?: Array<'beforeLLMRequest' | 'beforeToolCall' | 'afterToolResult' | 'beforeResponse'>;
+        /** Category for grouping (e.g., 'security', 'logging', 'integration') */
+        category?: string;
+    };
+}
+/**
+ * Registry for plugin providers.
+ * Follows the same pattern as BlobStoreRegistry, CompressionRegistry, and CustomToolRegistry.
+ *
+ * Plugin providers can be registered from external code (CLI, apps, distributions)
+ * and are validated at runtime using their Zod schemas.
+ *
+ * Extends BaseRegistry for common registry functionality.
+ *
+ * @example
+ * ```typescript
+ * // Define a plugin provider
+ * const myPluginProvider: PluginProvider<'my-plugin', MyPluginConfig> = {
+ *     type: 'my-plugin',
+ *     configSchema: MyPluginConfigSchema,
+ *     create(config, context) {
+ *         return new MyPlugin(config, context);
+ *     },
+ *     metadata: {
+ *         displayName: 'My Plugin',
+ *         description: 'Does something useful',
+ *         extensionPoints: ['beforeLLMRequest'],
+ *         category: 'custom',
+ *     },
+ * };
+ *
+ * // Register in dexto.config.ts
+ * import { pluginRegistry } from '@dexto/core';
+ * pluginRegistry.register(myPluginProvider);
+ *
+ * // Use in agent YAML
+ * plugins:
+ *   registry:
+ *     - type: my-plugin
+ *       priority: 50
+ *       blocking: false
+ *       config:
+ *         key: value
+ * ```
+ */
+export declare class PluginRegistry extends BaseRegistry<PluginProvider> {
+    constructor();
+    /**
+     * Get all registered plugin providers.
+     * Alias for getAll() to match other registry patterns.
+     */
+    getProviders(): PluginProvider[];
+}
+/**
+ * Global singleton instance of the plugin registry.
+ * Plugin providers should be registered at application startup.
+ */
+export declare const pluginRegistry: PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,YAAY,EAA6B,MAAM,+BAA+B,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAC3B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,OAAO,SAAS;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG,GAAG;IAErC,kEAAkE;IAClE,IAAI,EAAE,KAAK,CAAC;IAEZ,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,WAAW,CAAC;IAErE,uDAAuD;IACvD,QAAQ,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,oDAAoD;QACpD,eAAe,CAAC,EAAE,KAAK,CACnB,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,CAC/E,CAAC;QACF,yEAAyE;QACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,cAAe,SAAQ,YAAY,CAAC,cAAc,CAAC;;IAK5D;;;OAGG;IACH,YAAY,IAAI,cAAc,EAAE;CAGnC;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/plugins/registry.js

@@ -0,0 +1,39 @@
+import "../chunk-PTJYTZNU.js";
+import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";
+import { PluginErrorCode } from "./error-codes.js";
+import { BaseRegistry } from "../providers/base-registry.js";
+const pluginRegistryErrorFactory = {
+  alreadyRegistered: (type) => new DextoRuntimeError(
+    PluginErrorCode.PLUGIN_PROVIDER_ALREADY_REGISTERED,
+    ErrorScope.PLUGIN,
+    ErrorType.USER,
+    `Plugin provider '${type}' is already registered`,
+    { type },
+    "Each plugin provider type can only be registered once"
+  ),
+  notFound: (type, availableTypes) => new DextoRuntimeError(
+    PluginErrorCode.PLUGIN_PROVIDER_NOT_FOUND,
+    ErrorScope.PLUGIN,
+    ErrorType.USER,
+    `Plugin provider '${type}' not found`,
+    { type, available: availableTypes },
+    `Available plugin providers: ${availableTypes.join(", ") || "none"}`
+  )
+};
+class PluginRegistry extends BaseRegistry {
+  constructor() {
+    super(pluginRegistryErrorFactory);
+  }
+  /**
+   * Get all registered plugin providers.
+   * Alias for getAll() to match other registry patterns.
+   */
+  getProviders() {
+    return this.getAll();
+  }
+}
+const pluginRegistry = new PluginRegistry();
+export {
+  PluginRegistry,
+  pluginRegistry
+};

package/dist/plugins/schemas.cjs

@@ -20,10 +20,18 @@ var schemas_exports = {};
 __export(schemas_exports, {
   BuiltInPluginConfigSchema: () => BuiltInPluginConfigSchema,
   CustomPluginConfigSchema: () => CustomPluginConfigSchema,
-  PluginsConfigSchema: () => PluginsConfigSchema
+  PluginsConfigSchema: () => PluginsConfigSchema,
+  RegistryPluginConfigSchema: () => RegistryPluginConfigSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 var import_zod = require("zod");
+const RegistryPluginConfigSchema = import_zod.z.object({
+  type: import_zod.z.string().describe("Plugin provider type (must be registered in pluginRegistry)"),
+  enabled: import_zod.z.boolean().default(true).describe("Whether this plugin is enabled"),
+  blocking: import_zod.z.boolean().describe("If true, plugin errors will halt execution"),
+  priority: import_zod.z.number().int().describe("Execution priority (lower runs first)"),
+  config: import_zod.z.record(import_zod.z.any()).optional().describe("Plugin-specific configuration")
+}).strict();
 const CustomPluginConfigSchema = import_zod.z.object({
   name: import_zod.z.string().describe("Unique name for the plugin"),
   module: import_zod.z.string().describe(
@@ -48,14 +56,18 @@ const PluginsConfigSchema = import_zod.z.object({
   responseSanitizer: BuiltInPluginConfigSchema.optional().describe(
     "Response sanitizer plugin for output sanitization"
   ),
-  // Custom plugins - array of plugin configurations
-  custom: import_zod.z.array(CustomPluginConfigSchema).default([]).describe("Array of custom plugin configurations")
+  // Custom plugins - array of plugin configurations (loaded from file paths)
+  custom: import_zod.z.array(CustomPluginConfigSchema).default([]).describe("Array of custom plugin configurations (loaded from file paths)"),
+  // Registry plugins - array of plugin configurations (loaded from pluginRegistry)
+  registry: import_zod.z.array(RegistryPluginConfigSchema).default([]).describe("Array of registry plugin configurations (loaded from pluginRegistry)")
 }).strict().default({
-  custom: []
+  custom: [],
+  registry: []
 }).describe("Plugin system configuration");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BuiltInPluginConfigSchema,
   CustomPluginConfigSchema,
-  PluginsConfigSchema
+  PluginsConfigSchema,
+  RegistryPluginConfigSchema
 });

package/dist/plugins/schemas.d.ts

@@ -1,4 +1,28 @@
 import { z } from 'zod';
+/**
+ * Schema for registry-based plugin configuration.
+ * These plugins are loaded from the pluginRegistry (programmatically registered).
+ */
+export declare const RegistryPluginConfigSchema: z.ZodObject<{
+    type: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    blocking: z.ZodBoolean;
+    priority: z.ZodNumber;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    enabled: boolean;
+    priority: number;
+    blocking: boolean;
+    config?: Record<string, any> | undefined;
+}, {
+    type: string;
+    priority: number;
+    blocking: boolean;
+    config?: Record<string, any> | undefined;
+    enabled?: boolean | undefined;
+}>;
+export type RegistryPluginConfig = z.output<typeof RegistryPluginConfigSchema>;
 /**
  * Schema for custom plugin configuration (loaded from file paths)
  */
@@ -10,17 +34,17 @@ export declare const CustomPluginConfigSchema: z.ZodObject<{
     priority: z.ZodNumber;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strict", z.ZodTypeAny, {
-    enabled: boolean;
     name: string;
+    enabled: boolean;
     priority: number;
-    module: string;
     blocking: boolean;
+    module: string;
     config?: Record<string, any> | undefined;
 }, {
     name: string;
     priority: number;
-    module: string;
     blocking: boolean;
+    module: string;
     config?: Record<string, any> | undefined;
     enabled?: boolean | undefined;
 }>;
@@ -43,7 +67,7 @@ export declare const BuiltInPluginConfigSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 /**
  * Main plugins configuration schema
- * Supports both built-in plugins (by name) and custom plugins (with module paths)
+ * Supports built-in plugins (by name), custom plugins (file paths), and registry plugins (programmatic)
  */
 export declare const PluginsConfigSchema: z.ZodDefault<z.ZodObject<{
     contentPolicy: z.ZodOptional<z.ZodObject<{
@@ -80,26 +104,52 @@ export declare const PluginsConfigSchema: z.ZodDefault<z.ZodObject<{
         priority: z.ZodNumber;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, "strict", z.ZodTypeAny, {
-        enabled: boolean;
         name: string;
+        enabled: boolean;
         priority: number;
-        module: string;
         blocking: boolean;
+        module: string;
         config?: Record<string, any> | undefined;
     }, {
         name: string;
         priority: number;
+        blocking: boolean;
         module: string;
+        config?: Record<string, any> | undefined;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+    registry: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        blocking: z.ZodBoolean;
+        priority: z.ZodNumber;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        enabled: boolean;
+        priority: number;
+        blocking: boolean;
+        config?: Record<string, any> | undefined;
+    }, {
+        type: string;
+        priority: number;
         blocking: boolean;
         config?: Record<string, any> | undefined;
         enabled?: boolean | undefined;
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     custom: {
-        enabled: boolean;
         name: string;
+        enabled: boolean;
         priority: number;
+        blocking: boolean;
         module: string;
+        config?: Record<string, any> | undefined;
+    }[];
+    registry: {
+        type: string;
+        enabled: boolean;
+        priority: number;
         blocking: boolean;
         config?: Record<string, any> | undefined;
     }[];
@@ -117,8 +167,8 @@ export declare const PluginsConfigSchema: z.ZodDefault<z.ZodObject<{
     custom?: {
         name: string;
         priority: number;
-        module: string;
         blocking: boolean;
+        module: string;
         config?: Record<string, any> | undefined;
         enabled?: boolean | undefined;
     }[] | undefined;
@@ -132,6 +182,13 @@ export declare const PluginsConfigSchema: z.ZodDefault<z.ZodObject<{
         blocking: z.ZodOptional<z.ZodBoolean>;
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
+    registry?: {
+        type: string;
+        priority: number;
+        blocking: boolean;
+        config?: Record<string, any> | undefined;
+        enabled?: boolean | undefined;
+    }[] | undefined;
 }>>;
 export type PluginsConfig = z.input<typeof PluginsConfigSchema>;
 export type ValidatedPluginsConfig = z.output<typeof PluginsConfigSchema>;

package/dist/plugins/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/plugins/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAaxB,CAAC;AAEd;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;gCAQc,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoBY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/plugins/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAaxB,CAAC;AAEd;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;gCAQc,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/plugins/schemas.js

@@ -1,5 +1,12 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { z } from "zod";
+const RegistryPluginConfigSchema = z.object({
+  type: z.string().describe("Plugin provider type (must be registered in pluginRegistry)"),
+  enabled: z.boolean().default(true).describe("Whether this plugin is enabled"),
+  blocking: z.boolean().describe("If true, plugin errors will halt execution"),
+  priority: z.number().int().describe("Execution priority (lower runs first)"),
+  config: z.record(z.any()).optional().describe("Plugin-specific configuration")
+}).strict();
 const CustomPluginConfigSchema = z.object({
   name: z.string().describe("Unique name for the plugin"),
   module: z.string().describe(
@@ -24,13 +31,17 @@ const PluginsConfigSchema = z.object({
   responseSanitizer: BuiltInPluginConfigSchema.optional().describe(
     "Response sanitizer plugin for output sanitization"
   ),
-  // Custom plugins - array of plugin configurations
-  custom: z.array(CustomPluginConfigSchema).default([]).describe("Array of custom plugin configurations")
+  // Custom plugins - array of plugin configurations (loaded from file paths)
+  custom: z.array(CustomPluginConfigSchema).default([]).describe("Array of custom plugin configurations (loaded from file paths)"),
+  // Registry plugins - array of plugin configurations (loaded from pluginRegistry)
+  registry: z.array(RegistryPluginConfigSchema).default([]).describe("Array of registry plugin configurations (loaded from pluginRegistry)")
 }).strict().default({
-  custom: []
+  custom: [],
+  registry: []
 }).describe("Plugin system configuration");
 export {
   BuiltInPluginConfigSchema,
   CustomPluginConfigSchema,
-  PluginsConfigSchema
+  PluginsConfigSchema,
+  RegistryPluginConfigSchema
 };

package/dist/plugins/types.d.ts

@@ -105,7 +105,6 @@ export interface BeforeResponsePayload {
     reasoning?: string;
     provider: string;
     model?: string;
-    router?: string;
     tokenUsage?: {
         input: number;
         output: number;

package/dist/plugins/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"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"}

package/dist/process/command-validator.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 const MAX_COMMAND_LENGTH = 1e4;
 const DANGEROUS_PATTERNS = [
   // File system destruction

package/dist/process/error-codes.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var ProcessErrorCode = /* @__PURE__ */ ((ProcessErrorCode2) => {
   ProcessErrorCode2["INVALID_COMMAND"] = "PROCESS_INVALID_COMMAND";
   ProcessErrorCode2["COMMAND_BLOCKED"] = "PROCESS_COMMAND_BLOCKED";

package/dist/process/errors.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { DextoRuntimeError } from "../errors/index.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { ProcessErrorCode } from "./error-codes.js";

package/dist/process/index.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { ProcessService } from "./process-service.js";
 import { CommandValidator } from "./command-validator.js";
 import { ProcessError } from "./errors.js";

package/dist/process/process-service.cjs

@@ -85,23 +85,6 @@ class ProcessService {
       throw import_errors.ProcessError.invalidCommand(command, validation.error || "Unknown error");
     }
     const normalizedCommand = validation.normalizedCommand;
-    if (validation.requiresApproval) {
-      if (!options.approvalFunction) {
-        throw import_errors.ProcessError.approvalRequired(
-          normalizedCommand,
-          "Command requires approval but no approval mechanism provided"
-        );
-      }
-      this.logger.info(
-        `Command requires approval: ${normalizedCommand} - requesting user confirmation`
-      );
-      const approved = await options.approvalFunction(normalizedCommand);
-      if (!approved) {
-        this.logger.info(`Command approval denied: ${normalizedCommand}`);
-        throw import_errors.ProcessError.approvalDenied(normalizedCommand);
-      }
-      this.logger.info(`Command approved: ${normalizedCommand}`);
-    }
     const rawTimeout = options.timeout !== void 0 && Number.isFinite(options.timeout) ? options.timeout : DEFAULT_TIMEOUT;
     const timeout = Math.max(1, Math.min(rawTimeout, this.config.maxTimeout));
     const cwd = this.resolveSafeCwd(options.cwd);
@@ -122,11 +105,41 @@ class ProcessService {
       cwd,
       timeout,
       env,
-      ...options.description !== void 0 && { description: options.description }
+      ...options.description !== void 0 && { description: options.description },
+      ...options.abortSignal !== void 0 && { abortSignal: options.abortSignal }
     });
   }
+  static SIGKILL_TIMEOUT_MS = 200;
+  /**
+   * Kill a process tree (process group on Unix, taskkill on Windows)
+   */
+  async killProcessTree(pid, child) {
+    if (process.platform === "win32") {
+      await new Promise((resolve) => {
+        const killer = (0, import_node_child_process.spawn)("taskkill", ["/pid", String(pid), "/f", "/t"], {
+          stdio: "ignore"
+        });
+        killer.once("exit", () => resolve());
+        killer.once("error", () => resolve());
+      });
+    } else {
+      try {
+        process.kill(-pid, "SIGTERM");
+        await new Promise((res) => setTimeout(res, ProcessService.SIGKILL_TIMEOUT_MS));
+        if (child.exitCode === null) {
+          process.kill(-pid, "SIGKILL");
+        }
+      } catch {
+        child.kill("SIGTERM");
+        await new Promise((res) => setTimeout(res, ProcessService.SIGKILL_TIMEOUT_MS));
+        if (child.exitCode === null) {
+          child.kill("SIGKILL");
+        }
+      }
+    }
+  }
   /**
-   * Execute command in foreground with timeout
+   * Execute command in foreground with timeout and abort support
    */
   executeForeground(command, options) {
     return new Promise((resolve, reject) => {
@@ -134,22 +147,47 @@ class ProcessService {
       let stdout = "";
       let stderr = "";
       let killed = false;
+      let aborted = false;
       let closed = false;
+      if (options.abortSignal?.aborted) {
+        this.logger.debug(`Command cancelled before execution: ${command}`);
+        resolve({
+          stdout: "",
+          stderr: "(Command was cancelled)",
+          exitCode: 130,
+          // Standard exit code for SIGINT
+          duration: 0
+        });
+        return;
+      }
       this.logger.debug(`Executing command: ${command}`);
       const child = (0, import_node_child_process.spawn)(command, {
         cwd: options.cwd,
         env: options.env,
-        shell: true
+        shell: true,
+        detached: process.platform !== "win32"
+        // Create process group on Unix
       });
       const timeoutHandle = setTimeout(() => {
         killed = true;
-        child.kill("SIGTERM");
-        setTimeout(() => {
-          if (!closed && child.exitCode === null) {
-            child.kill("SIGKILL");
-          }
-        }, 5e3);
+        if (child.pid) {
+          void this.killProcessTree(child.pid, child);
+        } else {
+          child.kill("SIGTERM");
+        }
       }, options.timeout);
+      const abortHandler = () => {
+        if (closed) return;
+        aborted = true;
+        this.logger.debug(`Command cancelled by user: ${command}`);
+        clearTimeout(timeoutHandle);
+        if (child.pid) {
+          void this.killProcessTree(child.pid, child);
+        } else {
+          child.kill("SIGTERM");
+        }
+      };
+      options.abortSignal?.addEventListener("abort", abortHandler, { once: true });
       child.stdout?.on("data", (data) => {
         stdout += data.toString();
       });
@@ -159,7 +197,20 @@ class ProcessService {
       child.on("close", (code, signal) => {
         closed = true;
         clearTimeout(timeoutHandle);
+        options.abortSignal?.removeEventListener("abort", abortHandler);
         const duration = Date.now() - startTime;
+        if (aborted) {
+          stdout += "\n\n(Command was cancelled)";
+          this.logger.debug(`Command cancelled after ${duration}ms: ${command}`);
+          resolve({
+            stdout,
+            stderr,
+            exitCode: 130,
+            // Standard exit code for SIGINT
+            duration
+          });
+          return;
+        }
         if (killed) {
           reject(import_errors.ProcessError.timeout(command, options.timeout));
           return;
@@ -181,6 +232,7 @@ Process terminated by signal ${signal ?? "UNKNOWN"}`;
       });
       child.on("error", (error) => {
         clearTimeout(timeoutHandle);
+        options.abortSignal?.removeEventListener("abort", abortHandler);
         if (error.code === "ENOENT") {
           reject(import_errors.ProcessError.commandNotFound(command));
         } else if (error.code === "EACCES") {

package/dist/process/process-service.d.ts

@@ -24,8 +24,13 @@ export declare class ProcessService {
      * Execute a command
      */
     executeCommand(command: string, options?: ExecuteOptions): Promise<ProcessResult | ProcessHandle>;
+    private static readonly SIGKILL_TIMEOUT_MS;
     /**
-     * Execute command in foreground with timeout
+     * Kill a process tree (process group on Unix, taskkill on Windows)
+     */
+    private killProcessTree;
+    /**
+     * Execute command in foreground with timeout and abort support
      */
     private executeForeground;
     /**

package/dist/process/process-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../../src/process/process-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACH,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EAEd,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAuB1D;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,YAAK,EAAE,MAAM,EAAE,YAAY;IAkBrE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAwEzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsFzB;;OAEG;YACW,mBAAmB;IAiKjC;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BjE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIpC;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAcjC"}
+{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../../src/process/process-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACH,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EAEd,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAuB1D;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,YAAK,EAAE,MAAM,EAAE,YAAY;IAkBrE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAuDzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAEjD;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsIzB;;OAEG;YACW,mBAAmB;IAiKjC;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BjE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIpC;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAcjC"}