Function enqueueToolAction

internal/bridge/commands.go:144–160

enqueueToolAction builds a PendingAction, enqueues it, and binds to the task. Returns the command ID and true on success, or ("", false) on failure. Use this for modules that manage their own result channel (e.g. upload/download).

(ctx ModuleContext, sessionID string, taskID uint32, toolName string, args map[string]any)

// Returns the command ID and true on success, or ("", false) on failure.
// Use this for modules that manage their own result channel (e.g. upload/download).
func enqueueToolAction(ctx ModuleContext, sessionID string, taskID uint32, toolName string, args map[string]any) (string, bool) {
	cmdID := sessions.GenerateCommandID()
	action := &sessions.PendingAction{
		ID:        cmdID,
		TaskID:    taskID,
		Type:      sessions.ActionToolCall,
		ToolName:  toolName,
		Arguments: args,
		CreatedAt: time.Now(),
	}
	if !sessions.Global().EnqueueAction(sessionID, action) {
		ctx.Tasks.Fail(sessionID, taskID, "enqueue failed")
		return "", false
	}
	ctx.Tasks.BindCommand(sessionID, taskID, cmdID)
	return cmdID, true
}

// execSpite builds a simple ExecResponse Spite for error messages.
func execSpite(message string) *implantpb.Spite {