@dexto/tools-process 1.7.2 → 1.8.0

package/dist/bash-exec-tool.cjs

@@ -33,7 +33,7 @@ __export(bash_exec_tool_exports, {
 module.exports = __toCommonJS(bash_exec_tool_exports);
 var path = __toESM(require("node:path"), 1);
 var import_zod = require("zod");
-var import_core = require("@dexto/core");
+var import_tools = require("@dexto/core/tools");
 var import_errors = require("./errors.js");
 var import_command_pattern_utils = require("./command-pattern-utils.js");
 const BashExecInputSchema = import_zod.z.object({
@@ -46,7 +46,7 @@ const BashExecInputSchema = import_zod.z.object({
   cwd: import_zod.z.string().optional().describe("Working directory for command execution (optional)")
 }).strict();
 function createBashExecTool(getProcessService) {
-  return (0, import_core.defineTool)({
+  return (0, import_tools.defineTool)({
     id: "bash_exec",
     aliases: ["bash"],
     description: `Execute a shell command in the project root directory.
@@ -100,9 +100,9 @@ Security: Dangerous commands are blocked. Injection attempts are detected. Requi
       suggestPatterns: (input) => (0, import_command_pattern_utils.generateCommandPatternSuggestions)(input.command)
     },
     presentation: {
-      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+      describeHeader: (input) => (0, import_tools.createLocalToolCallHeader)({
         title: "Bash",
-        argsText: (0, import_core.truncateForHeader)(input.command, 140)
+        argsText: (0, import_tools.truncateForHeader)(input.command, 140)
       }),
       /**
        * Generate preview for approval UI - shows the command to be executed
@@ -123,8 +123,10 @@ Security: Dangerous commands are blocked. Injection attempts are detected. Requi
       }
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
       const { command, description, timeout, run_in_background, cwd } = input;
+      const resolvedProcessService = await getProcessService(context, {
+        background: run_in_background
+      });
       let validatedCwd = cwd;
       if (cwd) {
         const baseDir = resolvedProcessService.getConfig().workingDirectory || process.cwd();

package/dist/bash-exec-tool.d.ts

@@ -5,8 +5,8 @@
  * Pattern-based approval support is declared on the tool (ToolManager stays generic).
  */
 import { z } from 'zod';
-import type { Tool, ToolExecutionContext } from '@dexto/core';
-import { ProcessService } from './process-service.js';
+import type { Tool, ToolExecutionContext } from '@dexto/core/tools';
+import type { ExecuteOptions, ProcessConfig, ProcessHandle, ProcessOutput, ProcessResult } from './types.js';
 declare const BashExecInputSchema: z.ZodObject<{
     command: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -17,7 +17,15 @@ declare const BashExecInputSchema: z.ZodObject<{
 /**
  * Create the bash_exec internal tool
  */
-export type ProcessServiceGetter = (context: ToolExecutionContext) => Promise<ProcessService>;
+export interface ProcessCommandService {
+    executeCommand(command: string, options?: ExecuteOptions): Promise<ProcessResult | ProcessHandle>;
+    getConfig(): Readonly<ProcessConfig>;
+    getProcessOutput(processId: string): Promise<ProcessOutput>;
+    killProcess(processId: string): Promise<void>;
+}
+export type ProcessServiceGetter = (context: ToolExecutionContext, options?: {
+    background?: boolean;
+}) => Promise<ProcessCommandService>;
 export declare function createBashExecTool(getProcessService: ProcessServiceGetter): Tool<typeof BashExecInputSchema>;
 export {};
 //# sourceMappingURL=bash-exec-tool.d.ts.map

package/dist/bash-exec-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-exec-tool.d.ts","sourceRoot":"","sources":["../src/bash-exec-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,QAAA,MAAM,mBAAmB;;;;;;kBAwBZ,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9F,wBAAgB,kBAAkB,CAC9B,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAmKlC"}
+{"version":3,"file":"bash-exec-tool.d.ts","sourceRoot":"","sources":["../src/bash-exec-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAoB,IAAI,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAMtF,OAAO,KAAK,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EAChB,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,mBAAmB;;;;;;kBAwBZ,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,cAAc,CACV,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC,CAAC;IAC1C,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC;IACrC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,oBAAoB,GAAG,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,KACjC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,wBAAgB,kBAAkB,CAC9B,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAoKlC"}

package/dist/bash-exec-tool.js

@@ -1,6 +1,6 @@
 import * as path from "node:path";
 import { z } from "zod";
-import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core";
+import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core/tools";
 import { ProcessError } from "./errors.js";
 import {
   generateCommandPatternKey,
@@ -93,8 +93,10 @@ Security: Dangerous commands are blocked. Injection attempts are detected. Requi
       }
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
       const { command, description, timeout, run_in_background, cwd } = input;
+      const resolvedProcessService = await getProcessService(context, {
+        background: run_in_background
+      });
       let validatedCwd = cwd;
       if (cwd) {
         const baseDir = resolvedProcessService.getConfig().workingDirectory || process.cwd();

package/dist/bash-output-tool.cjs

@@ -22,23 +22,25 @@ __export(bash_output_tool_exports, {
 });
 module.exports = __toCommonJS(bash_output_tool_exports);
 var import_zod = require("zod");
-var import_core = require("@dexto/core");
+var import_tools = require("@dexto/core/tools");
 const BashOutputInputSchema = import_zod.z.object({
   process_id: import_zod.z.string().describe("Process ID from bash_exec (when run_in_background=true)")
 }).strict();
 function createBashOutputTool(getProcessService) {
-  return (0, import_core.defineTool)({
+  return (0, import_tools.defineTool)({
     id: "bash_output",
     description: "Retrieve output from a background process started with bash_exec. Returns stdout, stderr, status (running/completed/failed), exit code, and duration. Each call returns only new output since last read. The output buffer is cleared after reading. Use this tool to monitor long-running commands.",
     inputSchema: BashOutputInputSchema,
     presentation: {
-      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+      describeHeader: (input) => (0, import_tools.createLocalToolCallHeader)({
         title: "Bash Output",
-        argsText: (0, import_core.truncateForHeader)(input.process_id, 80)
+        argsText: (0, import_tools.truncateForHeader)(input.process_id, 80)
       })
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
+      const resolvedProcessService = await getProcessService(context, {
+        background: true
+      });
       const { process_id } = input;
       const result = await resolvedProcessService.getProcessOutput(process_id);
       return {

package/dist/bash-output-tool.d.ts

@@ -4,7 +4,7 @@
  * Internal tool for retrieving output from background processes
  */
 import { z } from 'zod';
-import type { Tool } from '@dexto/core';
+import type { Tool } from '@dexto/core/tools';
 import type { ProcessServiceGetter } from './bash-exec-tool.js';
 declare const BashOutputInputSchema: z.ZodObject<{
     process_id: z.ZodString;

package/dist/bash-output-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-output-tool.d.ts","sourceRoot":"","sources":["../src/bash-output-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,QAAA,MAAM,qBAAqB;;kBAId,CAAC;AAEd;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,qBAAqB,CAAC,CA+BpC"}
+{"version":3,"file":"bash-output-tool.d.ts","sourceRoot":"","sources":["../src/bash-output-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,QAAA,MAAM,qBAAqB;;kBAId,CAAC;AAEd;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAiCpC"}

package/dist/bash-output-tool.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core";
+import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core/tools";
 const BashOutputInputSchema = z.object({
   process_id: z.string().describe("Process ID from bash_exec (when run_in_background=true)")
 }).strict();
@@ -15,7 +15,9 @@ function createBashOutputTool(getProcessService) {
       })
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
+      const resolvedProcessService = await getProcessService(context, {
+        background: true
+      });
       const { process_id } = input;
       const result = await resolvedProcessService.getProcessOutput(process_id);
       return {

package/dist/command-validator.d.ts

@@ -4,7 +4,7 @@
  * Security-focused command validation for process execution
  */
 import { ProcessConfig, CommandValidation } from './types.js';
-import type { Logger } from '@dexto/core';
+import type { Logger } from '@dexto/core/logger';
 /**
  * CommandValidator - Validates commands for security and policy compliance
  *

package/dist/command-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-validator.d.ts","sourceRoot":"","sources":["../src/command-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAkQ1C;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAQjD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAgFnD;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAyCpC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG7B"}
+{"version":3,"file":"command-validator.d.ts","sourceRoot":"","sources":["../src/command-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAkQjD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAQjD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAgFnD;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAyCpC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG7B"}

package/dist/errors.cjs

@@ -21,7 +21,7 @@ __export(errors_exports, {
   ProcessError: () => ProcessError
 });
 module.exports = __toCommonJS(errors_exports);
-var import_core = require("@dexto/core");
+var import_errors = require("@dexto/core/errors");
 var import_error_codes = require("./error-codes.js");
 const PROCESS_SCOPE = "process";
 class ProcessError {
@@ -31,10 +31,10 @@ class ProcessError {
    * Invalid command error
    */
   static invalidCommand(command, reason) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.INVALID_COMMAND,
       PROCESS_SCOPE,
-      import_core.ErrorType.USER,
+      import_errors.ErrorType.USER,
       `Invalid command: ${command}. ${reason}`,
       { command, reason }
     );
@@ -43,10 +43,10 @@ class ProcessError {
    * Command blocked error
    */
   static commandBlocked(command, reason) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.COMMAND_BLOCKED,
       PROCESS_SCOPE,
-      import_core.ErrorType.FORBIDDEN,
+      import_errors.ErrorType.FORBIDDEN,
       `Command is blocked: ${command}. ${reason}`,
       { command, reason }
     );
@@ -55,10 +55,10 @@ class ProcessError {
    * Command too long error
    */
   static commandTooLong(length, maxLength) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.COMMAND_TOO_LONG,
       PROCESS_SCOPE,
-      import_core.ErrorType.USER,
+      import_errors.ErrorType.USER,
       `Command too long: ${length} characters. Maximum allowed: ${maxLength}`,
       { length, maxLength }
     );
@@ -67,10 +67,10 @@ class ProcessError {
    * Command injection detected error
    */
   static commandInjection(command, pattern) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.INJECTION_DETECTED,
       PROCESS_SCOPE,
-      import_core.ErrorType.FORBIDDEN,
+      import_errors.ErrorType.FORBIDDEN,
       `Potential command injection detected in: ${command}. Pattern: ${pattern}`,
       { command, pattern }
     );
@@ -79,10 +79,10 @@ class ProcessError {
    * Command approval required error
    */
   static approvalRequired(command, reason) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.APPROVAL_REQUIRED,
       PROCESS_SCOPE,
-      import_core.ErrorType.FORBIDDEN,
+      import_errors.ErrorType.FORBIDDEN,
       `Command requires approval: ${command}${reason ? `. ${reason}` : ""}`,
       { command, reason },
       "Provide an approval function to execute dangerous commands"
@@ -92,10 +92,10 @@ class ProcessError {
    * Command approval denied error
    */
   static approvalDenied(command) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.APPROVAL_DENIED,
       PROCESS_SCOPE,
-      import_core.ErrorType.FORBIDDEN,
+      import_errors.ErrorType.FORBIDDEN,
       `Command approval denied by user: ${command}`,
       { command }
     );
@@ -104,10 +104,10 @@ class ProcessError {
    * Command execution failed error
    */
   static executionFailed(command, cause) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.EXECUTION_FAILED,
       PROCESS_SCOPE,
-      import_core.ErrorType.SYSTEM,
+      import_errors.ErrorType.SYSTEM,
       `Command execution failed: ${command}. ${cause}`,
       { command, cause }
     );
@@ -116,10 +116,10 @@ class ProcessError {
    * Command timeout error
    */
   static timeout(command, timeout) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.TIMEOUT,
       PROCESS_SCOPE,
-      import_core.ErrorType.TIMEOUT,
+      import_errors.ErrorType.TIMEOUT,
       `Command timed out after ${timeout}ms: ${command}`,
       { command, timeout },
       "Increase timeout or optimize the command"
@@ -129,10 +129,10 @@ class ProcessError {
    * Permission denied error
    */
   static permissionDenied(command) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.PERMISSION_DENIED,
       PROCESS_SCOPE,
-      import_core.ErrorType.FORBIDDEN,
+      import_errors.ErrorType.FORBIDDEN,
       `Permission denied: ${command}`,
       { command }
     );
@@ -141,10 +141,10 @@ class ProcessError {
    * Command not found error
    */
   static commandNotFound(command) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.COMMAND_NOT_FOUND,
       PROCESS_SCOPE,
-      import_core.ErrorType.NOT_FOUND,
+      import_errors.ErrorType.NOT_FOUND,
       `Command not found: ${command}`,
       { command },
       "Ensure the command is installed and available in PATH"
@@ -154,10 +154,10 @@ class ProcessError {
    * Invalid working directory error
    */
   static invalidWorkingDirectory(path, reason) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.WORKING_DIRECTORY_INVALID,
       PROCESS_SCOPE,
-      import_core.ErrorType.USER,
+      import_errors.ErrorType.USER,
       `Invalid working directory: ${path}. ${reason}`,
       { path, reason }
     );
@@ -166,10 +166,10 @@ class ProcessError {
    * Process not found error
    */
   static processNotFound(processId) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.PROCESS_NOT_FOUND,
       PROCESS_SCOPE,
-      import_core.ErrorType.NOT_FOUND,
+      import_errors.ErrorType.NOT_FOUND,
       `Process not found: ${processId}`,
       { processId }
     );
@@ -178,10 +178,10 @@ class ProcessError {
    * Too many concurrent processes error
    */
   static tooManyProcesses(current, max) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.TOO_MANY_PROCESSES,
       PROCESS_SCOPE,
-      import_core.ErrorType.USER,
+      import_errors.ErrorType.USER,
       `Too many concurrent processes: ${current}. Maximum allowed: ${max}`,
       { current, max },
       "Wait for running processes to complete or increase the limit"
@@ -191,10 +191,10 @@ class ProcessError {
    * Kill process failed error
    */
   static killFailed(processId, cause) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.KILL_FAILED,
       PROCESS_SCOPE,
-      import_core.ErrorType.SYSTEM,
+      import_errors.ErrorType.SYSTEM,
       `Failed to kill process ${processId}: ${cause}`,
       { processId, cause }
     );
@@ -203,10 +203,10 @@ class ProcessError {
    * Output buffer full error
    */
   static outputBufferFull(processId, size, maxSize) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.OUTPUT_BUFFER_FULL,
       PROCESS_SCOPE,
-      import_core.ErrorType.SYSTEM,
+      import_errors.ErrorType.SYSTEM,
       `Output buffer full for process ${processId}: ${size} bytes. Maximum: ${maxSize}`,
       { processId, size, maxSize },
       "Process output exceeded buffer limit"
@@ -216,10 +216,10 @@ class ProcessError {
    * Invalid configuration error
    */
   static invalidConfig(reason) {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.INVALID_CONFIG,
       PROCESS_SCOPE,
-      import_core.ErrorType.USER,
+      import_errors.ErrorType.USER,
       `Invalid Process configuration: ${reason}`,
       { reason }
     );
@@ -228,10 +228,10 @@ class ProcessError {
    * Service not initialized error
    */
   static notInitialized() {
-    return new import_core.DextoRuntimeError(
+    return new import_errors.DextoRuntimeError(
       import_error_codes.ProcessErrorCode.SERVICE_NOT_INITIALIZED,
       PROCESS_SCOPE,
-      import_core.ErrorType.SYSTEM,
+      import_errors.ErrorType.SYSTEM,
       "ProcessService has not been initialized",
       {},
       "Initialize the ProcessService before using it"

package/dist/errors.d.ts

@@ -3,7 +3,7 @@
  *
  * Error classes for process execution and management
  */
-import { DextoRuntimeError } from '@dexto/core';
+import { DextoRuntimeError } from '@dexto/core/errors';
 export interface ProcessErrorContext {
     command?: string;
     processId?: string;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAM3D,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAU3E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAU5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAW5E;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAUzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAWnE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAU3D;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAW1D;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAU/E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAU5D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAWxE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAUtE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAW5F;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUvD;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,iBAAiB;CAU7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAa,MAAM,oBAAoB,CAAC;AAMlE,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAU3E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAU5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAW5E;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAUzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAUzE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAWnE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAU3D;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAW1D;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAU/E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAU5D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAWxE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAUtE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAW5F;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAUvD;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,iBAAiB;CAU7C"}

package/dist/errors.js

@@ -1,4 +1,4 @@
-import { DextoRuntimeError, ErrorType } from "@dexto/core";
+import { DextoRuntimeError, ErrorType } from "@dexto/core/errors";
 const PROCESS_SCOPE = "process";
 import { ProcessErrorCode } from "./error-codes.js";
 class ProcessError {

package/dist/index.d.cts

@@ -1,6 +1,8 @@
 import { ToolFactory } from '@dexto/agent-config';
 import { z } from 'zod';
-import { Logger, DextoRuntimeError, ToolExecutionContext, Tool } from '@dexto/core';
+import { Logger } from '@dexto/core/logger';
+import { DextoRuntimeError } from '@dexto/core/errors';
+import { ToolExecutionContext, Tool } from '@dexto/core/tools';
 
 /**
  * Process Tools Factory
@@ -415,7 +417,15 @@ declare const BashExecInputSchema: z.ZodObject<{
 /**
  * Create the bash_exec internal tool
  */
-type ProcessServiceGetter = (context: ToolExecutionContext) => Promise<ProcessService>;
+interface ProcessCommandService {
+    executeCommand(command: string, options?: ExecuteOptions): Promise<ProcessResult | ProcessHandle>;
+    getConfig(): Readonly<ProcessConfig>;
+    getProcessOutput(processId: string): Promise<ProcessOutput>;
+    killProcess(processId: string): Promise<void>;
+}
+type ProcessServiceGetter = (context: ToolExecutionContext, options?: {
+    background?: boolean;
+}) => Promise<ProcessCommandService>;
 declare function createBashExecTool(getProcessService: ProcessServiceGetter): Tool<typeof BashExecInputSchema>;
 
 /**

package/dist/kill-process-tool.cjs

@@ -22,23 +22,25 @@ __export(kill_process_tool_exports, {
 });
 module.exports = __toCommonJS(kill_process_tool_exports);
 var import_zod = require("zod");
-var import_core = require("@dexto/core");
+var import_tools = require("@dexto/core/tools");
 const KillProcessInputSchema = import_zod.z.object({
   process_id: import_zod.z.string().describe("Process ID of the background process to terminate")
 }).strict();
 function createKillProcessTool(getProcessService) {
-  return (0, import_core.defineTool)({
+  return (0, import_tools.defineTool)({
     id: "kill_process",
     description: "Terminate a background process started with bash_exec. Sends SIGTERM signal first, then SIGKILL if process doesn't terminate within 5 seconds. Only works on processes started by this agent. Returns success status and whether the process was running. Does not require additional approval (process was already approved when started).",
     inputSchema: KillProcessInputSchema,
     presentation: {
-      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+      describeHeader: (input) => (0, import_tools.createLocalToolCallHeader)({
         title: "Kill",
-        argsText: (0, import_core.truncateForHeader)(input.process_id, 80)
+        argsText: (0, import_tools.truncateForHeader)(input.process_id, 80)
       })
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
+      const resolvedProcessService = await getProcessService(context, {
+        background: true
+      });
       const { process_id } = input;
       await resolvedProcessService.killProcess(process_id);
       return {

package/dist/kill-process-tool.d.ts

@@ -4,7 +4,7 @@
  * Internal tool for terminating background processes
  */
 import { z } from 'zod';
-import type { Tool } from '@dexto/core';
+import type { Tool } from '@dexto/core/tools';
 import type { ProcessServiceGetter } from './bash-exec-tool.js';
 declare const KillProcessInputSchema: z.ZodObject<{
     process_id: z.ZodString;

package/dist/kill-process-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kill-process-tool.d.ts","sourceRoot":"","sources":["../src/kill-process-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,QAAA,MAAM,sBAAsB;;kBAIf,CAAC;AAEd;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CA8BrC"}
+{"version":3,"file":"kill-process-tool.d.ts","sourceRoot":"","sources":["../src/kill-process-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,QAAA,MAAM,sBAAsB;;kBAIf,CAAC;AAEd;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,iBAAiB,EAAE,oBAAoB,GACxC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAgCrC"}

package/dist/kill-process-tool.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core";
+import { createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core/tools";
 const KillProcessInputSchema = z.object({
   process_id: z.string().describe("Process ID of the background process to terminate")
 }).strict();
@@ -15,7 +15,9 @@ function createKillProcessTool(getProcessService) {
       })
     },
     async execute(input, context) {
-      const resolvedProcessService = await getProcessService(context);
+      const resolvedProcessService = await getProcessService(context, {
+        background: true
+      });
       const { process_id } = input;
       await resolvedProcessService.killProcess(process_id);
       return {

package/dist/process-service.cjs

@@ -36,7 +36,7 @@ var crypto = __toESM(require("node:crypto"), 1);
 var path = __toESM(require("node:path"), 1);
 var import_command_validator = require("./command-validator.js");
 var import_errors = require("./errors.js");
-var import_core = require("@dexto/core");
+var import_logger = require("@dexto/core/logger");
 const DEFAULT_TIMEOUT = 12e4;
 class ProcessService {
   config;
@@ -54,7 +54,7 @@ class ProcessService {
    */
   constructor(config, logger) {
     this.config = config;
-    this.logger = logger.createChild(import_core.DextoLogComponent.PROCESS);
+    this.logger = logger.createChild(import_logger.DextoLogComponent.PROCESS);
     this.commandValidator = new import_command_validator.CommandValidator(this.config, this.logger);
   }
   /**

package/dist/process-service.d.ts

@@ -4,7 +4,7 @@
  * Secure command execution and process management for Dexto internal tools
  */
 import { ProcessConfig, ExecuteOptions, ProcessResult, ProcessHandle, ProcessOutput, ProcessInfo } from './types.js';
-import type { Logger } from '@dexto/core';
+import type { Logger } from '@dexto/core/logger';
 /**
  * ProcessService - Handles command execution and process management
  *

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

@@ -1 +1 @@
-{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../src/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,MAAM,EAAE,MAAM,aAAa,CAAC;AAoB1C;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;OAMG;gBACS,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAQjD;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;YACW,YAAY;IAa1B;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC;;OAEG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAqDzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAEjD;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8KzB;;OAEG;YACW,mBAAmB;IAoKjC;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BjE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAe7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIpC;;OAEG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAQnD;;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-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,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAoBjD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;OAMG;gBACS,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAQjD;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;YACW,YAAY;IAa1B;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC;;OAEG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAqDzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAEjD;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8KzB;;OAEG;YACW,mBAAmB;IAoKjC;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BjE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAe7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAIpC;;OAEG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAQnD;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAcjC"}

package/dist/process-service.js

@@ -3,7 +3,7 @@ import * as crypto from "node:crypto";
 import * as path from "node:path";
 import { CommandValidator } from "./command-validator.js";
 import { ProcessError } from "./errors.js";
-import { DextoLogComponent } from "@dexto/core";
+import { DextoLogComponent } from "@dexto/core/logger";
 const DEFAULT_TIMEOUT = 12e4;
 class ProcessService {
   config;

package/dist/tool-factory.cjs

@@ -26,6 +26,9 @@ var import_bash_exec_tool = require("./bash-exec-tool.js");
 var import_bash_output_tool = require("./bash-output-tool.js");
 var import_kill_process_tool = require("./kill-process-tool.js");
 var import_tool_factory_config = require("./tool-factory-config.js");
+var import_command_validator = require("./command-validator.js");
+var import_errors = require("./errors.js");
+var import_workspace = require("@dexto/core/workspace");
 const processToolsFactory = {
   configSchema: import_tool_factory_config.ProcessToolsConfigSchema,
   metadata: {
@@ -57,7 +60,11 @@ const processToolsFactory = {
       const hasMethods = typeof candidate.executeCommand === "function" && typeof candidate.killProcess === "function" && typeof candidate.setWorkingDirectory === "function" && typeof candidate.getConfig === "function";
       return hasMethods ? candidate : null;
     };
-    const getProcessService = async (context) => {
+    const getProcessService = async (context, options = {}) => {
+      const workspaceProcessService = options.background === true ? null : await createWorkspaceProcessService(context, processConfig);
+      if (workspaceProcessService !== null) {
+        return workspaceProcessService;
+      }
       const injectedService = resolveInjectedService(context);
       if (injectedService) {
         applyWorkspace(context, injectedService);
@@ -83,6 +90,81 @@ const processToolsFactory = {
     ];
   }
 };
+async function createWorkspaceProcessService(context, processConfig) {
+  const workspaceManager = context.services?.workspaceManager;
+  if (workspaceManager === void 0) {
+    return null;
+  }
+  let handle;
+  try {
+    handle = await workspaceManager.open({ intent: "process" });
+  } catch (error) {
+    if (isWorkspaceUnavailable(error)) {
+      return null;
+    }
+    throw error;
+  }
+  if (handle.processes === void 0) {
+    return null;
+  }
+  return new WorkspaceProcessService(processConfig, context, handle);
+}
+function isWorkspaceUnavailable(error) {
+  if (typeof error === "object" && error !== null && "issues" in error && Array.isArray(error.issues)) {
+    return error.issues.some(
+      (issue) => typeof issue === "object" && issue !== null && "code" in issue && (issue.code === import_workspace.WorkspaceErrorCodes.CURRENT_WORKSPACE_REQUIRED || issue.code === import_workspace.WorkspaceErrorCodes.HANDLE_PROVIDER_REQUIRED)
+    );
+  }
+  return false;
+}
+class WorkspaceProcessService {
+  constructor(processConfig, context, handle) {
+    this.processConfig = processConfig;
+    this.context = context;
+    this.handle = handle;
+    this.commandValidator = new import_command_validator.CommandValidator(processConfig, context.logger);
+  }
+  commandValidator;
+  async executeCommand(command, options = {}) {
+    if (options.runInBackground === true) {
+      throw import_errors.ProcessError.executionFailed(
+        command,
+        "Workspace process handles do not support background execution yet"
+      );
+    }
+    const validation = this.commandValidator.validateCommand(command);
+    if (!validation.isValid || !validation.normalizedCommand) {
+      throw import_errors.ProcessError.invalidCommand(command, validation.error || "Unknown error");
+    }
+    const startedAt = Date.now();
+    const result = await this.handle.processes?.exec({
+      command: validation.normalizedCommand,
+      ...options.cwd === void 0 ? {} : { cwd: options.cwd },
+      ...options.timeout === void 0 ? {} : { timeout: options.timeout }
+    });
+    if (result === void 0) {
+      throw import_errors.ProcessError.executionFailed(command, "Workspace process execution unavailable");
+    }
+    return {
+      duration: Date.now() - startedAt,
+      exitCode: result.exitCode ?? 0,
+      stderr: result.stderr,
+      stdout: result.stdout
+    };
+  }
+  getConfig() {
+    return {
+      ...this.processConfig,
+      workingDirectory: this.handle.context.path
+    };
+  }
+  async getProcessOutput(processId) {
+    throw import_errors.ProcessError.processNotFound(processId);
+  }
+  async killProcess(processId) {
+    throw import_errors.ProcessError.processNotFound(processId);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   processToolsFactory

package/dist/tool-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,kBAAkB,CA0E/D,CAAC"}
+{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAO7F,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,kBAAkB,CAmF/D,CAAC"}

package/dist/tool-factory.js

@@ -3,6 +3,9 @@ import { createBashExecTool } from "./bash-exec-tool.js";
 import { createBashOutputTool } from "./bash-output-tool.js";
 import { createKillProcessTool } from "./kill-process-tool.js";
 import { ProcessToolsConfigSchema } from "./tool-factory-config.js";
+import { CommandValidator } from "./command-validator.js";
+import { ProcessError } from "./errors.js";
+import { WorkspaceErrorCodes } from "@dexto/core/workspace";
 const processToolsFactory = {
   configSchema: ProcessToolsConfigSchema,
   metadata: {
@@ -34,7 +37,11 @@ const processToolsFactory = {
       const hasMethods = typeof candidate.executeCommand === "function" && typeof candidate.killProcess === "function" && typeof candidate.setWorkingDirectory === "function" && typeof candidate.getConfig === "function";
       return hasMethods ? candidate : null;
     };
-    const getProcessService = async (context) => {
+    const getProcessService = async (context, options = {}) => {
+      const workspaceProcessService = options.background === true ? null : await createWorkspaceProcessService(context, processConfig);
+      if (workspaceProcessService !== null) {
+        return workspaceProcessService;
+      }
       const injectedService = resolveInjectedService(context);
       if (injectedService) {
         applyWorkspace(context, injectedService);
@@ -60,6 +67,81 @@ const processToolsFactory = {
     ];
   }
 };
+async function createWorkspaceProcessService(context, processConfig) {
+  const workspaceManager = context.services?.workspaceManager;
+  if (workspaceManager === void 0) {
+    return null;
+  }
+  let handle;
+  try {
+    handle = await workspaceManager.open({ intent: "process" });
+  } catch (error) {
+    if (isWorkspaceUnavailable(error)) {
+      return null;
+    }
+    throw error;
+  }
+  if (handle.processes === void 0) {
+    return null;
+  }
+  return new WorkspaceProcessService(processConfig, context, handle);
+}
+function isWorkspaceUnavailable(error) {
+  if (typeof error === "object" && error !== null && "issues" in error && Array.isArray(error.issues)) {
+    return error.issues.some(
+      (issue) => typeof issue === "object" && issue !== null && "code" in issue && (issue.code === WorkspaceErrorCodes.CURRENT_WORKSPACE_REQUIRED || issue.code === WorkspaceErrorCodes.HANDLE_PROVIDER_REQUIRED)
+    );
+  }
+  return false;
+}
+class WorkspaceProcessService {
+  constructor(processConfig, context, handle) {
+    this.processConfig = processConfig;
+    this.context = context;
+    this.handle = handle;
+    this.commandValidator = new CommandValidator(processConfig, context.logger);
+  }
+  commandValidator;
+  async executeCommand(command, options = {}) {
+    if (options.runInBackground === true) {
+      throw ProcessError.executionFailed(
+        command,
+        "Workspace process handles do not support background execution yet"
+      );
+    }
+    const validation = this.commandValidator.validateCommand(command);
+    if (!validation.isValid || !validation.normalizedCommand) {
+      throw ProcessError.invalidCommand(command, validation.error || "Unknown error");
+    }
+    const startedAt = Date.now();
+    const result = await this.handle.processes?.exec({
+      command: validation.normalizedCommand,
+      ...options.cwd === void 0 ? {} : { cwd: options.cwd },
+      ...options.timeout === void 0 ? {} : { timeout: options.timeout }
+    });
+    if (result === void 0) {
+      throw ProcessError.executionFailed(command, "Workspace process execution unavailable");
+    }
+    return {
+      duration: Date.now() - startedAt,
+      exitCode: result.exitCode ?? 0,
+      stderr: result.stderr,
+      stdout: result.stdout
+    };
+  }
+  getConfig() {
+    return {
+      ...this.processConfig,
+      workingDirectory: this.handle.context.path
+    };
+  }
+  async getProcessOutput(processId) {
+    throw ProcessError.processNotFound(processId);
+  }
+  async killProcess(processId) {
+    throw ProcessError.processNotFound(processId);
+  }
+}
 export {
   processToolsFactory
 };

package/dist/tool-factory.test.cjs

@@ -0,0 +1,147 @@
+"use strict";
+var import_workspace = require("@dexto/core/workspace");
+var import_vitest = require("vitest");
+var import_tool_factory = require("./tool-factory.js");
+var import_tool_factory_config = require("./tool-factory-config.js");
+const processConfig = import_tool_factory_config.ProcessToolsConfigSchema.parse({ type: "process-tools" });
+(0, import_vitest.describe)("processToolsFactory", () => {
+  (0, import_vitest.it)("executes foreground bash commands through a workspace process handle when available", async () => {
+    const exec = import_vitest.vi.fn(async () => ({
+      exitCode: 7,
+      stderr: "not clean",
+      stdout: "changed files"
+    }));
+    const open = import_vitest.vi.fn(async () => ({
+      capabilities: ["files", "processes"],
+      context: {
+        createdAt: 1,
+        id: "workspace-1",
+        lastActiveAt: 1,
+        path: "/workspace"
+      },
+      files: {},
+      processes: { exec }
+    }));
+    const bashExec = import_tool_factory.processToolsFactory.create(processConfig).find((tool) => tool.id === "bash_exec");
+    if (bashExec === void 0) {
+      throw new Error("Expected bash_exec tool to be registered.");
+    }
+    const result = await bashExec.execute(
+      {
+        command: "git status",
+        cwd: "src",
+        run_in_background: false,
+        timeout: 5e3
+      },
+      createToolContext({
+        workspaceManager: {
+          open
+        }
+      })
+    );
+    (0, import_vitest.expect)(open).toHaveBeenCalledWith({ intent: "process" });
+    (0, import_vitest.expect)(exec).toHaveBeenCalledWith({
+      command: "git status",
+      cwd: "/workspace/src",
+      timeout: 5e3
+    });
+    (0, import_vitest.expect)(result).toMatchObject({
+      exit_code: 7,
+      stderr: "not clean",
+      stdout: "changed files"
+    });
+  });
+  (0, import_vitest.it)("keeps the existing process service path when no workspace is active", async () => {
+    const processService = new FakeProcessCommandService();
+    const bashExec = import_tool_factory.processToolsFactory.create(processConfig).find((tool) => tool.id === "bash_exec");
+    if (bashExec === void 0) {
+      throw new Error("Expected bash_exec tool to be registered.");
+    }
+    const result = await bashExec.execute(
+      {
+        command: "pwd",
+        run_in_background: false,
+        timeout: 5e3
+      },
+      createToolContext({
+        processService,
+        workspaceManager: {
+          open: async () => {
+            throw import_workspace.WorkspaceError.currentWorkspaceRequired();
+          }
+        }
+      })
+    );
+    (0, import_vitest.expect)(processService.commands).toEqual([
+      {
+        command: "pwd",
+        options: {
+          abortSignal: void 0,
+          cwd: void 0,
+          description: void 0,
+          runInBackground: false,
+          timeout: 5e3
+        }
+      }
+    ]);
+    (0, import_vitest.expect)(result).toMatchObject({
+      exit_code: 0,
+      stderr: "",
+      stdout: "/local\n"
+    });
+  });
+});
+function createToolContext(services) {
+  return {
+    logger: createLogger(),
+    services
+  };
+}
+function createLogger() {
+  return {
+    createChild: () => createLogger(),
+    debug: () => {
+    },
+    error: () => {
+    },
+    info: () => {
+    },
+    warn: () => {
+    }
+  };
+}
+class FakeProcessCommandService {
+  commands = [];
+  async executeCommand(command, options) {
+    this.commands.push({ command, options });
+    return {
+      duration: 10,
+      exitCode: 0,
+      stderr: "",
+      stdout: "/local\n"
+    };
+  }
+  getConfig() {
+    return {
+      allowedCommands: [],
+      blockedCommands: [],
+      environment: {},
+      maxConcurrentProcesses: 5,
+      maxOutputBuffer: 1024,
+      maxTimeout: 6e5,
+      securityLevel: "moderate",
+      workingDirectory: "/local"
+    };
+  }
+  async getProcessOutput(_processId) {
+    return {
+      status: "completed",
+      stderr: "",
+      stdout: ""
+    };
+  }
+  async killProcess(_processId) {
+  }
+  setWorkingDirectory(_workingDirectory) {
+  }
+}

package/dist/tool-factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-factory.test.d.ts.map

package/dist/tool-factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.test.d.ts","sourceRoot":"","sources":["../src/tool-factory.test.ts"],"names":[],"mappings":""}

package/dist/tool-factory.test.js

@@ -0,0 +1,146 @@
+import { WorkspaceError } from "@dexto/core/workspace";
+import { describe, expect, it, vi } from "vitest";
+import { processToolsFactory } from "./tool-factory.js";
+import { ProcessToolsConfigSchema } from "./tool-factory-config.js";
+const processConfig = ProcessToolsConfigSchema.parse({ type: "process-tools" });
+describe("processToolsFactory", () => {
+  it("executes foreground bash commands through a workspace process handle when available", async () => {
+    const exec = vi.fn(async () => ({
+      exitCode: 7,
+      stderr: "not clean",
+      stdout: "changed files"
+    }));
+    const open = vi.fn(async () => ({
+      capabilities: ["files", "processes"],
+      context: {
+        createdAt: 1,
+        id: "workspace-1",
+        lastActiveAt: 1,
+        path: "/workspace"
+      },
+      files: {},
+      processes: { exec }
+    }));
+    const bashExec = processToolsFactory.create(processConfig).find((tool) => tool.id === "bash_exec");
+    if (bashExec === void 0) {
+      throw new Error("Expected bash_exec tool to be registered.");
+    }
+    const result = await bashExec.execute(
+      {
+        command: "git status",
+        cwd: "src",
+        run_in_background: false,
+        timeout: 5e3
+      },
+      createToolContext({
+        workspaceManager: {
+          open
+        }
+      })
+    );
+    expect(open).toHaveBeenCalledWith({ intent: "process" });
+    expect(exec).toHaveBeenCalledWith({
+      command: "git status",
+      cwd: "/workspace/src",
+      timeout: 5e3
+    });
+    expect(result).toMatchObject({
+      exit_code: 7,
+      stderr: "not clean",
+      stdout: "changed files"
+    });
+  });
+  it("keeps the existing process service path when no workspace is active", async () => {
+    const processService = new FakeProcessCommandService();
+    const bashExec = processToolsFactory.create(processConfig).find((tool) => tool.id === "bash_exec");
+    if (bashExec === void 0) {
+      throw new Error("Expected bash_exec tool to be registered.");
+    }
+    const result = await bashExec.execute(
+      {
+        command: "pwd",
+        run_in_background: false,
+        timeout: 5e3
+      },
+      createToolContext({
+        processService,
+        workspaceManager: {
+          open: async () => {
+            throw WorkspaceError.currentWorkspaceRequired();
+          }
+        }
+      })
+    );
+    expect(processService.commands).toEqual([
+      {
+        command: "pwd",
+        options: {
+          abortSignal: void 0,
+          cwd: void 0,
+          description: void 0,
+          runInBackground: false,
+          timeout: 5e3
+        }
+      }
+    ]);
+    expect(result).toMatchObject({
+      exit_code: 0,
+      stderr: "",
+      stdout: "/local\n"
+    });
+  });
+});
+function createToolContext(services) {
+  return {
+    logger: createLogger(),
+    services
+  };
+}
+function createLogger() {
+  return {
+    createChild: () => createLogger(),
+    debug: () => {
+    },
+    error: () => {
+    },
+    info: () => {
+    },
+    warn: () => {
+    }
+  };
+}
+class FakeProcessCommandService {
+  commands = [];
+  async executeCommand(command, options) {
+    this.commands.push({ command, options });
+    return {
+      duration: 10,
+      exitCode: 0,
+      stderr: "",
+      stdout: "/local\n"
+    };
+  }
+  getConfig() {
+    return {
+      allowedCommands: [],
+      blockedCommands: [],
+      environment: {},
+      maxConcurrentProcesses: 5,
+      maxOutputBuffer: 1024,
+      maxTimeout: 6e5,
+      securityLevel: "moderate",
+      workingDirectory: "/local"
+    };
+  }
+  async getProcessOutput(_processId) {
+    return {
+      status: "completed",
+      stderr: "",
+      stdout: ""
+    };
+  }
+  async killProcess(_processId) {
+  }
+  setWorkingDirectory(_workingDirectory) {
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/tools-process",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "description": "Process tools factory for Dexto agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,8 +20,8 @@
   ],
   "dependencies": {
     "zod": "^4.3.6",
-    "@dexto/agent-config": "1.7.2",
-    "@dexto/core": "1.7.2"
+    "@dexto/agent-config": "1.8.0",
+    "@dexto/core": "1.8.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",